Wordstat MCP Server: частоты Яндекса с лимитами и кешем
wordstat-mcp-server
Неофициальный MCP-сервер Вордстата на TypeScript, только чтение: пять инструментов, локальные лимиты вызовов, кеш регионов и счетчики расходов
- 0 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Сервер только читает статистику, но вызовы Вордстата тарифицируются Яндексом и тратят платную квоту
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/wordstat-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер только читает статистику, но вызовы Вордстата тарифицируются Яндексом и тратят платную квоту
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Неофициальный MCP-сервер на TypeScript для Wordstat API Яндекса. Пять инструментов, все помечены как «только чтение» и идемпотентные: `wordstat_top_requests` (популярные и связанные запросы за 30 дней), `wordstat_dynamics` (динамика по дням, неделям и месяцам с автоматическим подбором дат), `wordstat_regions`, `wordstat_regions_tree` и `wordstat_find_regions` (локальный поиск идентификатора региона по названию). Авторизация одним способом на выбор: API-ключ `YANDEX_WORDSTAT_API_KEY` или IAM-токен `YANDEX_WORDSTAT_IAM_TOKEN` с `YANDEX_WORDSTAT_FOLDER_ID`. Внутри локальные пределы по запросам в секунду, в час и по параллельности, повторы с учетом `Retry-After`, кеш дерева регионов и счетчики API-вызовов. Запуск `npx -y wordstat-mcp-server@latest`.
Для кого. Аналитикам и SEO-специалистам, которым важно не выйти за квоту Search API: лимиты вызовов и счетчики расходов считаются на стороне сервера.
Подходит, если
- Агент просматривает много фраз, и расход вызовов Вордстата нужно держать под контролем
- Нужна динамика частоты без ручного расчета границ периода
- По названию города или области надо найти идентификатор региона для запроса
- Сервер подключается к Codex, Claude Code или Hermes Agent с готовым конфигом
Не подходит, если
- Нужен веб-поиск по выдаче Яндекса: сервер возвращает только данные Вордстата
- Node.js старой версии: требуются 22.23.4, 24.22.1 или 26.12.1 и новее в своей линейке
- Нужен вызов нестандартных методов Wordstat API: произвольного запроса в наборе нет
Пример запроса к агенту
Найди идентификатор региона для Казани и покажи месячную динамику фразы «ремонт квартир» за последний годMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
YANDEX_WORDSTAT_API_KEYсекрет- API-ключ со scope yc.search-api.execute (или IAM-токен)
YANDEX_WORDSTAT_IAM_TOKENсекрет- IAM-токен вместо API-ключа
YANDEX_WORDSTAT_FOLDER_ID- Каталог Yandex Cloud для IAM-токена аккаунта Яндекса
Ограничения
Нужен Node.js не ниже 22.23.4, 24.22.1 или 26.12.1 в своей линейке и один способ входа: API-ключ с областью `yc.search-api.execute` либо IAM-токен с ролью `search-api.webSearch.user` на каталог. Запросы тарифицируются Яндексом, а каждая следующая страница `wordstat_regions` снова платная. Последние календарные точки динамики могут быть не опубликованы, диапазон после последней точки иногда дает HTTP 400. Статус версии 0.1.1, ноль звезд, последний коммит в ноябре 2026 года. Проект неофициальный и с Яндексом не связан.
Как отключить. Удалите сервер из конфигурации Codex, Claude Code или Hermes Agent и отзовите ключ или IAM-токен в Yandex Cloud.
Частые вопросы
Какие инструменты есть?
Пять: топ запросов, динамика, распределение по регионам, дерево регионов и локальный поиск региона по названию.
Какую авторизацию выбрать?
Одну из двух: API-ключ или IAM-токен. Оба сразу передавать нельзя; IAM-токен аккаунта Яндекса требует еще `YANDEX_WORDSTAT_FOLDER_ID`.
Как подключить к Hermes Agent?
Добавить блок `mcp_servers` с `npx -y wordstat-mcp-server@latest` в `~/.hermes/config.yaml`, проверить `hermes mcp test yandex_wordstat` и перезагрузить MCP.
Платные ли запросы?
Да, Яндекс может тарифицировать вызовы Вордстата; сервер ведет счетчики, чтобы расход было видно.
Что с датами динамики?
При `auto_dates: true` сервер сам берет последние завершенные периоды: 60 дней, 52 недели или 12 месяцев.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер Вордстата от khanton
Yandex Wordstat MCP Server
Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы
Простой MCP для Яндекс Wordstat
wordstat-mcp
Компактный MCP-сервер на официальном SDK для пяти операций Яндекс Wordstat: топ, динамика, регионы, дерево регионов, данные аккаунта
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
MCP-сервер только для чтения статистики Яндекс Вордстата: топ фраз, динамика, регионы, с OAuth-входом для ChatGPT
yandex-wordstat-mcp от nikolaymokh-dev
yandex-wordstat-mcp
MCP-сервер Вордстата через Yandex Search API с оценкой и учетом стоимости запросов до и после вызова
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
Коротко о README
В README указаны статус 0.1.1, возможности (все методы Wordstat API, схемы ввода и вывода, повторы, лимиты, кеш, счетчики), требования, два способа авторизации, подключение к Codex, Claude Code и Hermes Agent, таблицу инструментов и нюансы дат.