MCP SERVERAsk for Yandex search demand — volumes, related queries, seasonality and regional split — in one conversation instead of three Wordstat tabs.
LABSCO SUMMARY
The three data tools cover the three questions keyword research actually asks: how big, which way is it moving, and where. Two practical notes before you script it: one call covers one phrase, so a long keyword list is better narrowed first than fired through wholesale against the shared quota, and counts can arrive as strings, because Yandex sends large integers that way in JSON.
A read-only server over Yandex Wordstat's search-demand data, reached through the Yandex Cloud Search API rather than a Yandex Direct advertising account. Five tools cover how often a phrase is searched, how that moves over time, and where the interest is.
Node.js 20 or newer, a Yandex Cloud API key for the Search API in WORDSTAT_API_KEY, and the cloud folder id in WORDSTAT_FOLDER_ID. No Yandex Direct OAuth and no advertising account. Wordstat exposes no writes, so nothing here can create or change a campaign — and the quota is billed against that one key, shared by every call.
One command plus a key — npx -y mcp-yandex-wordstat@latest, then supply credentials
USE CASES
Get the popular queries that contain it and the related ones that do not, with a monthly total, in one call.
Pull the series by month across a year, or by week when the swing is tighter, and read the share alongside the count.
Read the regional split with its affinity index, so you target where interest runs above average rather than where the population is largest.
Run the same phrase with a device filter and compare, before deciding what the landing page has to be.
Call the path directly through the passthrough rather than waiting for a wrapper.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
dynamicsВозвращает, как менялся спрос на фразу во времени, — ряд {date, count, share}, где share — доля от всех поисковых запросов Яндекса. Подходит для оценки сезонности и тренда. period задаёт шаг ряда (daily/weekly/monthly). fromDate/toDate ограничивают диапазон метками времени RFC3339, при этом toDate должен попадать на границу периода.
list_regionsВозвращает справочное дерево регионов, которые поддерживает Вордстат, — id регионов и их названия (label). Эти id подставляются в regionIds/regionMode остальных инструментов, а названия расшифровывают id регионов в их ответах. Дерево большое и стабильное: достаточно запросить его один раз и закешировать.
raw_requestУниверсальный запрос: обращается напрямую к любому пути Wordstat в Yandex Cloud Search API — для эндпоинтов, у которых нет отдельного инструмента, например "v2/wordstat/topRequests". Все эндпоинты Вордстата работают методом POST; body отправляется как JSON (folderId подставляется автоматически).
regionsВозвращает, как спрос на фразу распределён по регионам за последние 30 дней. В каждой строке — id региона, count, share и affinityIndex (>100% — интерес в регионе выше среднего, <100% — ниже). regionMode выбирает группировку: all, cities (только города) или regions (только области и субъекты). Сопоставить id регионов с названиями помогает list_regions.
top_requestsВозвращает поисковый спрос по фразе за последние 30 дней: самые популярные запросы, которые СОДЕРЖАТ фразу (results), и семантически ПОХОЖИЕ запросы, которые могут её не содержать (associations), плюс totalCount. Подходит для подбора ключевых фраз и оценки спроса. Значения счётчиков могут приходить строками (int64). Необязательные regionIds и devices сужают выборку; numPhrases задаёт, сколько фраз вернуть (1..2000).
BEFORE YOU INSTALL
5 tools when we connected. All five, including raw_request, only read.
CONTEXT COST
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y mcp-yandex-wordstat@latestcodex mcp add yandex-wordstat \
--env WORDSTAT_API_KEY=<YOUR_WORDSTAT_API_KEY> \
--env WORDSTAT_FOLDER_ID=<YOUR_WORDSTAT_FOLDER_ID> \
-- npx -y mcp-yandex-wordstat@latestclaude mcp add \
--env WORDSTAT_API_KEY=<YOUR_WORDSTAT_API_KEY> \
--env WORDSTAT_FOLDER_ID=<YOUR_WORDSTAT_FOLDER_ID> \
--transport stdio \
--scope user \
yandex-wordstat \
-- npx -y mcp-yandex-wordstat@latest{
"mcpServers": {
"yandex-wordstat": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat@latest"
],
"env": {
"WORDSTAT_API_KEY": "<YOUR_WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<YOUR_WORDSTAT_FOLDER_ID>"
}
}
}
}{
"servers": {
"yandex-wordstat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat@latest"
],
"env": {
"WORDSTAT_API_KEY": "${input:wordstat_api_key}",
"WORDSTAT_FOLDER_ID": "${input:wordstat_folder_id}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "wordstat_api_key",
"description": "Yandex Cloud API key",
"password": true
},
{
"type": "promptString",
"id": "wordstat_folder_id",
"description": "Yandex Cloud folder ID"
}
]
}MCP servers
