Инструмент для сбора семантического ядра

Сбор, чистка и кластеризация запросов проекта: спрос Wordstat, кластеры по выдаче, точная частотность, анализ конкурентов и офлайн-план перед платным вызовом.

Попробуйте

Семантическое ядро SpiderHead: лента этапов с бесплатными и платными этапами и офлайн-план платного этапа.

Тринадцать этапов, одно растущее ядро

Каждый этап меняет статус и записывает причину, поэтому фраза никогда не удаляется, а любое решение можно объяснить. Бесплатные этапы стоят между платными: вы проверяете пул, прежде чем покупать следующий ответ.

  • БесплатноБесплатно, работает локально
  • ПлатноПлатный вызов провайдера
  • ВебПубличные веб-страницы, без квоты провайдера
  1. Бесплатно

    Импорт

    Загрузите то, что уже есть: CSV или один лист XLSX. Сопоставьте query, frequency, group, subgroup, URL и comment, затем добавьте, обновите или замените. Предпросмотр показывает новые, существующие и дублирующиеся строки до записи.

    phrases
  2. Платно

    Сбор · Yandex Wordstat

    Расширяет ваши исходные фразы по региону и повторно расширяет сильные до заданной глубины. Очередь дедуплицируется, а --resume продолжает прерванный запуск, не запрашивая ту же фразу повторно.

    phrases, expansions, provenance
  3. Бесплатно

    Чистка

    Применяет фильтры проекта (интент, стоп-слова, информационные шаблоны), отмечает выбросы по частотности и группирует фразы по леммам. Фразу с наблюдаемыми показами или позициями правила частотности не отсекают никогда.

    status, route, lemma group
  4. Бесплатно

    Граф

    Строит граф слов пула. Кандидаты в омонимы уходят на проверку, а кластеры-кандидаты попадают в anomalies.md — до любых новых трат.

    anomalies.md
  5. Бесплатно

    Сверка с сайтом

    Фраза входит в ядро, только если сайт это предлагает. Фразы без единого термина из catalog.txt уходят на проверку как не из каталога.

    review list
  6. Платно

    Кластеризация · Yandex Search API

    Получает один топ-10 на фразу и кэширует его, поэтому повторный запуск оплачивает только новые фразы. Фразы с общими страницами образуют кластер; --method louvain перегруппировывает кэшированные результаты и разрывает длинные цепочки.

    SERP cache, clusters, landing candidates
  7. Бесплатно

    Релевантность

    Если в топ-10 фразы нет ни одного сайта вашего типа из vendors.txt, тема, скорее всего, не по профилю. Фраза уходит на проверку; ничего не удаляется.

    review list
  8. Бесплатно

    Конкуренты

    Читает кэшированную выдачу: какие домены занимают ваши кластеры и какие слова они используют в заголовках. Кандидаты попадают в synonyms.txt.

    competitors.md, synonyms.txt
  9. Веб

    Разбор страниц

    Открывает самые частые страницы конкурентов из собранной выдачи и читает их title, description, H1 и первые заголовки H2. Тематические фразы из двух и трёх слов попадают в synonyms.txt.

    competitor_mining.md, synonyms.txt
  10. Платно

    Синонимы · Yandex Wordstat

    Проверяет кандидатов из synonyms.txt. В ядро входят только фразы со спросом; затем collect --resume растит пул от них.

    checked phrases
  11. Платно

    Точная частотность · Arsenkin

    Покупает точную частотность !W один раз на группу лемм, в самом конце, когда пул перестал меняться. Сверх бюджетного порога проекта нужен --yes.

    exact frequency, task receipts
  12. Бесплатно

    Отчёт и Excel

    report.md и clusters.csv для чтения, книга XLSX (Summary, Core, Info, Clusters, Rejected) для клиента, pool.csv и pool.json для других инструментов.

    report.md, XLSX, CSV, JSON
  13. Бесплатно

    Целевые страницы и выводы

    После запуска выберите целевую страницу каждого кластера из измеренных кандидатов, затем читайте еженедельные сигналы по кластерам из локальных данных Search Console, Вебмастера и Метрики и превращайте выбранные в задачи чек-листа.

    landing, weekly signals, tasks

Цикл, который растит ядро

Ядро собирают не за один раз. Конкуренты и разбор страниц дают новых кандидатов, синонимы их проверяют, сбор возобновляется, и кластеризация идёт снова. Точную частотность покупают последней.

  1. collect
  2. clean · graph · site match
  3. cluster
  4. competitors · mine
  5. synonyms
  6. collect --resume
  7. exact, once
  8. report

Откуда берутся данные

Конвейер сбора работает на данных Яндекса. Спрос Google, отслеживание позиций и поисковая аналитика — отдельные команды тулкита, которые работают рядом с ядром.

Внутри конвейера

Платно

Yandex Wordstat

collect · synonyms

Базовая частотность, уточнения и похожие запросы через API Yandex Cloud. Нужны API-ключ и ID каталога; почасовая квота.

Платно

Yandex Search API

cluster

Один топ-10 на фразу и регион, кэшируется со временем получения и регионом. Только асинхронный эндпоинт.

Платно

Arsenkin

exact

Точная частотность !W, которую не отдаёт API Wordstat. Оплата при создании задачи; task_id сохраняется, поэтому результат после тайм-аута запрашивается снова, а не покупается заново.

Рядом с ядром

Платно

DataForSEO

google-keywords

Объём поиска Google, конкуренция и расширение исходных фраз. По умолчанию песочница.

Платно

Wordstat one-offs

keywords-expand · keywords-seasonality · regions-tree

Расширить одну фразу, прочитать её спрос по месяцам, просмотреть дерево регионов (дерево бесплатно).

Бесплатно

Topvisor

topvisor-read

Читает проекты, ключевые слова и записанную историю позиций из вашего действующего аккаунта. Платные проверки из тулкита запустить нельзя.

Бесплатно

Search Console · Webmaster · Metrika

semantics insights

Еженедельные сигналы по кластерам из данных, которые тулкит уже синхронизировал локально. Сам шаг выводов не обращается к провайдерам.

Платите один раз, сначала смотрите план

У каждого платного этапа есть офлайн-план: регион, поисковая система, источник запросов и верхняя оценка числа запросов или задач. План не создаёт клиент провайдера.

План перед каждым платным вызовом

--dry-run --json печатает план. Сам запуск требует --confirm-paid, даже если оценка равна нулю.

Квитанции вместо повторов

Попытки Wordstat, получения выдачи и задачи Arsenkin резервируются до вызова. Неоднозначный запрос автоматически не отправляется повторно.

Кэши, которые остаются

Кэшированная выдача и оплаченные квитанции переживают замену пула, поэтому повторная кластеризация оплачивает только новые фразы.

Один журнал расходов

Каждое списание попадает в spend-report с семантическим проектом и этапом, к которым оно относится.

Если цену провайдера нельзя установить офлайн, план так и говорит, а не выдумывает число.

Импорт и экспорт

Вход

  • CSV или XLSX, один выбранный лист; заголовки сопоставляются автоматически, если это однозначно
  • Поля: query, frequency, group, subgroup, URL, comment, а также base, quoted, exact, impressions и позиции Яндекса и Google
  • Путь «Категория / Кластер» делится на group и subgroup
  • add сохраняет существующие фразы, update применяет указанные поля, replace заменяет пул и отклоняется, если файл пуст
  • Ограниченный ввод: 32 MiB на файл, 100 000 строк, 128 столбцов

Выход

  • Книга XLSX: Summary, Core, Info, Clusters с конкурентами, Rejected
  • Сводка report.md и матрица clusters.csv
  • pool.csv и pool.json для других инструментов
  • Охват: всё ядро, один кластер (--cluster) или кластеры без целевой страницы (--scope no-landing)
  • Пробный запуск сначала перечисляет точные файлы и число строк

Реальный вывод CLI

Снято на синтетическом демонстрационном проекте, который поставляется с тулкитом. Его фразы русские, как и спрос в Яндексе, а частотности выдуманы. Платных вызовов не было.

Бесплатные этапы один за другим
$ seohead semantics clean --project ./core
$ seohead semantics graph --project ./core
$ seohead semantics sitematch --project ./core
clean: kept=34 review=4 dropped=3 | lemma groups=41 (median base=720, outlier>36000)
graph: homonyms=0, to review=0, candidate clusters=7 -> anomalies.md
sitematch: catalog terms=11 | off-catalog->review=8 | kept and matching the site=26
Офлайн-план платного этапа
$ seohead semantics cluster --project ./core --dry-run
"mode": "estimate", "stage": "cluster", "paid": true,
"provider": "yandex_search",
"request_estimate": {"unit": "requests", "count": 26, "kind": "upper_bound"},
"money_estimate": null,
"money_unavailable_reason": "provider pricing is not available from this offline preflight",
"paid_calls_made": 0
Состояние ядра
$ seohead semantics status --project ./core
dropped=3 | kept=26 | review=12 | _total=41 | _exact=0 | _expanded=0 | _clusters=0
provider units: {'yandex_requests': 0, 'arsenkin': 0}
next: seohead semantics exact --project ./core
План экспорта, ничего не записано
$ seohead semantics export --project ./core --scope no-landing --dry-run
"mode": "preview", "scope": "no-landing", "rows": 41,
"planned_files": ["core/semantics/pool.csv", "core/semantics/pool.json"]
bash
seohead semantics status --project ./my-core

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • От трёх до десяти исходных фраз и фильтры проекта в project.yaml
  • catalog.txt с разделами сайта, vendors.txt с сайтами вашего типа
  • API-ключ Yandex Cloud и ID каталога для Wordstat и Search API
  • Токен Arsenkin для точной частотности, только в самом конце
  • По желанию: готовый список ключевых слов в CSV или XLSX

Ограничения

  • Сбор и кластеризация работают на данных Яндекса; спрос Google — отдельная команда google-keywords
  • Если цена провайдера неизвестна, офлайн стоимость не оценивается; план так и говорит
  • Для кандидатов в целевые страницы нужны кластеризация по выдаче и собственный домен проекта
  • Выводы читают только данные, уже синхронизированные в локальную базу источников

Передайте ядро агенту

Десять MCP-инструментов открывают те же этапы и чтения. Платный вызов возвращает план и требует confirm_paid=true, чтобы отправить работу.

  • seo_semantics_statusСчётчики, единицы провайдера и следующий этап
  • seo_semantics_runБесплатные этапы
  • seo_semantics_mineСтраницы конкурентов, без квоты провайдера
  • seo_semantics_paidПлатные этапы: сначала план, затем confirm_paid=true
  • seo_semantics_clustersСписок кластеров постранично
  • seo_semantics_cluster_showОдин кластер с доказательствами выбора целевой страницы
  • seo_semantics_cluster_queriesФразы кластера с сохранённым топ-10
  • seo_semantics_set_landingНазначить или снять целевую страницу
  • seo_semantics_insightsЕженедельные сигналы по кластерам и источникам
  • seo_semantics_insights_tasksВыбранные сигналы в чек-лист

Вопросы

Собирает ли он ключевые слова Google?
Не в конвейере сбора: он работает на Yandex Wordstat, Yandex Search API и Arsenkin. Объём поиска Google и расширение исходных фраз дают отдельная команда google-keywords через DataForSEO, а позиции Google можно импортировать в ядро как столбец.
Какие этапы стоят денег?
collect и synonyms (Yandex Wordstat), cluster для фраз без кэшированного топ-10 (Yandex Search API) и exact (Arsenkin). mine читает публичные страницы конкурентов и не тратит квоту провайдера. Всё остальное бесплатно и работает локально.
Может ли запуск списать деньги дважды?
Тулкит устроен так, чтобы этого не было. Платные запросы резервируются до вызова, прерванный запрос автоматически не отправляется повторно, оплаченный результат Arsenkin запрашивается снова по его task_id, а кэшированные результаты остаются при замене пула.
Удаляются ли фразы?
Нет. Этап меняет статус фразы (kept, review, dropped и так далее) и записывает причину и этап. Всегда можно увидеть, почему фраза покинула ядро, и вернуть её.
Можно ли начать с готового списка ключевых слов?
Да. Импортируйте CSV или лист XLSX, сопоставив свои столбцы с query, frequency, group, subgroup, URL и comment. Импортированные позиции и показы защищают фразу от отсечения по частотности.
Как выбирается целевая страница кластера?
После кластеризации по выдаче и только если известен собственный домен проекта, каждый URL-кандидат оценивается по доле фраз кластера, в топ-10 которых он входил. Целевую страницу выбираете вы; выбор записывается с записью аудита.

Проверьте на своём сайте