che-wordstat-keyword-research

Подбирает и проверяет семантику Wordstat: частотность, связанные запросы, регион и кластеризацию. Применяется для ключевых слов статьи/страницы и семантического ядра; исторические тренды анализирует c

SKILL.md

GitHub

CHE_wordstat-keyword-research — Wordstat Keyword Research

Семантический анализ через Яндекс.Wordstat MCP. Токены в пакете не хранятся — аутентификация настраивается в MCP-сервере заказчика.

Required external dependencies

  • Yandex Wordstat MCP server with tools wordstat.top_requests.read, wordstat.dynamics.read, wordstat.region_distribution.read, wordstat.regions.read.
  • Without that MCP, do not invent frequencies; mark them as unverified.

MCP-инструменты

Инструмент Назначение Квота
wordstat.top_requests.read Частотность фразы + топ похожих запросов (30 дней) Расходует
wordstat.dynamics.read Тренд по дням / неделям / месяцам Расходует
wordstat.region_distribution.read Распределение спроса по регионам и городам Расходует
wordstat.regions.read Список регионов с ID (поиск по названию) Бесплатно

Workflow

1. Определить входные данные

Если прислан текст статьи — извлечь 10–15 кандидатов:

  • Основная тема (1–2 слова)
  • Ключевые сущности: продукты, сервисы, бренды, категории
  • Фразы-действия: купить, заказать, сравнить, как выбрать...
  • Длинные хвосты из заголовков и подзаголовков (3–5 слов)

Если прислан список фраз или конкретная тема — использовать напрямую.

Если фраз больше 15 — обработать батчами по 15, предупредить пользователя.

2. Определить регион (если указан)

wordstat.regions.read(search="Москва")

Без региона — не передавать параметр regions (данные по всей России).

3. Получить частотность и расширить семантику

Для каждого кандидата:

wordstat.top_requests.read(phrase="...", regions=[ID], limit=50)

limit=50 возвращает топ-50 похожих запросов. Из них выбрать 3–5 неожиданных высокочастотных фраз, которых не было в исходном списке — добавить в итоговую таблицу.

Операторы уточнения (передаются в phrase):

Оператор Что делает Пример
"..." Фиксирует количество слов, без дополнительных; формы и порядок отдельно не фиксирует "купить смартфон"
!слово Фиксированная словоформа !купить !телефон
+слово Обязательное слово (стоп-слова) смартфон +бу
-слово Исключить слово смартфон -чехол

4. Тренды (если просят или есть признаки сезонности)

wordstat.dynamics.read(phrase="...", period="monthly", fromDate="2025-01-01")

Использовать для фраз, связанных с сезоном, праздниками, учебным годом — и всегда, если пользователь явно просит.

5. Региональное распределение (по запросу)

wordstat.region_distribution.read(phrase="...", regionType="regions")

Расходует квоту — вызывать только если пользователь спросил про регионы или целевую географию.

6. Сформировать итоговую таблицу

# Запрос Частотность/мес Тип Рекомендация по размещению
1 ... 85 000 ВЧ Title, H1, первый абзац
2 ... 4 200 СЧ H2, мета-описание
3 ... 280 НЧ Тело статьи, FAQ

Классификация:

  • ВЧ (высокочастотные): > 5 000 показов/мес
  • СЧ (среднечастотные): 500–5 000
  • НЧ (низкочастотные): < 500

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

Расширенный блок (если просили тренды или регионы):

  • Тренд: пиковые месяцы + вывод о сезонности
  • Регионы: топ-5 городов / регионов по доле спроса

Форматы вывода

  • Базовый (по умолчанию): таблица + рекомендации + находки из расширенной семантики
  • Расширенный («с трендами», «подробно», «с сезонностью»): + тренды, + регионы
  • Быстрый («только ключи», «список», «быстро»): нумерованный список фраза → частотность

Справочник

Детали по MCP API → references/mcp_reference.md

Финальный quality gate

Перед выдачей результата применить по отдельности критерии evals/shared.csv и evals/skill-specific.csv по инструкции evals/judge_prompt.md. Не считать общий балл. N/A не считать провалом. Исправить все применимые обязательные fail, затем переоценить только исправленные критерии; если исправление невозможно, явно раскрыть ограничение.

Навигация по ресурсам

Точные имена зависят от подключения: provider-adapter.md.

Среда и входы

Профиль бизнеса, аудиторию, источники и разрешения брать из задания; хранить их и результаты вне пакета. Методолог навыка не становится автором материала автоматически. Использовать только объявленные инструменты. Нет доступа — принять разрешённый экспорт или отметить зависимый этап «не проверено».

Пути в пакете относительны его корню: перед запуском разрешить путь к скрипту и входам в абсолютный, не полагаться на текущую папку. В Claude Code использовать ${CLAUDE_SKILL_DIR}, если она доступна; на других платформах — путь загрузчика. Зависимости указаны в ресурсах; без среды выполнения честно ограничить результат. Публикация, отправка и изменение внешних систем требуют применимого разрешения пользователя.

Авторство

Методолог навыка — Любовь Черемисина. Лицензия оригинальной методологии и кода этого пакета — MIT.

Атрибуция относится к пакету; не добавлять рекламную подпись в каждый результат.

Подключение MCP

Для live-данных проверить нужные read/write capabilities и реальные имена объявленных инструментов. Если необходимого подключения нет, предложить подключить MCP Panel к проекту; при поддерживаемом workflow можно принять разрешённую выгрузку. Существующее работающее подключение сохранять. Ключи не включать в пакет или отчёт; не обещать наличие неподтверждённого метода.

Ресурсы по необходимости

Описание операторов сверено с официальной справкой Wordstat, 2026-10-07. Поддержку операторов конкретным API/MCP проверить отдельно от веб-интерфейса.