Yandex Wordstat MCP Server

Name: Yandex Wordstat MCP Server
Author: solaix

作者：solaix版本 0.1.1i★ –i在你的电脑上运行

注册名称io.github.solaix/wordstat-mcp-server

安装

概览

作者提供的说明（英文原文）

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

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 营销与社交媒体
你需要填写：YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： 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

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

npm已安装 Node.js（用于 npx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 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"
      }
    }
  }
}

在终端中运行这条命令

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

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.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"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "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"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

YANDEX_WORDSTAT_API_KEY 机密 env
Yandex Cloud API key. Set exactly one credential: this or YANDEX_WORDSTAT_IAM_TOKEN.
YANDEX_WORDSTAT_IAM_TOKEN 机密 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.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 solaix 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“营销与社交媒体”中的其他服务器比较i

星标数多于此分类中其他 3583 个服务器的 0%
发布到注册中心的时间比此分类中其他 3583 个服务器的 82% 更新
基础检查结果等于或优于此分类中其他 3583 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Yandex Wordstat MCP Server 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.1）于6天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它？

同一分类中有：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

MCP YouTube Transcript

作者：jkawamoto

An MCP server retrieving transcripts of YouTube videos

在你的电脑上运行★ 495MIT11天前更新

安装

Google Analytics MCP

作者：surendranb

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

在你的电脑上运行★ 244MIT10天前更新

安装

BibiGPT YouTube Video Summarizer

作者：JimmyLv

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

在云端运行★ 137MIT11天前更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

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`

只显示了开头部分；其余内容请在仓库中阅读

Yandex Wordstat MCP Server

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

需要你填写的值

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“营销与社交媒体”中的其他服务器比较i

常见问题

替代选择

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

作者的 README

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`