Yandex Wordstat MCP Server

Name: Yandex Wordstat MCP Server
Author: solaix

by solaixversion 0.1.1i★ –iRuns on your computer

Registry nameio.github.solaix/wordstat-mcp-server

Install

Overview

Description from the maker (original English)

Unofficial Yandex Wordstat MCP server for SEO keyword research, trends, and regional interest.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Marketing & social media
You need to fill in: YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN, YANDEX_WORDSTAT_FOLDER_ID, YANDEX_WORDSTAT_TIMEOUT_MS, YANDEX_WORDSTAT_MAX_RETRIES, YANDEX_WORDSTAT_MAX_RPS, YANDEX_WORDSTAT_MAX_RPH, YANDEX_WORDSTAT_MAX_CONCURRENCY, YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS, YANDEX_WORDSTAT_LOG_LEVEL

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "wordstat-mcp-server"
      ],
      "env": {
        "YANDEX_WORDSTAT_API_KEY": "your-value",
        "YANDEX_WORDSTAT_IAM_TOKEN": "your-value",
        "YANDEX_WORDSTAT_FOLDER_ID": "your-value",
        "YANDEX_WORDSTAT_TIMEOUT_MS": "your-value",
        "YANDEX_WORDSTAT_MAX_RETRIES": "your-value",
        "YANDEX_WORDSTAT_MAX_RPS": "your-value",
        "YANDEX_WORDSTAT_MAX_RPH": "your-value",
        "YANDEX_WORDSTAT_MAX_CONCURRENCY": "your-value",
        "YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS": "your-value",
        "YANDEX_WORDSTAT_LOG_LEVEL": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add wordstat --env YANDEX_WORDSTAT_API_KEY=your-value --env YANDEX_WORDSTAT_IAM_TOKEN=your-value --env YANDEX_WORDSTAT_FOLDER_ID=your-value --env YANDEX_WORDSTAT_TIMEOUT_MS=your-value --env YANDEX_WORDSTAT_MAX_RETRIES=your-value --env YANDEX_WORDSTAT_MAX_RPS=your-value --env YANDEX_WORDSTAT_MAX_RPH=your-value --env YANDEX_WORDSTAT_MAX_CONCURRENCY=your-value --env YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS=your-value --env YANDEX_WORDSTAT_LOG_LEVEL=your-value -- npx -y wordstat-mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "wordstat": {
      "command": "npx",
      "args": [
        "-y",
        "wordstat-mcp-server"
      ],
      "env": {
        "YANDEX_WORDSTAT_API_KEY": "your-value",
        "YANDEX_WORDSTAT_IAM_TOKEN": "your-value",
        "YANDEX_WORDSTAT_FOLDER_ID": "your-value",
        "YANDEX_WORDSTAT_TIMEOUT_MS": "your-value",
        "YANDEX_WORDSTAT_MAX_RETRIES": "your-value",
        "YANDEX_WORDSTAT_MAX_RPS": "your-value",
        "YANDEX_WORDSTAT_MAX_RPH": "your-value",
        "YANDEX_WORDSTAT_MAX_CONCURRENCY": "your-value",
        "YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS": "your-value",
        "YANDEX_WORDSTAT_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "wordstat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wordstat-mcp-server"
      ],
      "env": {
        "YANDEX_WORDSTAT_API_KEY": "your-value",
        "YANDEX_WORDSTAT_IAM_TOKEN": "your-value",
        "YANDEX_WORDSTAT_FOLDER_ID": "your-value",
        "YANDEX_WORDSTAT_TIMEOUT_MS": "your-value",
        "YANDEX_WORDSTAT_MAX_RETRIES": "your-value",
        "YANDEX_WORDSTAT_MAX_RPS": "your-value",
        "YANDEX_WORDSTAT_MAX_RPH": "your-value",
        "YANDEX_WORDSTAT_MAX_CONCURRENCY": "your-value",
        "YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS": "your-value",
        "YANDEX_WORDSTAT_LOG_LEVEL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

YANDEX_WORDSTAT_API_KEY secret env
Yandex Cloud API key. Set exactly one credential: this or YANDEX_WORDSTAT_IAM_TOKEN.
YANDEX_WORDSTAT_IAM_TOKEN secret env
Yandex Cloud IAM token. Set exactly one credential: this or YANDEX_WORDSTAT_API_KEY.
YANDEX_WORDSTAT_FOLDER_ID env
Folder ID required for user or federated-user IAM tokens.
YANDEX_WORDSTAT_TIMEOUT_MS env
Request timeout in milliseconds (1-300000). Server default: 30000.
YANDEX_WORDSTAT_MAX_RETRIES env
Maximum retries for transient failures (0-10). Server default: 2.
YANDEX_WORDSTAT_MAX_RPS env
Maximum requests started per second (1-10000). Server default: 8.
YANDEX_WORDSTAT_MAX_RPH env
Maximum logical requests per hour (0-1000000); 0 disables this limit. Server default: 100.
YANDEX_WORDSTAT_MAX_CONCURRENCY env
Maximum concurrent requests (1-100). Server default: 4.
YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS env
Regions-tree cache lifetime in milliseconds (0-2592000000). Server default: 86400000.
YANDEX_WORDSTAT_LOG_LEVEL env
Diagnostic log level. Server default: error.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account solaix, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Marketing & social mediai

More stars than 0% of the other 3579 servers in this category
Published to the registry more recently than 82% of the other 3579 servers in this category
Basic checks equal to or better than 100% of the other 3579 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Yandex Wordstat MCP Server safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.1) reached the registry 6 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

MCP YouTube Transcript

by jkawamoto

An MCP server retrieving transcripts of YouTube videos

Runs on your computer★ 495MITUpdated 11 days ago

Install

Google Analytics MCP

by surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Runs on your computer★ 244MITUpdated 10 days ago

Install

BibiGPT YouTube Video Summarizer

by JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

Runs in the cloud★ 137MITUpdated 11 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Yandex Wordstat MCP Server

Неофициальный open-source MCP-сервер, который даёт AI-агентам типизированный read-only доступ ко всем стандартным методам Yandex Wordstat API.

Статус: 0.1.1, исправление совместимости с пропущенными protobuf-default значениями Wordstat API.

English

Возможности

все четыре метода Wordstat API и дополнительный локальный поиск ID региона по названию;
строгие входные и выходные схемы, безопасные авто-диапазоны дат и проверка операторов;
повторы временных ошибок с учётом Retry-After, таймауты и отмена запросов;
локальные лимиты RPS, запросов в час и параллельности;
кэш дерева регионов, дедупликация одновременных запросов и fallback на устаревший кэш;
счётчики API-вызовов, HTTP-попыток и приблизительно тарифицируемых вызовов;
stdio-транспорт без записи логов в протокольный stdout.

Все инструменты помечены как read-only и idempotent. Запросы к Wordstat являются внешними API-вызовами и могут тарифицироваться.

Требования и доступ

Node.js 22.23.4+, 24.22.1+ или 26.12.1+ в соответствующей LTS-линейке;
API-ключ со scope yc.search-api.execute или IAM-токен;
роль search-api.webSearch.user на нужный каталог Yandex Cloud.

Задайте ровно один credential в окружении MCP-клиента:

export YANDEX_WORDSTAT_API_KEY='your-api-key'

или: export YANDEX_WORDSTAT_IAM_TOKEN='your-iam-token'

Не сохраняйте реальные credentials в репозитории или общей MCP-конфигурации. Перезапустите клиент после изменения его окружения.

Когда нужен `YANDEX_WORDSTAT_FOLDER_ID`

Переменная обязательна для IAM-токена аккаунта Яндекса или федеративного аккаунта. Укажите ID каталога, на который назначена роль search-api.webSearch.user:

export YANDEX_WORDSTAT_FOLDER_ID='b1g...'

Для API-ключа или IAM-токена сервисного аккаунта переменную обычно не задают: Search API использует каталог сервисного аккаунта.

Подключение к MCP-клиенту

Выберите один способ авторизации: API-ключ или IAM-токен. Не передавайте оба одновременно. В примерах Codex и Claude Code переменные уже экспортированы в окружение процесса клиента.

Codex CLI / IDE

Добавьте в ~/.codex/config.toml:

[mcp_servers.yandex-wordstat]

command = "npx" args = ["-y", "wordstat-mcp-server@latest"] env_vars = ["YANDEX_WORDSTAT_API_KEY"]

Для IAM-токена аккаунта Яндекса или федеративного аккаунта используйте:

[mcp_servers.yandex-wordstat]

command = "npx" args = ["-y", "wordstat-mcp-server@latest"] env_vars = ["YANDEX_WORDSTAT_IAM_TOKEN", "YANDEX_WORDSTAT_FOLDER_ID"]

Затем проверьте подключение командой codex mcp list. Codex CLI и IDE используют общую конфигурацию.

Claude Code

claude mcp add-json --scope user yandex-wordstat \

'{"command":"npx","args":["-y","wordstat-mcp-server@latest"],"env":{"YANDEX_WORDSTAT_API_KEY":"${YANDEX_WORDSTAT_API_KEY}"}}' claude mcp list

Вариант с IAM-токеном аккаунта Яндекса или федеративного аккаунта:

claude mcp add-json --scope user yandex-wordstat \

'{"command":"npx","args":["-y","wordstat-mcp-server@latest"],"env":{"YANDEX_WORDSTAT_IAM_TOKEN":"${YANDEX_WORDSTAT_IAM_TOKEN}","YANDEX_WORDSTAT_FOLDER_ID":"${YANDEX_WORDSTAT_FOLDER_ID}"}}' claude mcp list

Hermes Agent

Добавьте сервер в пользовательский ~/.hermes/config.yaml:

mcp_servers:

yandex_wordstat: command: "npx" args: ["-y", "wordstat-mcp-server@latest"] env: YANDEX_WORDSTAT_API_KEY: "your-api-key"

Вариант с IAM-токеном аккаунта Яндекса или федеративного аккаунта:

mcp_servers:

yandex_wordstat: command: "npx" args: ["-y", "wordstat-mcp-server@latest"] env: YANDEX_WORDSTAT_IAM_TOKEN: "your-iam-token" YANDEX_WORDSTAT_FOLDER_ID: "your-folder-id"

Hermes передаёт stdio-серверу только явно перечисленные переменные. Не добавляйте пользовательский конфиг с credential в репозиторий.

Проверьте подключение командой hermes mcp test yandex_wordstat, затем перезапустите Hermes или выполните /reload-mcp. Инструменты будут зарегистрированы с префиксом mcp_yandex_wordstat_. Параллельные вызовы по умолчанию выключены, что помогает контролировать квоту.

Инструменты

Инструмент	Назначение	Важные параметры
`wordstat_top_requests`	Популярные и связанные запросы за последние 30 дней	`phrase`, `num_phrases` 1–2000, `region_ids`, `devices`
`wordstat_dynamics`	Дневная, недельная или месячная динамика	`phrase`, `period`, `from_date`, `to_date`, `auto_dates`, фильтры
`wordstat_regions`	Частота, доля и affinity index по регионам за последние 30 дней	`phrase`, `region_type`, `limit`, `offset`, `resolve_names`
`wordstat_regions_tree`	Иерархия поддерживаемых регионов	`max_depth` 1–20, `root_region_id`
`wordstat_find_regions`	Локальный поиск ID региона по названию	`query`, `limit`, `parent_region_id`, `include_children`

Значения devices: all, desktop, phone, tablet; all нельзя сочетать с другими значениями. В одном запросе допускается до 100 region_ids.

wordstat_find_regions работает по кэшированному дереву. Он полезен, когда агент знает название региона, но не его ID. wordstat_regions при resolve_names: true делает дополнительный бесплатный вызов дерева только при промахе кэша. Каждая следующая страница wordstat_regions заново вызывает платный метод распределения по регионам, поэтому для полной выборки лучше использовать максимальный limit.

Даты и операторы

wordstat_dynamics принимает даты в формате YYYY-MM-DD. Если при auto_dates: true обе даты отсутствуют, сервер запрашивает последние 60 завершённых дней, 52 завершённые недели или 12 завершённых месяцев — в зависимости от детализации. Если отсутствует только одна граница, сервер вычисляет её; автоматически добавленный to_date всегда указывает на последний завершённый период. Явно переданные границы не сдвигаются. При auto_dates: false обязателен только from_date; to_date можно не задавать.

Дневной диапазон не может превышать 60 дней. Для недельной и месячной детализации Wordstat документирует диапазон от 3 недель или месяцев до 5 лет; самая ранняя доступная история начинается с января 2018 года. Неделя задаётся от понедельника до воскресенья, месяц — от первого до последнего дня месяца.

Live-проверки показали наблюдаемое, но не документированное поведение: последние календарные точки могут быть ещё не опубликованы, API возвращает только доступную часть пересекающегося диапазона, а диапазон целиком после последней опубликованной точки может получить HTTP 400. Поскольку HTTP 400 может иметь и другие причины, проверьте все параметры запроса; для недавнего диапазона попробуйте более ранние даты. Сервер не сдвигает явно заданный диапазон и не делает дополнительный платный запрос автоматически.

Для дневной динамики разрешены операторы -, !, +, кавычки, [], () и |; для недельной и месячной — только +. Явные неподдерживаемые операторы для недельной и месячной детализации отклоняются до платного API-вызова.

Метаданные результата

Каждый успешный ответ содержит:

api_calls — логические вызовы Wordstat API, включая бесплатное дерево регионов;
http_attempts — все HTTP-попытки, в том числе повторы;
billable_calls_estimate — оценка платных вызовов; финальный биллинг определяет Yandex;
local_hourly_budget_remaining — остаток локального часового лимита или null;
content_truncated — был ли сокращён текстовый MCP-контент из-за размера.

Поля count и total_count возвращаются строками, чтобы не терять точность 64-битных целых.

Примеры запросов агенту

Расширение семантики

Подбери запросы по теме «онлайн-курсы английского». Покажи 100 популярных запросов

и похожие запросы за последний месяц. Сгруппируй их по смыслу: обучение, цена, формат, уровень и бренды. В каждой группе выдели 5 самых популярных фраз. Популярные и похожие запросы покажи отдельно.

Сравнение регионального спроса

Сравни спрос на «доставка цветов» в Москве и Санкт-Петербурге за последние 12 полных

месяцев. Найди нужные регионы сам. Покажи динамику по месяцам для каждого города, отметь месяцы с самым высоким и низким спросом и объясни различия в сезонности. Если каких-то данных нет, не додумывай их.

Интерес по регионам

Покажи, в каких регионах запросом «горнолыжный курорт» интересуются сильнее всего.

Составь два списка: топ-15 регионов по индексу интереса и топ-15 по числу запросов. Для каждого региона укажи число запросов, долю и индекс интереса. Коротко объясни, почему списки отличаются. Загружай дополнительные страницы только при необходимости.

Сезонность и сравнение с прошлым годом

Проанализируй спрос на «кондиционер» по России за последние 24 полных календарных месяца,

не включая текущий месяц. Используй регион «Россия» с ID 225 и обязательно задай начало и конец периода. Сравни каждый месяц с тем же месяцем годом ранее. Покажи изменение в запросах и процентах, а также начало и пик сезона. Если данных не хватает, перечисли пропущенные месяцы и сравни только полные пары. Если год назад было ноль запросов, процентное изменение не рассчитывай.

Различия по устройствам

Сравни спрос на «заказать продукты» с компьютеров, телефонов и планшетов за последние

60 полных дней. Для каждого типа устройства покажи общее число запросов, среднее за день и его долю среди трёх типов устройств. Сравнивай только даты, которые есть во всех выборках. Не называй число запросов количеством уникальных пользователей.

Влияние операторов Wordstat

Покажи, как кавычки влияют на статистику запроса «ремонт квартир». Сравни за последние

60 полных дней обычный запрос ремонт квартир и запрос в кавычках "ремонт квартир". Покажи общую частотность каждого варианта, разницу между ними и простыми словами объясни, что ограничивают кавычки в Wordstat.

Контроль стоимости исследования

Нужно изучить запрос «ипотека»: популярные и похожие запросы, динамику по месяцам

и интерес по регионам. Сначала скажи, сколько платных обращений к Wordstat потребуется, и дождись моего подтверждения. После исследования покажи фактическое число обращений и отдельно отметь повторные попытки, если они были.

Конфигурация

Переменная	По умолчанию	Допустимые значения
`YANDEX_WORDSTAT_API_KEY`	—	Ровно один из двух credentials
`YANDEX_WORDSTAT_IAM_TOKEN`	—	Ровно один из двух credentials
`YANDEX_WORDSTAT_FOLDER_ID`	—	До 50 символов; см. условия выше
`YANDEX_WORDSTAT_TIMEOUT_MS`	`30000`	`1`–`300000`
`YANDEX_WORDSTAT_MAX_RETRIES`	`2`	`0`–`10`
`YANDEX_WORDSTAT_MAX_RPS`	`8`	`1`–`10000`
`YANDEX_WORDSTAT_MAX_RPH`	`100`	`0`–`1000000`; `0` отключает лимит
`YANDEX_WORDSTAT_MAX_CONCURRENCY`	`4`	`1`–`100`
`YANDEX_WORDSTAT_REGIONS_CACHE_TTL_MS`	`86400000`	`0`–`2592000000`
`YANDEX_WORDSTAT_LOG_LEVEL`

Only the beginning is shown; read the rest in the repo

Yandex Wordstat MCP Server

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Marketing & social mediai

Common questions

Alternatives

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

README from the maker

Yandex Wordstat MCP Server

Возможности

Требования и доступ

или: export YANDEX_WORDSTAT_IAM_TOKEN='your-iam-token'

Когда нужен YANDEX_WORDSTAT_FOLDER_ID

Подключение к MCP-клиенту

Codex CLI / IDE

Claude Code

Hermes Agent

Инструменты

Даты и операторы

Метаданные результата

Примеры запросов агенту

Расширение семантики

Сравнение регионального спроса

Интерес по регионам

Сезонность и сравнение с прошлым годом

Различия по устройствам

Влияние операторов Wordstat

Контроль стоимости исследования

Конфигурация

Когда нужен `YANDEX_WORDSTAT_FOLDER_ID`