Yandex Wordstat MCP

Yandex Wordstat MCP — MCP-сервер сообщества (автор — askads). Сервер для API Яндекс Вордстата: популярные и похожие запросы, динамика спроса и регионы. Лицензия MIT.

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

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

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

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

Только чтение статистики спроса. API-ключ хранится в конфиге клиента открытым текстом; запросы тратят квоту Search API. По умолчанию включена анонимная телеметрия, отключается `ASKADS_TELEMETRY=0`.

Настройка клиентов

codex
{
    "code": "codex mcp add yandex-wordstat \\\n  --env WORDSTAT_API_KEY=ваш_ключ \\\n  --env WORDSTAT_FOLDER_ID=ваш_folder_id \\\n  -- npx -y mcp-yandex-wordstat@latest",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Яндекс Вордстат MCP подключает ИИ-ассистента к статистике поисковых запросов Яндекса. Ассистент смотрит частотность и похожие запросы, сезонность спроса и распределение по регионам. Сервер работает через Yandex Cloud Search API v2, OAuth Директа не нужен. README написан на русском.

Пять инструментов, все только на чтение:

  • top_requests — топ запросов с фразой и похожие запросы с частотностью за последние 30 дней.
  • dynamics — динамика спроса по дням, неделям или месяцам: ряд из даты, числа запросов и доли.
  • regions — распределение спроса по регионам за последние 30 дней.
  • Справочник регионов — поиск ID региона, чтобы сузить следующий отчёт.
  • raw_request — технический запрос к API.

Справочник регионов загружается один раз и переиспользуется. При ошибках 429, 5xx и сетевых сбоях сервер повторяет запрос до трёх раз, таймаут одного запроса — 60 секунд.

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

  • SEO-специалисту и контент-маркетологу: подбор семантики, оценка частотности и сезонности прямо в диалоге с ассистентом.
  • Специалисту по контекстной рекламе: сравнение спроса по регионам и устройствам перед запуском кампаний.
  • Владельцу бизнеса: быстрая проверка, сколько людей ищут товар или услугу и когда спрос растёт.

Другие серверы для Яндекса и рекламы — в категории маркетинг и соцсети.

Установка

Нужны Node.js 20 или новее, API-ключ Yandex Cloud для Search API и ID каталога Yandex Cloud. Сервер запускается через npx:

npx -y mcp-yandex-wordstat@latest

Как получить доступ по README:

  1. В Yandex Cloud создайте сервисный аккаунт с ролью search-api.webSearch.user.
  2. Выпустите для него API-ключ со scope yc.search-api.execute.
  3. Найдите ID каталога в консоли Yandex Cloud.
  4. Передайте ключ в WORDSTAT_API_KEY, а каталог — в WORDSTAT_FOLDER_ID.

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

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

claude mcp add \
  --env WORDSTAT_API_KEY=ваш_ключ \
  --env WORDSTAT_FOLDER_ID=ваш_folder_id \
  --transport stdio \
  --scope user \
  yandex-wordstat \
  -- npx -y mcp-yandex-wordstat@latest

Для VS Code README даёт конфиг с запросом ключа через inputs, чтобы не хранить его в файле открытым текстом.

Проверка

Спросите: «Сколько в месяц ищут „купить велосипед“ и какие есть похожие запросы?». Ассистент должен вызвать top_requests. Если приходит ошибка доступа, проверьте роль сервисного аккаунта и scope ключа.

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

Подбери запросы вокруг «доставка пиццы» с их частотностью.
Покажи спрос на «лыжи» по месяцам за год.
Сравни спрос на «ремонт квартир» в Москве и Санкт-Петербурге.

Риски

Сервер ничего не меняет: по README все пять инструментов работают только на чтение, а у API Вордстата нет методов создания объектов. API-ключ хранится в конфиге MCP-клиента открытым текстом. Запросы тратят квоту Search API в вашем каталоге Yandex Cloud.

По умолчанию сервер отправляет анонимную телеметрию: случайный идентификатор установки, имя инструмента, версии и исход вызова. По README в неё не попадают API-ключ, аргументы инструментов и данные спроса. Отключить телеметрию можно переменной ASKADS_TELEMETRY=0. Лицензия — MIT.

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

Нужен ли доступ к Яндекс Директу?

Нет. Сервер использует Yandex Cloud Search API v2, нужны API-ключ и ID каталога Yandex Cloud.

За какой период показываются данные?

Топ запросов и регионы — за последние 30 дней. Динамика строится по дням, неделям или месяцам.

Может ли сервер что-то изменить в аккаунте?

Нет. Все инструменты только читают статистику спроса.

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

Инструменты

  • top_requests
  • dynamics
  • regions
  • raw_request

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

AutoClip

Нарезка длинных видео на короткие клипы с обложками и субтитрами.

Риск: medium Лицензия: MIT ★ 10 310

NotFair

Доступ к Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4 и WordPress через OAuth.

Риск: medium Лицензия: MIT ★ 4 143

obsei

Самостоятельно размещаемая система обратной связи клиентов с удалением персональных данных.

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

Источники