MCP для Яндекс Wordstat с контролем бюджета
@cododel/yandex-wordstat-mcp
MCP-сервер на Bun для официального Yandex Wordstat API v2 с учетом стоимости запросов и лимитами расходов в рублях
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Часть вызовов платная и списывает деньги с аккаунта Yandex Search API
- HTTP-режим с --allow-server-credentials тратит ключ сервера от лица любого клиента, если не ограничен MCP_ACCESS_TOKEN
Установка
Ручная установка
bun install --frozen-lockfile && bun test && bun run typecheckУстановка из исходников, команда из INSTALL.md для проверки сборки перед подключением.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает пять инструментов Wordstat: дерево регионов, дочерние регионы из кэша, топ запросов, динамику и распределение по регионам, при этом первые два бесплатны, а остальные три платные по прайсу Yandex Search API. У каждого платного вызова есть защита от повторной оплаты при ошибке или неизвестном исходе. Сервер поддерживает stdio для локального клиента и Streamable HTTP для удаленного запуска с BYOK: внешний клиент передает свой ключ и folder id заголовками, а не через переменные окружения сервера. В HTTP-режиме можно включить собственный бюджетный лимит в рублях на час и на день с хранением счетчика в SQLite. В репозитории также лежит отдельный скилл skills/yandex-wordstat/SKILL.md, который учит агента правильно пользоваться этими инструментами, но сам по себе сервер он не устанавливает.
Для кого. Для тех, кому важен контроль расходов на платные вызовы Wordstat при удаленном доступе нескольких клиентов
Подходит, если
- Нужен MCP-сервер Wordstat с явным учетом стоимости каждого платного вызова
- Нужен удаленный сервер, где каждый клиент платит своим ключом Yandex
- Важно ограничить расходы на Wordstat лимитом в рублях в час или в день
Не подходит, если
- Нужен просто локальный сервер без бюджетного контроля: проще взять более простую реализацию
- Нет ключа Yandex Search API и folder id
Пример запроса к агенту
Найди динамику запроса «курсы английского» за последний год по Москве и скажи, сколько это будет стоитьОграничения
Проект без звезд, автор один, README прямо называет его развитием стороннего пакета yandex-wordstat-mcp с добавленной архитектурой и BYOK. На момент проверки пакет не был опубликован в npm, INSTALL.md описывает установку из исходников на Bun. HTTP-режим нужно закрывать HTTPS самостоятельно, встроенного TLS нет.
Как отключить. Остановите процесс сервера или контейнер и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_WORDSTAT_API_KEY обязательная, секрет | Ключ Yandex Search API, можно задать также как YANDEX_SEARCH_API_KEY |
| YANDEX_WORDSTAT_FOLDER_ID обязательная | Folder id Yandex Cloud, можно задать также как YANDEX_CLOUD_FOLDER_ID |
| MCP_ACCESS_TOKEN секрет | Токен доступа к самому MCP-сервису в удаленном HTTP-режиме |
| WORDSTAT_MAX_COST_RUB_PER_HOUR | Лимит расходов на платные вызовы в рублях в час |
| WORDSTAT_MAX_COST_RUB_PER_DAY | Лимит расходов на платные вызовы в рублях в день |
Проверка безопасности
- Часть вызовов платная и списывает деньги с аккаунта Yandex Search API
- HTTP-режим с --allow-server-credentials тратит ключ сервера от лица любого клиента, если не ограничен MCP_ACCESS_TOKEN
Коротко о README
README и INSTALL.md описывают сервер как развитие пакета yandex-wordstat-mcp с общей типизированной архитектурой, локальным stdio и удаленным Streamable HTTP, политикой BYOK-заголовков вместо переменных окружения на сервере, Docker-упаковкой и метаданными стоимости вызовов. Отдельно подчеркнуто, что платные операции нельзя автоматически повторять после ошибки или неизвестного результата.
Частые вопросы
Все ли инструменты платные?
Нет, дерево регионов и дочерние регионы бесплатны, а top-requests, dynamics и regions идут по цене Yandex Search API, около 0.02-0.05 рубля за вызов.
Как ограничить расходы?
Задать вместе WORDSTAT_MAX_COST_RUB_PER_HOUR и WORDSTAT_MAX_COST_RUB_PER_DAY, тогда включается бюджетный guard на SQLite.
Похожие
Скиллы 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-поиск силами параллельных агентов