Яндекс Вордстат MCP

seyka-ai/yandex-tools-mcp· Проверено 12.11.2026· 70на GitHub

Подключает агента к API Вордстата v2 в Yandex Cloud: популярные запросы с ключевым словом, динамика частотности по дням, неделям и месяцам, распределение по регионам.

2 реализации:

Отдельный сервер только для Вордстата, 5 инструментов на Node.js, ставится через npx; работает по API-ключу Yandex Cloud, тому же, что у соседнего yandex-search-mcp.

Как подключить

Что сделать до подключения

Node.js с npx

Сервисный аккаунт в консоли Yandex Cloud с ролью search-api.webSearch.user

YANDEX_SEARCH_API_KEY

консоль Yandex Cloud → сервисный аккаунт с ролью search-api.webSearch.user → API-ключ с областью yc.search-api.execute

YANDEX_FOLDER_ID

идентификатор каталога в консоли Yandex Cloud, вида b1g…

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YANDEX_SEARCH_API_KEY=<API-ключ Yandex Cloud>' --env 'YANDEX_FOLDER_ID=<ID каталога Yandex Cloud>' --transport stdio yandex-wordstat \
  -- npx -y yandex-wordstat-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-wordstat]
command = "npx"
args = ["-y", "yandex-wordstat-mcp"]

[mcp_servers.yandex-wordstat.env]
YANDEX_SEARCH_API_KEY = "<API-ключ Yandex Cloud>"
YANDEX_FOLDER_ID = "<ID каталога Yandex Cloud>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
        "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-wordstat": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
        "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
        "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
        "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-wordstat": {
        "type": "local",
        "command": ["npx", "-y", "yandex-wordstat-mcp"],
        "environment": {
          "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
          "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
        "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "<API-ключ Yandex Cloud>",
        "YANDEX_FOLDER_ID": "<ID каталога Yandex Cloud>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

top-requestsпоказывает популярные запросы за 30 дней

dynamicsпоказывает динамику частотности

regionsпоказывает распределение по регионам

get-regions-treeвыдаёт дерево регионов

get-region-childrenраскрывает дочерние регионы

Сервер на Python для Директа, Метрики и Аудиторий, где Вордстату отведено 5 инструментов из 152; ставится клонированием репозитория.

Как подключить

Что сделать до подключения

Python 3 и копия репозитория с зависимостями из requirements.txt в виртуальном окружении venv

Платёжный аккаунт в Yandex Cloud с привязанной картой и роль search-api.executor на каталоге

YD_OAUTH_TOKEN

приложение на oauth.yandex.ru с правом cloud:auth, затем oauth.yandex.ru/authorize?response_type=token&client_id=<Client ID>; без токена сервер не запускается

YC_FOLDER_ID

ID каталога в консоли Yandex Cloud, формат b1gxxxxxxxxxx

YC_API_KEY

API-ключ сервисного аккаунта с ролью search-api.executor; обязателен для OAuth-токенов, выпущенных после 01.06.2026

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YD_OAUTH_TOKEN=<OAuth-токен Яндекса>' --env 'YC_FOLDER_ID=<ID каталога Yandex Cloud>' --env 'YC_API_KEY=<API-ключ сервисного аккаунта>' --transport stdio yandex-ads-mcp \
  -- /path/to/yandex-ads-mcp/venv/bin/python /path/to/yandex-ads-mcp/server.py

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yandex-ads-mcp]
command = "/path/to/yandex-ads-mcp/venv/bin/python"
args = ["/path/to/yandex-ads-mcp/server.py"]

[mcp_servers.yandex-ads-mcp.env]
YD_OAUTH_TOKEN = "<OAuth-токен Яндекса>"
YC_FOLDER_ID = "<ID каталога Yandex Cloud>"
YC_API_KEY = "<API-ключ сервисного аккаунта>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yandex-ads-mcp": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
        "YC_API_KEY": "<API-ключ сервисного аккаунта>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yandex-ads-mcp": {
      "type": "stdio",
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
        "YC_API_KEY": "<API-ключ сервисного аккаунта>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yandex-ads-mcp": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
        "YC_API_KEY": "<API-ключ сервисного аккаунта>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yandex-ads-mcp": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
        "YC_API_KEY": "<API-ключ сервисного аккаунта>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yandex-ads-mcp": {
        "type": "local",
        "command": [
          "/path/to/yandex-ads-mcp/venv/bin/python",
          "/path/to/yandex-ads-mcp/server.py"
        ],
        "environment": {
          "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
          "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
          "YC_API_KEY": "<API-ключ сервисного аккаунта>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "yandex-ads-mcp": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
        "YC_API_KEY": "<API-ключ сервисного аккаунта>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yandex-ads-mcp": {
      "command": "/path/to/yandex-ads-mcp/venv/bin/python",
      "args": ["/path/to/yandex-ads-mcp/server.py"],
      "env": {
        "YD_OAUTH_TOKEN": "<OAuth-токен Яндекса>",
        "YC_FOLDER_ID": "<ID каталога Yandex Cloud>",
        "YC_API_KEY": "<API-ключ сервисного аккаунта>"
      }
    }
  }
}

Инструменты сервера

yd_wordstat_top_requestsпоказывает популярные запросы за 30 дней

yd_wordstat_dynamicsпоказывает динамику частотности

yd_wordstat_regionsпоказывает распределение по регионам

yd_wordstat_regions_treeвыдаёт дерево регионов с ID

yd_wordstat_user_infoзапрашивает квоту API

Показано 5 из 152.

Что попросить агента

«Какие самые популярные запросы по «<ключевое слово>» в России?»Агент вызовет top-requests, в yandex-ads-mcp — yd_wordstat_top_requests

«Покажи недельную динамику запросов «<ключевое слово>» за последний год»Агент вызовет dynamics с разбивкой weekly, в yandex-ads-mcp — yd_wordstat_dynamics

«В каких регионах больше всего ищут «<ключевое слово>»?»Агент вызовет regions, в yandex-ads-mcp — yd_wordstat_regions

«Какой ID региона у <город>?»Агент вызовет get-regions-tree и get-region-children, в yandex-ads-mcp — yd_wordstat_regions_tree

«Собери 200 запросов с «<ключевое слово>» только с телефонов в <регион>»Агент найдёт ID региона по дереву и вызовет top-requests или yd_wordstat_top_requests с устройством phone

Для каких задач

Собрать популярные запросы с ключевым словом за последние 30 дней, до 2000 фраз за раз

Посмотреть, как менялся спрос на запрос по дням, неделям или месяцам

Найти регионы и города, где запрос ищут чаще всего

Узнать ID региона, чтобы считать частотность по одному городу

Разделить частотность по устройствам: компьютеры, телефоны, планшеты

Ограничения

Вордстат v2 работает через Yandex Cloud и тарифицируется там как Search API; нужен платёжный аккаунт с привязанной картой, есть бесплатная квота

yandex-wordstat-mcp отправляет не больше 10 запросов в секунду и сам выдерживает паузу

yandex-ads-mcp не стартует без YD_OAUTH_TOKEN, даже если нужен только Вордстат; ставится клонированием репозитория, пути к python и server.py прописываются вручную

yd_wordstat_user_info с августа 2026 получает от Яндекса ответ 404, остальные инструменты Вордстата работают

Если не работает

После обновления yandex-wordstat-mcp перестал работать YANDEX_WORDSTAT_TOKEN

С версии 2.0.0 старый вход по OAuth удалён. Создайте API-ключ Yandex Cloud и пропишите YANDEX_SEARCH_API_KEY и YANDEX_FOLDER_ID.

Сервер, запущенный из клона репозитория, падает с Cannot find package '@modelcontextprotocol/sdk', Claude Code пишет CONNECTION_CLOSED

Выполните bun install в папке репозитория до запуска Claude Code. Запуск через npx этого шага не требует.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
yandex-wordstat-mcp	Seyka AI	70	локально	токен	5	28 октября 2026
Yandex Ads MCP Server	Yurich-ru	50	локально	токен	152	4 октября 2026

Частые вопросы

Подойдёт старый токен API Вордстата?

Нет. Оба сервера работают с Вордстатом v2 в Yandex Cloud Search API. Для yandex-wordstat-mcp нужны API-ключ и ID каталога, для yandex-ads-mcp — OAuth-токен с правом cloud:auth, ID каталога и API-ключ сервисного аккаунта.

Можно взять тот же ключ, что для Яндекс Поиска?

Да. yandex-wordstat-mcp читает YANDEX_SEARCH_API_KEY и YANDEX_FOLDER_ID, как и отдельный сервер yandex-search-mcp из того же репозитория. Чтобы держать ключ Вордстата отдельно, задайте YANDEX_WORDSTAT_API_KEY и YANDEX_WORDSTAT_FOLDER_ID.

Какой вариант выбрать?

Если нужен только Вордстат, yandex-wordstat-mcp ставится одной строкой через npx. yandex-ads-mcp удобнее, когда в той же сессии вы работаете с кампаниями Директа, Метрикой и Аудиториями.

Сколько квоты тратит запрос?

В yandex-ads-mcp популярные запросы стоят 1 единицу квоты, распределение по регионам — 2, дерево регионов не тратит квоту. Расход и квоты Вордстата v2 видны в консоли Yandex Cloud.

Почему недельная динамика считает фразу с операторами иначе?

В yandex-wordstat-mcp все операторы поиска работают только на дневной разбивке, на недельной и месячной — только «+». В yandex-ads-mcp для месячной разбивки обе даты — 1-е число месяца, для недельной — с понедельника по воскресенье.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и обращаются к Yandex Cloud по вашему ключу или OAuth-токену Яндекса; зарубежные аккаунты не нужны.

Яндекс Вордстат MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы