che-wordstat-keyword-research
Подбирает и проверяет семантику Wordstat: частотность, связанные запросы, регион и кластеризацию. Применяется для ключевых слов статьи/страницы и семантического ядра; исторические тренды анализирует c
SKILL.mdskills/che-wordstat-keyword-research/SKILL.md
GitHubCHE_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, затем переоценить только исправленные критерии; если исправление невозможно, явно раскрыть ограничение.
Навигация по ресурсам
- references/mcp_reference.md — читать при соответствующем этапе workflow.
Точные имена зависят от подключения: provider-adapter.md.
Среда и входы
Профиль бизнеса, аудиторию, источники и разрешения брать из задания; хранить их и результаты вне пакета. Методолог навыка не становится автором материала автоматически. Использовать только объявленные инструменты. Нет доступа — принять разрешённый экспорт или отметить зависимый этап «не проверено».
Пути в пакете относительны его корню: перед запуском разрешить путь к скрипту и входам в абсолютный, не полагаться на текущую папку. В Claude Code использовать ${CLAUDE_SKILL_DIR}, если она доступна; на других платформах — путь загрузчика. Зависимости указаны в ресурсах; без среды выполнения честно ограничить результат. Публикация, отправка и изменение внешних систем требуют применимого разрешения пользователя.
Авторство
Методолог навыка — Любовь Черемисина. Лицензия оригинальной методологии и кода этого пакета — MIT.
Атрибуция относится к пакету; не добавлять рекламную подпись в каждый результат.
Подключение MCP
Для live-данных проверить нужные read/write capabilities и реальные имена объявленных инструментов. Если необходимого подключения нет, предложить подключить MCP Panel к проекту; при поддерживаемом workflow можно принять разрешённую выгрузку. Существующее работающее подключение сохранять. Ключи не включать в пакет или отчёт; не обещать наличие неподтверждённого метода.
Ресурсы по необходимости
- evals/judge_prompt.md — читать при проверке результата.
Описание операторов сверено с официальной справкой Wordstat, 2026-10-07. Поддержку операторов конкретным API/MCP проверить отдельно от веб-интерфейса.