# SEO Tools: Yandex Wordstat

Пакет подключает официальный API Вордстата из Yandex Cloud к ИИ-ассистенту через stdio. Он отдаёт частотность ключей и динамику спроса в строгом формате JSON.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Автор: antohins
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/antohins/seo-tools-mcp
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/seo-tools-yandex-wordstat

## Что делает

Сервер работает только на чтение. Он передаёт ответы в виде строгого JSON. В список входят инструменты `wordstat_frequency` для проверки частотности, `wordstat_dynamics` для динамики по времени, а также `wordstat_regions` и `wordstat_regions_tree` для географии спроса. Для проверки ключей служат вызовы `<server>_auth_status` и `<server>_set_credentials`.

Для прямых запросов к серверу нужен ключ Yandex Cloud Search API. Без переменных окружения `WORDSTAT_API_KEY` и `WORDSTAT_FOLDER_ID` подключение к Вордстату не сработает. Обмен идёт через stdio.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `WORDSTAT_API_KEY`, `WORDSTAT_FOLDER_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> --transport stdio seo-tools-yandex-wordstat -- npx -y seo-tools-mcp-wordstat
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add seo-tools-yandex-wordstat --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -- npx -y seo-tools-mcp-wordstat
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "seo-tools-yandex-wordstat": {
            "command": "npx",
            "args": [
                "-y",
                "seo-tools-mcp-wordstat"
            ],
            "env": {
                "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
                "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "seo-tools-yandex-wordstat": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "seo-tools-mcp-wordstat"
            ],
            "env": {
                "WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
                "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> seo-tools-yandex-wordstat npx -y seo-tools-mcp-wordstat
```
Вместо <…> подставьте свои значения

## Когда брать
- собрать базовую частотность поисковых фраз в Яндексе
- проверить динамику популярности ключевых слов по времени
- оценить распределение спроса по регионам
- получить иерархическое дерево регионов Wordstat

## Примеры запросов агенту
- Собери частотность запроса "купить велосипед" через wordstat_frequency
- Покажи динамику спроса на "сноуборд" по месяцам с помощью wordstat_dynamics
- Разбери популярность фразы "доставка пиццы" по регионам через wordstat_regions

## Похожие
- [seo](https://affpapa.org/nevibecode/skills/iannuttall-seo.md) — скилл · 12400 установок
- [seo-sitemap](https://affpapa.org/nevibecode/skills/seo-sitemap.md) — скилл · 7200 установок
- [seo-cluster](https://affpapa.org/nevibecode/skills/seo-cluster.md) — скилл · 6700 установок
- [seo-coach](https://affpapa.org/nevibecode/skills/seo-coach.md) — скилл · 6600 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md