MCP для Яндекс Wordstat с контролем бюджета
@cododel/yandex-wordstat-mcp
MCP-сервер на Bun для официального Yandex Wordstat API v2 с учетом стоимости запросов и лимитами расходов в рублях
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Часть вызовов платная и списывает деньги с аккаунта Yandex Search API
- HTTP-режим с --allow-server-credentials тратит ключ сервера от лица любого клиента, если не ограничен MCP_ACCESS_TOKEN
Установка
- Работает в
- Сервисы
Ручная установка
bun install --frozen-lockfile && bun test && bun run typecheckУстановка из исходников, команда из INSTALL.md для проверки сборки перед подключением.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Часть вызовов платная и списывает деньги с аккаунта Yandex Search API
- HTTP-режим с --allow-server-credentials тратит ключ сервера от лица любого клиента, если не ограничен MCP_ACCESS_TOKEN
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает пять инструментов 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
Пример запроса к агенту
Найди динамику запроса «курсы английского» за последний год по Москве и скажи, сколько это будет стоить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- Лимит расходов на платные вызовы в рублях в день
Ограничения
Проект без звезд, автор один, README прямо называет его развитием стороннего пакета yandex-wordstat-mcp с добавленной архитектурой и BYOK. На момент проверки пакет не был опубликован в npm, INSTALL.md описывает установку из исходников на Bun. HTTP-режим нужно закрывать HTTPS самостоятельно, встроенного TLS нет.
Как отключить. Остановите процесс сервера или контейнер и удалите его из конфигурации MCP клиента.
Частые вопросы
Все ли инструменты платные?
Нет, дерево регионов и дочерние регионы бесплатны, а 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.
Обсуждение
Вопросов и отзывов пока нет.
Простой MCP для Яндекс Wordstat
wordstat-mcp
Компактный MCP-сервер на официальном SDK для пяти операций Яндекс Wordstat: топ, динамика, регионы, дерево регионов, данные аккаунта
yandex-wordstat-mcp от nikolaymokh-dev
yandex-wordstat-mcp
MCP-сервер Вордстата через Yandex Search API с оценкой и учетом стоимости запросов до и после вызова
Wordstat MCP Server: частоты Яндекса с лимитами и кешем
wordstat-mcp-server
Неофициальный MCP-сервер Вордстата на TypeScript, только чтение: пять инструментов, локальные лимиты вызовов, кеш регионов и счетчики расходов
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
MCP-сервер Вордстата от khanton
Yandex Wordstat MCP Server
Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы
Коротко о README
README и INSTALL.md описывают сервер как развитие пакета yandex-wordstat-mcp с общей типизированной архитектурой, локальным stdio и удаленным Streamable HTTP, политикой BYOK-заголовков вместо переменных окружения на сервере, Docker-упаковкой и метаданными стоимости вызовов. Отдельно подчеркнуто, что платные операции нельзя автоматически повторять после ошибки или неизвестного результата.