Yandex Wordstat MCP
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает статистику поисковых запросов, не меняет ничего в аккаунтах
- Запросы к Search API платные, стоит следить за расходом
Установка
Ручная установка
pipx install git+https://github.com/N1arko/yandex-wordstat-mcp.gitОсновной способ из README: установка изолированного пакета через pipx.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту четыре инструмента над 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
- Нужна кластеризация или сбор минус-слов автоматически: сервер отдает только сырые данные
Пример запроса к агенту
Проверь сезонность по запросу «детский лагерь» за последний год по России и скажи, когда лучше запускать рекламуОграничения
Нужны YC_SEARCH_API_KEY (или YC_IAM_TOKEN) и YC_FOLDER_ID из Yandex Cloud, вызовы платные. По умолчанию минус-слова не применяются, их нужно явно попросить у агента. Smoke-тест из scripts/ требует реальные ключи.
Как отключить. Удалите запись yandex_wordstat из конфигурации MCP клиента и, если ставили через pipx, выполните pipx uninstall yandex-wordstat-mcp.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YC_SEARCH_API_KEY обязательная, секрет | API-ключ сервисного аккаунта со scope yc.search-api.execute. |
| YC_FOLDER_ID обязательная | ID каталога Yandex Cloud. |
| YC_IAM_TOKEN секрет | Альтернатива API-ключу. |
Проверка безопасности
- Только читает статистику поисковых запросов, не меняет ничего в аккаунтах
- Запросы к Search API платные, стоит следить за расходом
Коротко о README
README на русском объясняет, зачем нужен сервер, дает готовую фразу для автоматической установки агентом, таблицу нужных переменных Yandex Cloud, примеры задач для маркетолога, таблицу инструментов и подробный раздел «если что-то не работает» с частыми ошибками авторизации.
Частые вопросы
Какой регион используется, если не указать его явно?
225, вся Россия. Для Москвы нужно передать регион 213.
Нужен ли аккаунт Яндекс Директа?
Нет, доступ идет через Yandex Cloud Search API, отдельный сервисный аккаунт с ролью search-api.webSearch.user.
Похожие
Скиллы DataLens
DataLens Skills
Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS
MCP Яндекс Метрики со всеми 108 методами API
Yandex Metrika MCP Server
MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа
Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO
Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов