Yandex Wordstat MCP
Yandex Wordstat MCP — MCP-сервер сообщества (автор — stufently). Сервер для API Яндекс Вордстата: подбор ключевых слов для рынков России и СНГ. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- stufently
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- javascript
Уровень риска: medium
Только чтение статистики Вордстата. Запросы к Search API тарифицируются в Yandex Cloud; выдайте сервисному аккаунту минимальную роль.
Что умеет
yandex-wordstat-mcp — MCP-сервер для Яндекс Вордстата через Yandex Cloud Search API v2. Он помогает подбирать ключевые слова, смотреть динамику спроса и распределение запросов по регионам для России и стран СНГ. Старый API api.wordstat.yandex.net Яндекс отключил в 2026 году, поэтому с версии 2.0 сервер работает через Search API в Yandex Cloud и авторизуется ключом API сервисного аккаунта.
| Инструмент | Что делает |
|---|---|
top-requests |
Популярные запросы с ключевым словом за последние 30 дней и похожие запросы, по убыванию частоты |
dynamics |
Динамика частоты запроса по дням, неделям или месяцам |
regions |
Распределение интереса по регионам с долей и индексом соответствия |
get-regions-tree |
Дерево регионов Вордстата |
get-region-children |
Дочерние регионы из сохранённого дерева, без обращения к API |
Запросы можно фильтровать по регионам и устройствам (компьютер, телефон, планшет). У dynamics есть недокументированные ограничения API на окна дат: сервер сам подгоняет даты к допустимым, перечисляет все сдвиги в поле adjustments и честно сообщает, если запрошен ещё не закончившийся период.
Кому подойдёт
- SEO-специалистам: сбор семантики и проверка частот прямо в диалоге с ассистентом.
- Маркетологам: сезонность спроса и сравнение регионов.
- Тем, кто запускает рекламу в Директе: подбор фраз и оценка спроса перед запуском.
Похожие серверы — в категории маркетинг и соцсети.
Установка
Пакет будет опубликован как @stufently/yandex-wordstat-mcp, но пока под этим именем ничего не выложено. Пакет без префикса yandex-wordstat-mcp принадлежит другому автору. Поэтому запускайте сервер из исходников:
git clone https://github.com/stufently/yandex-mcp.git
cd yandex-mcp && bun install
node packages/yandex-wordstat-mcp/src/index.mjsКак получить ключ: в консоли Yandex Cloud выберите каталог (к облаку должен быть привязан платёжный аккаунт), создайте сервисный аккаунт с ролью search-api.webSearch.user и выпустите для него ключ API с областью yc.search-api.execute. Секрет показывается один раз — сохраните его в WORDSTAT_API_KEY, идентификатор каталога — в WORDSTAT_FOLDER_ID. Вместо переменных окружения можно использовать файл ~/.config/yandex-cloud/wordstat.env.
Подключение к клиентам
Конфиг приведён дословно из README. Укажите путь к склонированному репозиторию. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"yandex-wordstat": {
"command": "node",
"args": ["/path/to/yandex-mcp/packages/yandex-wordstat-mcp/src/index.mjs"],
"env": {
"WORDSTAT_API_KEY": "AQVN...",
"WORDSTAT_FOLDER_ID": "b1g..."
}
}
}
}Проверка
Спросите ассистента: «Какие самые популярные запросы со словом "велосипед" в Вордстате?» Он вызовет top-requests и покажет фразы с частотами.
Примеры задач
Покажи помесячную динамику запроса "купить ёлку" за последний год.В каких регионах чаще всего ищут "ремонт квартир"?Риски
Сервер только читает статистику Вордстата и ничего не меняет. Ключ API сервисного аккаунта даёт доступ к Search API в вашем каталоге Yandex Cloud, а запросы тарифицируются по правилам облака через привязанный платёжный аккаунт.
Что встроено: ограничение 10 запросов в секунду на стороне клиента, автоматические повторы с нарастающей паузой при ответах 429 и 5xx. Дерево регионов загружается один раз за сессию.
Как снизить риски: выдайте сервисному аккаунту только роль search-api.webSearch.user, храните ключ в переменной окружения или в файле с ограниченными правами. Не путайте пакет с одноимённым пакетом другого автора. Лицензия — MIT.
Частые вопросы
Работает ли сервер со старым API Вордстата?
Нет. Старый API отключён, с версии 2.0 используется Search API v2 в Yandex Cloud.
Почему изменились даты в ответе dynamics?
API принимает только определённые окна дат. Сервер подгоняет даты и перечисляет все сдвиги в поле adjustments.
Основы протокола — на странице что такое MCP-сервер.
Инструменты
- top-requests
- dynamics
- regions
- get-regions-tree
- get-region-children
Похожие MCP-серверы
Zotero MCP
Поиск, чтение, аннотации и пополнение библиотеки Zotero.
arxiv-mcp-server
Поиск статей arXiv, загрузка полных текстов и графы цитирования.
PaperBanana
Генерация научных диаграмм и графиков по тексту.
ToolUniverse
Более 2700 научных инструментов для ИИ-исследователей.