Yandex Wordstat MCP — MCP-сервер для Claude Code
Подключает Яндекс Wordstat к ИИ-агенту: частотность запросов, динамика спроса и география поиска для рынков России и СНГ.
claude mcp add yandex-wordstat-mcp -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -- npx -y @stufently/yandex-wordstat-mcpЧто делает Yandex Wordstat MCP
Сервер работает через Yandex Cloud Search API v2 и авторизуется ключом сервисного аккаунта. Старый api.wordstat.yandex.net Яндекс отключил в 2026 году, поэтому OAuth-токен больше не подойдёт. Имена инструментов и параметры при этом не изменились.
Внутри пять инструментов. top-requests ищет популярные запросы с ключевым словом за последние 30 дней и связанные с ними фразы, dynamics показывает динамику по дням, неделям или месяцам, regions — распределение интереса по регионам с индексом аффинности. Дерево регионов подтягивается один раз за сессию и кешируется, а get-region-children отвечает из кеша без обращения к API. Клиентский лимит — 10 запросов в секунду со скользящим окном, остальное уходит в очередь; ответы 429 и 5xx повторяются с экспоненциальной задержкой.
Для работы нужны две переменные окружения: WORDSTAT_API_KEY и WORDSTAT_FOLDER_ID. Ключ создаётся в консоли Yandex Cloud у сервисного аккаунта с ролью search-api.webSearch.user и областью yc.search-api.execute, к облаку должен быть привязан платёжный аккаунт. Без ключа сервер не стартует. У dynamics есть неочевидные правила по датам: для daily начало периода обязано попадать в последние 60 дней, для weekly — быть понедельником, для monthly — первым числом месяца. Неверные даты не отклоняются, а подтягиваются к ближайшему допустимому окну, и все сдвиги перечисляются в adjustments.
Какие задачи решает
- собрать семантику для сайта на русском языке
- посмотреть, как менялся спрос на товар за год
- понять, в каких регионах ключевое слово ищут чаще
- найти связанные запросы вокруг одной фразы
- сравнить частотность по устройствам: десктоп, телефон, планшет
Примеры запросов агенту
- Покажи топ-100 запросов со словом «доставка цветов» за последние 30 дней
- Построй динамику спроса на «электросамокат» по месяцам за последний год
- Разбей интерес к «ремонт квартир» по регионам и покажи индекс аффинности
Как установить Yandex Wordstat MCP
Командой платформы
claude mcp add yandex-wordstat-mcp -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -- npx -y @stufently/yandex-wordstat-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add yandex-wordstat-mcp --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -- npx -y @stufently/yandex-wordstat-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"yandex-wordstat-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-wordstat-mcp"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"yandex-wordstat-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/yandex-wordstat-mcp"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> yandex-wordstat-mcp npx -y @stufently/yandex-wordstat-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Yandex Wordstat MCP
Как установить Yandex Wordstat MCP в Claude Code?
Выполните `claude mcp add yandex-wordstat-mcp -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -- npx -y @stufently/yandex-wordstat-mcp`. Подставьте свой ключ и ID каталога вместо плейсхолдеров.
Что делает Yandex Wordstat MCP?
Даёт агенту доступ к статистике поисковых запросов Яндекса: частотность фраз, динамика по времени и распределение по регионам. Работает через Yandex Cloud Search API v2.
Что нужно для работы сервера?
Ключ API сервисного аккаунта с ролью search-api.webSearch.user и ID каталога Yandex Cloud. Они передаются в WORDSTAT_API_KEY и WORDSTAT_FOLDER_ID.
