Yandex Wordstat MCP
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
- 2 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает локальный сервер, который по ключу Yandex Cloud читает статистику Вордстата
- Вызовы Search API платные, расход идет с вашего облака
Установка
- Работает в
- Сервисы
Ручная установка
pipx install git+https://github.com/N1arko/yandex-wordstat-mcp.gitОсновной способ из README: установка изолированного пакета через pipx.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный сервер, который по ключу Yandex Cloud читает статистику Вордстата
- Вызовы Search API платные, расход идет с вашего облака
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту четыре инструмента над Wordstat API: wordstat_top_requests возвращает популярные и похожие запросы по фразе, wordstat_dynamics показывает динамику спроса по датам, wordstat_get_regions_tree отдает дерево регионов Яндекса, а wordstat_find_region ищет ID региона по названию. По умолчанию используется регион 225 (вся Россия). README прямо показывает, как агент связывает вызовы в цепочку: сначала найти регион, потом посмотреть топ запросов и динамику, и как из ответа собрать вывод для маркетолога про коммерческие и информационные интенты.
Для кого. Для маркетологов, которые собирают семантику и проверяют сезонность спроса прямо в диалоге с Codex или Claude Desktop.
Подходит, если
- Нужно быстро проверить спрос на фразу и получить похожие формулировки
- Нужна сезонность запроса за год для планирования рекламы
- Нужно найти ID региона Яндекса по названию города
Не подходит, если
- Нет аккаунта Yandex Cloud с доступом к Search API
- Нужна кластеризация или сбор минус-слов автоматически: сервер отдает только сырые данные
Пример запроса к агенту
Проверь сезонность по запросу «детский лагерь» за последний год по России и скажи, когда лучше запускать рекламуMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YC_SEARCH_API_KEYобязательная, секрет- API-ключ сервисного аккаунта со scope yc.search-api.execute.
YC_FOLDER_IDобязательная- ID каталога Yandex Cloud.
YC_IAM_TOKENсекрет- Альтернатива API-ключу.
Ограничения
Нужны YC_SEARCH_API_KEY (или YC_IAM_TOKEN) и YC_FOLDER_ID из Yandex Cloud, вызовы платные. По умолчанию минус-слова не применяются, их нужно явно попросить у агента. Smoke-тест из scripts/ требует реальные ключи.
Как отключить. Удалите запись yandex_wordstat из конфигурации MCP клиента и, если ставили через pipx, выполните pipx uninstall yandex-wordstat-mcp.
Частые вопросы
Какой регион используется, если не указать его явно?
225, вся Россия. Для Москвы нужно передать регион 213.
Нужен ли аккаунт Яндекс Директа?
Нет, доступ идет через Yandex Cloud Search API, отдельный сервисный аккаунт с ролью search-api.webSearch.user.
Чем Yandex Wordstat MCP отличается от других серверов для Вордстата?
Сервер использует официальный Yandex Cloud Search API и дает четыре инструмента: wordstat_top_requests возвращает популярные и похожие запросы по фразе, wordstat_dynamics показывает динамику спроса по датам, также есть регионы и частотность.
Какой регион используется без явного указания и нужен ли аккаунт Директа?
Регион по умолчанию описан в README сервера, для надежности указывайте его в запросе. Аккаунт Яндекс Директа не нужен: доступ идет через сервисный аккаунт Yandex Cloud и ключ Search API. Установка: pipx install git+https://github.com/N1arko/yandex-wordstat-mcp.git.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
MCP-сервер Вордстата через Yandex Cloud Search API: частотность и похожие запросы, сезонность, спрос по регионам и устройствам
MCP-сервер Вордстата от khanton
Yandex Wordstat MCP Server
Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы
yandex-wordstat-mcp от nikolaymokh-dev
yandex-wordstat-mcp
MCP-сервер Вордстата через Yandex Search API с оценкой и учетом стоимости запросов до и после вызова
Яндекс Поиск и Вордстат MCP: web_search и частоты фраз
mcp-yandex-search
MCP-сервер на одном ключе AI Studio: четыре метода Вордстата, поиск по индексу Яндекса и сырой запрос к Wordstat API
MCP-сервер Yandex Cloud Search API v2: Вордстат и веб-поиск с файловым кешем, нормализацией дат и устойчивостью к 429
Коротко о README
README на русском объясняет, зачем нужен сервер, дает готовую фразу для автоматической установки агентом, таблицу нужных переменных Yandex Cloud, примеры задач для маркетолога, таблицу инструментов и подробный раздел «если что-то не работает» с частыми ошибками авторизации.