Yandex Search MCP

yandex-search-mcp

Yandex Search API v2（Cloud）用の MCP サーバーです。Yandex でウェブを検索し、タイトル、スニペット、URL、メタデータを含む構造化された結果を取得します。

インストール

このパッケージは @stufently/yandex-search-mcp として公開されています。スコープなしの名前 yandex-search-mcp は無関係な公開者が所有しています（ルートの README の注記を参照してください）。 スコープにはまだ何も公開されていないため、ソースから実行してください。

git clone https://github.com/stufently/yandex-mcp.git
cd yandex-mcp && bun install
node packages/yandex-search-mcp/src/index.mjs

設定

MCP クライアントの設定に追加してください。

{
  "mcpServers": {
    "yandex-search": {
      "command": "node",
      "args": ["/path/to/yandex-mcp/packages/yandex-search-mcp/src/index.mjs"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your-api-key",
        "YANDEX_FOLDER_ID": "your-folder-id"
      }
    }
  }
}

環境変数

変数	必須	説明
YANDEX_SEARCH_API_KEY	はい	Yandex Cloud Console の API キー
YANDEX_FOLDER_ID	はい	Yandex Cloud のフォルダー ID

OAuth フローは不要です。Yandex Cloud Console から両方の値を取得してください。

ツールリファレンス

search

Yandex Search API を使用してウェブを検索します。タイトル、スニペット、URLを含む、ランク付けされた結果を返します。

パラメーター：

パラメーター	型	必須	デフォルト	説明
query	string	はい	--	検索クエリーのテキスト
maxResults	number	いいえ	10	返す結果の最大数（1～100）
region	number	いいえ	--	Yandex の地域 ID
page	number	いいえ	0	ページ番号（0 始まり）
familyMode	enum	いいえ	FAMILY_MODE_MODERATE	セーフサーチ：FAMILY_MODE_NONE、FAMILY_MODE_MODERATE、FAMILY_MODE_STRICT

レスポンスフィールド：

各結果には次の項目が含まれます。

フィールド	型	説明
position	number	順位（1 始まり）
url	string	結果の URL
domain	string	URL から抽出されたホスト名
title	string	ページタイトル
headline	string	メタディスクリプション
passages	string[]	関連するテキストの抜粋
snippet	string	headline と passages を結合したもの
size	number	ドキュメントのサイズ（バイト）
lang	string	ドキュメントの言語
cachedUrl	string	Yandex のキャッシュコピー URL

言語の検出：

検索の種類と言語設定は、クエリーに基づいて自動的に選択されます。キリル文字を含むクエリーではロシア語の検索インデックスが使用され、ラテン文字のみのクエリーでは国際インデックスが使用されます。

API の詳細

• エンドポイント：POST https://searchapi.api.cloud.yandex.net/v2/web/search
• 認証：Api-Key ヘッダー
• レスポンス：rawData フィールドに Base64 エンコードされた XML を含む JSON
• 429／5xx エラー時は指数バックオフで自動的に再試行します

ライセンス

MIT