---
name: che-wordstat-keyword-research
license: MIT
description: "Подбирает и проверяет семантику Wordstat: частотность, связанные запросы, регион и кластеризацию. Применяется для ключевых слов статьи/страницы и семантического ядра; исторические тренды анализирует che-wordstat-trend-radar."
metadata:
  version: 3.0.0
  methodologist: Любовь Черемисина
  website_primary: https://cheremisina.ru
  website_secondary: https://cheremisina.online
  repository: https://github.com/LuCheremisina/marketing-skills
  display_name: CHE_wordstat-keyword-research
  author: Любовь Черемисина
---

# 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`, затем переоценить только исправленные критерии; если исправление невозможно, явно раскрыть ограничение.

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

- [references/mcp_reference.md](references/mcp_reference.md) — читать при соответствующем этапе workflow.

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

## Среда и входы

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

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

## Авторство

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

- [Основной сайт](https://cheremisina.ru)
- [Экспертные материалы](https://cheremisina.online)
- [Навыки для маркетологов](https://github.com/LuCheremisina/marketing-skills)

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

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

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

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

- [evals/judge_prompt.md](evals/judge_prompt.md) — читать при проверке результата.

Описание операторов сверено с [официальной справкой Wordstat](https://yandex.ru/support2/wordstat/ru/content/operators), 2026-10-07. Поддержку операторов конкретным API/MCP проверить отдельно от веб-интерфейса.