Yandex Wordstat MCP は、AIアプリケーションをYandexの検索需要統計に接続します。フレーズがどのくらい検索されているか、どの月に興味が高まるか、どの都市でテーマが人気かを尋ねると、アシスタントがWordstatのデータを収集して結果を説明します。このサーバーはYandex Cloud Search APIを通じて動作するため、ディレクトの広告アカウントへのアクセスは不要です。
5つのツール。 トップおよび類似クエリ、需要の推移、地域別分布、地域ディレクトリ、APIへの技術リクエスト。
読み取り専用。 Wordstat APIはキャンペーン、広告、キーフレーズなどのオブジェクトを作成しません。
需要と季節性。 トップクエリと地域は直近30日間を表示します。推移は日次、週次、月次のいずれかで任意の期間にわたって構築されます。
地域とデバイス。 レポートを地域に絞り込み、パソコン、スマートフォン、タブレットの需要を比較できます。
ディレクトのOAuthは不要。 Search APIにはYandex CloudのAPIキーとカタログIDが必要です。
安全なリクエストから始めましょう：
「自転車を買う」は月にどのくらい検索され、類似クエリにはどのようなものがありますか？
サーバーを接続する · シナリオを見る · 技術ドキュメントを開く
Related MCP server: yandex-searchapi-mcp
必要なもの：Node.js 20以上、Search API用のYandex Cloud APIキー、Yandex CloudカタログID。
アクセスを取得し、AIアプリケーションにサーバーを追加します — 以下の5つのアプリケーションの手順を参照してください。
「「自転車を買う」は月にどのくらい検索され、類似クエリにはどのようなものがありますか？」と尋ねます。
アプリケーションのインターフェースから：
Settings → Plugins → MCP servers を開きます。
Add server をクリックします。
起動コマンド npx -y mcp-yandex-wordstat@latest と環境変数 WORDSTAT_API_KEY、WORDSTAT_FOLDER_ID を追加します。
コマンドラインから：
codex mcp add yandex-wordstat \
--env WORDSTAT_API_KEY=ваш_ключ \
--env WORDSTAT_FOLDER_ID=ваш_folder_id \
-- npx -y mcp-yandex-wordstat@latest接続を確認します：
codex mcp listclaude mcp add \
--env WORDSTAT_API_KEY=ваш_ключ \
--env WORDSTAT_FOLDER_ID=ваш_folder_id \
--transport stdio \
--scope user \
yandex-wordstat \
-- npx -y mcp-yandex-wordstat@latestサーバーを確認します：
claude mcp listSettings → Developer → Edit Config を開き、claude_desktop_config.json にサーバーを追加します：
{
"mcpServers": {
"yandex-wordstat": {
"command": "npx",
"args": ["-y", "mcp-yandex-wordstat@latest"],
"env": {
"WORDSTAT_API_KEY": "ваш_ключ",
"WORDSTAT_FOLDER_ID": "ваш_folder_id"
}
}
}
}Edit Config が利用できない場合は、macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json を編集します。
すべてのプロジェクトには ~/.cursor/mcp.json を作成します。現在のプロジェクトのみの場合は .cursor/mcp.json を作成します：
{
"mcpServers": {
"yandex-wordstat": {
"command": "npx",
"args": ["-y", "mcp-yandex-wordstat@latest"],
"env": {
"WORDSTAT_API_KEY": "ваш_ключ",
"WORDSTAT_FOLDER_ID": "ваш_folder_id"
}
}
}
}コマンドパレットを開き、MCP: Open User Configuration を実行します。mcp.json に追加します：
{
"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": "API-ключ Yandex Cloud",
"password": true
},
{
"type": "promptString",
"id": "wordstat_folder_id",
"description": "ID каталога Yandex Cloud"
}
]
}MCP: List Servers コマンドで起動を確認します。
「このフレーズは月に何回検索され、類似クエリにはどのようなものがありますか？」
「「ピザ配達」に関連するクエリを頻度付きで選んでください。」
「私のフレーズを含むクエリと、意味的に類似したクエリを分けて表示してください。」
「「スキー」の需要を1年分、月別に表示してください。」
「このサービスの需要はどの週に増減しますか？」
「スマートフォンとパソコンでのクエリの推移を比較してください。」
「「マンションリフォーム」への関心が平均より高い都市はどこですか？」
「モスクワとサンクトペテルブルクの需要を比較してください。」
「必要な地域のIDを見つけて、次のレポートをその地域に絞り込んでください。」
top_requests は、指定したフレーズを含む人気クエリと、意味的に近いクエリを表示します。全体の totalCount は直近30日間を対象としています。
dynamics は、日次、週次、月次の粒度で {date, count, share} の系列を返します。regions は直近30日間の需要を地域別に分配し、affinityIndex が100%を超えると平均以上の関心を意味します。カウンターの値は文字列で返されることがあります。Yandexは大きな整数をJSONでこの形式で送信するためです。
1回の呼び出しで構築されるデータは1つのフレーズのみです。キーワードのリストが大きい場合は、すべてのクエリを連続して実行するのではなく、まずリストを絞り込むことをお勧めします。Yandex Cloud Search APIの割り当ては1つのキーで共有されるためです。
Yandex Cloudで、search-api.webSearch.user ロールを持つサービスアカウントを作成します。
そのアカウントに対して、スコープ yc.search-api.execute のAPIキーを発行します — 手順は AI Studioドキュメント に記載されています。
Yandex Cloudコンソール のカタログページとページURLでカタログID（folderId）を確認します。
キーを WORDSTAT_API_KEY として、カタログを WORDSTAT_FOLDER_ID として渡します。
サーバーはYandex Cloud Search API v2にアクセスします。OAuthを使用する旧来の独立したWordstat APIは使用されません。APIキーはMCPクライアントの設定に平文で保存されるため、パスワードと同様に扱ってください。
Yandex Wordstatでは何も変更できません。raw_request を含む5つのツールはすべて読み取り専用で動作します。技術的にはAPIは POST を使用しますが、Wordstatには書き込み用のエンドポイントはありません。また、サーバーは任意のリクエストが別のホストに送信されることを追加で防ぎます。
集計データ。 サーバーは特定の広告アカウントのデータではなく、検索需要の統計を取得します。
地域ディレクトリのキャッシュ。 長時間稼働するプロセスでは、地域ツリーは一度だけ読み込まれ、以降のリクエストで再利用されます。
一時的なエラー時の再試行。 1回のリクエストのタイムアウトは60秒です。サーバーは 429、5xx、ネットワークエラー、タイムアウトの後に最大3回再試行します。Retry-After を考慮し、遅延は30秒を超えません。
バックグラウンド監視なし。 サーバーはAIアプリケーションが呼び出したときに動作します。アプリケーションがスケジュールジョブをサポートしている場合は、選択したフレーズの定期レポートを設定できます。
匿名テレメトリ。 デフォルトで、サーバーはランダムなインストールID、イベント名またはツール名、サーバー、Node.js、OS、AIクライアントのバージョンを送信します。APIキー、ツールの引数、メッセージ、需要データ、環境変数の値は含まれません。Ask AdsのMCPサーバーで無効にするには：ASKADS_TELEMETRY=0。
MCP機能カタログ — 各ツールのユーザータスク別ページ。
MCP for Yandex Direct: manage ad campaigns & analytics from Claude or ChatGPT
Read-only Yandex Metrika MCP. Query visits, sources, geo, devices and more in plain language.
SEO research, audits, backlinks, GSC, and content workflow tools for AI agents.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/askads/mcp-yandex-wordstat'
If you have feedback or need assistance with the MCP directory API, please join our Discord server