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の3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: マーケティング・SNS
入力が必要なもの：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

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.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月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント solaix で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

マーケティング・SNSのほかのサーバーとの比較i

このカテゴリのほかの3560件のうち0%よりスターが多い
このカテゴリのほかの3560件のうち83%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの3560件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Yandex Wordstat MCP Serverは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：YANDEX_WORDSTAT_API_KEY, YANDEX_WORDSTAT_IAM_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.1.1）がレジストリに届いたのは6 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

MCP YouTube Transcript

作者：jkawamoto

An MCP server retrieving transcripts of YouTube videos

パソコンで動く★ 495MIT10 日前更新

インストール

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.

クラウドで動く★ 137MIT10 日前更新

インストール

作者の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の3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

マーケティング・SNSのほかのサーバーとの比較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`