Yandex Wordstat MCP Server
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
- 3 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Сервер на FastMCP по ключу Yandex Cloud запрашивает топ, динамику и регионы Вордстата
- Дерево регионов кеширует в локальный файл, вызовы API платные
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/yandex-wordstat-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер на FastMCP по ключу Yandex Cloud запрашивает топ, динамику и регионы Вордстата
- Дерево регионов кеширует в локальный файл, вызовы API платные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на FastMCP оборачивает методы Wordstat API v2 (getTop, getDynamics, getRegionsDistribution, getRegionsTree) и добавляет свои инструменты поверх: build_wordstat_phrase собирает корректную фразу с операторами (кавычки, плюс, минус-слова) из обычной формулировки на русском, find_regions ищет ID региона по названию с локальным кешем дерева регионов, а задачи вроде поиска похожих запросов или сравнения спроса по регионам доступны под понятными именами (find_keyword_queries, get_query_demand_trends). Есть повторные попытки при сетевых сбоях и 429/5xx, ресурс и prompt с гайдом по операторам Вордстата для агента.
Для кого. Для маркетологов и SEO-специалистов, которые собирают семантику и проверяют спрос через агента вместо сайта Вордстата.
Подходит, если
- Нужно проверить частотность фразы и похожие запросы
- Нужна сезонность спроса по месяцам, неделям или дням
- Нужно сравнить спрос по регионам или найти ID региона по названию города
Не подходит, если
- Нет доступа к Yandex Cloud с включенным Search API
- Нужны данные Яндекс Директа или готовые кластеры, а не сырые частоты
Пример запроса к агенту
Проверь частотность фразы «купить пылесос» по Москве и покажи топ похожих запросовMCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
WORDSTAT_FOLDER_IDобязательная- ID каталога в Yandex Cloud, обязателен для каждого запроса.
WORDSTAT_API_KEYсекрет- API-ключ Yandex Cloud; нужен либо он, либо IAM-токен.
WORDSTAT_IAM_TOKENсекрет- IAM-токен Yandex Cloud; имеет приоритет, если задан вместе с API-ключом.
Ограничения
Нужен ключ Yandex Cloud (API-ключ или IAM-токен) и Folder ID, вызовы Search API платные по тарифам Яндекс Облака. Метод getDynamics поддерживает только оператор «+» и отклоняет остальные операторы. Дерево регионов кешируется локально в файл .saved, обновление вручную через отдельный инструмент.
Как отключить. Удалите сервер из конфигурации MCP клиента (например, claude mcp remove yandex-wordstat) или сотрите каталог .saved с локальным кешем регионов.
Частые вопросы
Чем IAM-токен отличается от API-ключа?
Оба подходят для авторизации в Yandex Cloud; если заданы оба, сервер использует IAM-токен.
Можно ли собрать фразу с минус-словами из обычной просьбы?
Да, build_wordstat_phrase понимает формулировки на русском и строит фразу с нужными операторами Вордстата.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
MCP-сервер Вордстата от khanton
Yandex Wordstat MCP Server
Компактный MCP-сервер на TypeScript для Яндекс Вордстата через Yandex Search API: топ запросов, динамика и регионы
MCP-сервер Вордстата через Yandex Cloud Search API: частотность и похожие запросы, сезонность, спрос по регионам и устройствам
yandex-wordstat-mcp от nikolaymokh-dev
yandex-wordstat-mcp
MCP-сервер Вордстата через Yandex Search API с оценкой и учетом стоимости запросов до и после вызова
Яндекс Поиск и Вордстат MCP: web_search и частоты фраз
mcp-yandex-search
MCP-сервер на одном ключе AI Studio: четыре метода Вордстата, поиск по индексу Яндекса и сырой запрос к Wordstat API
Wordstat MCP Server: частоты Яндекса с лимитами и кешем
wordstat-mcp-server
Неофициальный MCP-сервер Вордстата на TypeScript, только чтение: пять инструментов, локальные лимиты вызовов, кеш регионов и счетчики расходов
Коротко о README
README на английском и русском описывает установку через uvx прямо из Git, настройку .env с ключом и Folder ID и список инструментов: четыре метода Wordstat API, построитель фраз с операторами, поиск региона с локальным кешем и служебный wordstat_env_health. Отдельно расписана настройка для Claude Desktop, Claude Code и Codex с готовыми командами claude mcp add и codex mcp add.