Yandex Wordstat MCP

Yandex Wordstat MCP — MCP-сервер сообщества (автор — stufently). Сервер для API Яндекс Вордстата: подбор ключевых слов для рынков России и СНГ. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
stufently
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
javascript

Уровень риска: medium

Только чтение статистики Вордстата. Запросы к Search API тарифицируются в Yandex Cloud; выдайте сервисному аккаунту минимальную роль.

Что умеет

yandex-wordstat-mcp — MCP-сервер для Яндекс Вордстата через Yandex Cloud Search API v2. Он помогает подбирать ключевые слова, смотреть динамику спроса и распределение запросов по регионам для России и стран СНГ. Старый API api.wordstat.yandex.net Яндекс отключил в 2026 году, поэтому с версии 2.0 сервер работает через Search API в Yandex Cloud и авторизуется ключом API сервисного аккаунта.

Инструмент Что делает
top-requests Популярные запросы с ключевым словом за последние 30 дней и похожие запросы, по убыванию частоты
dynamics Динамика частоты запроса по дням, неделям или месяцам
regions Распределение интереса по регионам с долей и индексом соответствия
get-regions-tree Дерево регионов Вордстата
get-region-children Дочерние регионы из сохранённого дерева, без обращения к API

Запросы можно фильтровать по регионам и устройствам (компьютер, телефон, планшет). У dynamics есть недокументированные ограничения API на окна дат: сервер сам подгоняет даты к допустимым, перечисляет все сдвиги в поле adjustments и честно сообщает, если запрошен ещё не закончившийся период.

Кому подойдёт

  • SEO-специалистам: сбор семантики и проверка частот прямо в диалоге с ассистентом.
  • Маркетологам: сезонность спроса и сравнение регионов.
  • Тем, кто запускает рекламу в Директе: подбор фраз и оценка спроса перед запуском.

Похожие серверы — в категории маркетинг и соцсети.

Установка

Пакет будет опубликован как @stufently/yandex-wordstat-mcp, но пока под этим именем ничего не выложено. Пакет без префикса yandex-wordstat-mcp принадлежит другому автору. Поэтому запускайте сервер из исходников:

git clone https://github.com/stufently/yandex-mcp.git
cd yandex-mcp && bun install
node packages/yandex-wordstat-mcp/src/index.mjs

Как получить ключ: в консоли Yandex Cloud выберите каталог (к облаку должен быть привязан платёжный аккаунт), создайте сервисный аккаунт с ролью search-api.webSearch.user и выпустите для него ключ API с областью yc.search-api.execute. Секрет показывается один раз — сохраните его в WORDSTAT_API_KEY, идентификатор каталога — в WORDSTAT_FOLDER_ID. Вместо переменных окружения можно использовать файл ~/.config/yandex-cloud/wordstat.env.

Подключение к клиентам

Конфиг приведён дословно из README. Укажите путь к склонированному репозиторию. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "node",
      "args": ["/path/to/yandex-mcp/packages/yandex-wordstat-mcp/src/index.mjs"],
      "env": {
        "WORDSTAT_API_KEY": "AQVN...",
        "WORDSTAT_FOLDER_ID": "b1g..."
      }
    }
  }
}

Проверка

Спросите ассистента: «Какие самые популярные запросы со словом "велосипед" в Вордстате?» Он вызовет top-requests и покажет фразы с частотами.

Примеры задач

Покажи помесячную динамику запроса "купить ёлку" за последний год.
В каких регионах чаще всего ищут "ремонт квартир"?

Риски

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

Что встроено: ограничение 10 запросов в секунду на стороне клиента, автоматические повторы с нарастающей паузой при ответах 429 и 5xx. Дерево регионов загружается один раз за сессию.

Как снизить риски: выдайте сервисному аккаунту только роль search-api.webSearch.user, храните ключ в переменной окружения или в файле с ограниченными правами. Не путайте пакет с одноимённым пакетом другого автора. Лицензия — MIT.

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

Работает ли сервер со старым API Вордстата?

Нет. Старый API отключён, с версии 2.0 используется Search API v2 в Yandex Cloud.

Почему изменились даты в ответе dynamics?

API принимает только определённые окна дат. Сервер подгоняет даты и перечисляет все сдвиги в поле adjustments.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • top-requests
  • dynamics
  • regions
  • get-regions-tree
  • get-region-children

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

Zotero MCP

Поиск, чтение, аннотации и пополнение библиотеки Zotero.

Риск: medium Лицензия: MIT ★ 5 790

arxiv-mcp-server

Поиск статей arXiv, загрузка полных текстов и графы цитирования.

Риск: high Лицензия: Apache-2.0 ★ 3 271

PaperBanana

Генерация научных диаграмм и графиков по тексту.

Риск: medium Лицензия: MIT ★ 2 467

ToolUniverse

Более 2700 научных инструментов для ИИ-исследователей.

Риск: medium Лицензия: Apache-2.0 ★ 1 786

Источники