# Yandex Wordstat MCP

Подключает Яндекс Wordstat к ИИ-агенту: частотность запросов, динамика спроса и география поиска для рынков России и СНГ.

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

## Что делает

Сервер работает через Yandex Cloud Search API v2 и авторизуется ключом сервисного аккаунта. Старый `api.wordstat.yandex.net` Яндекс отключил в 2026 году, поэтому OAuth-токен больше не подойдёт. Имена инструментов и параметры при этом не изменились.

Внутри пять инструментов. `top-requests` ищет популярные запросы с ключевым словом за последние 30 дней и связанные с ними фразы, `dynamics` показывает динамику по дням, неделям или месяцам, `regions` — распределение интереса по регионам с индексом аффинности. Дерево регионов подтягивается один раз за сессию и кешируется, а `get-region-children` отвечает из кеша без обращения к API. Клиентский лимит — 10 запросов в секунду со скользящим окном, остальное уходит в очередь; ответы 429 и 5xx повторяются с экспоненциальной задержкой.

Для работы нужны две переменные окружения: `WORDSTAT_API_KEY` и `WORDSTAT_FOLDER_ID`. Ключ создаётся в консоли Yandex Cloud у сервисного аккаунта с ролью `search-api.webSearch.user` и областью `yc.search-api.execute`, к облаку должен быть привязан платёжный аккаунт. Без ключа сервер не стартует. У `dynamics` есть неочевидные правила по датам: для `daily` начало периода обязано попадать в последние 60 дней, для `weekly` — быть понедельником, для `monthly` — первым числом месяца. Неверные даты не отклоняются, а подтягиваются к ближайшему допустимому окну, и все сдвиги перечисляются в `adjustments`.

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

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "yandex-wordstat-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@stufently/yandex-wordstat-mcp"
            ],
            "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> yandex-wordstat-mcp npx -y @stufently/yandex-wordstat-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- собрать семантику для сайта на русском языке
- посмотреть, как менялся спрос на товар за год
- понять, в каких регионах ключевое слово ищут чаще
- найти связанные запросы вокруг одной фразы
- сравнить частотность по устройствам: десктоп, телефон, планшет

## Примеры запросов агенту
- Покажи топ-100 запросов со словом «доставка цветов» за последние 30 дней
- Построй динамику спроса на «электросамокат» по месяцам за последний год
- Разбей интерес к «ремонт квартир» по регионам и покажи индекс аффинности

## Похожие
- [New-Term Radar](https://affpapa.org/nevibecode/mcp/new-term-radar.md) — MCP-сервер · ★ 1766
- [NotFair](https://affpapa.org/nevibecode/mcp/notfair.md) — MCP-сервер · ★ 4055
- [seo-monster](https://affpapa.org/nevibecode/mcp/seo-monster.md) — MCP-сервер · ★ 553
- [Google Maps MCP Server](https://affpapa.org/nevibecode/mcp/google-maps-mcp-server.md) — MCP-сервер · ★ 479
- [Search Console MCP](https://affpapa.org/nevibecode/mcp/search-console-mcp.md) — MCP-сервер · ★ 308
- [squirrelscan](https://affpapa.org/nevibecode/mcp/squirrelscan.md) — MCP-сервер · ★ 296

Из того же набора: [stufently/yandex-mcp](https://affpapa.org/nevibecode/by/stufently/yandex-mcp.md) — 2 карточки

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