Yandex Search MCP

io.github.stufently由 GitHub 帳號 stufently 發布v2.2.1更新於 Oct 24, 2026

MCP server for Yandex Search API (v2, Cloud)

已驗證STDIO僅桌面網頁搜尋與抓取

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理透過 Yandex Search API v2 進行網頁搜尋，並取得結構化的排序結果。

可以做什麼
  • 以查詢字串搜尋網頁，可指定結果數量（1-100）、地區 ID、頁碼與安全搜尋模式。
  • 讀取結構化結果：排名位置、URL、網域、標題、摘要、相關段落、片段、大小、語言與快取連結。
  • 自動選擇索引：含西里爾字母的查詢使用俄語索引，純拉丁字母查詢使用國際索引。
  • 遇到限流與伺服器錯誤時以指數退避自動重試。
適用情境
適合需要 Yandex 網頁搜尋結果的情境，尤其是俄語或特定地區的查詢，且你已有 Yandex Cloud 帳號。
執行需求
以本機 Node.js 程序執行（套件 @stufently/yandex-search-mcp；README 說明需複製儲存庫並以 bun install 從原始碼執行）。需要 Yandex Cloud API 金鑰（YANDEX_SEARCH_API_KEY）與資料夾 ID（YANDEX_FOLDER_ID），服務帳號需具備 search-api.webSearch.user 角色。需能連線至 Yandex Cloud 搜尋端點。
安裝前請注意
需要 Yandex Cloud API 金鑰（YANDEX_SEARCH_API_KEY），透過用戶端設定的環境變數傳入，請勿放入共用設定。搜尋查詢與結果會傳送至 Yandex Cloud。README 提醒未加範圍的 npm 名稱 yandex-search-mcp 屬於無關的發佈者，只應安裝帶範圍的套件。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Yandex Search MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

yandex-search-mcp

MCP server for Yandex Search API v2 (Cloud). Search the web through Yandex and get structured results with titles, snippets, URLs, and metadata.

Installation

This package is published as @stufently/yandex-search-mcp; the unscoped name yandex-search-mcp belongs to an unrelated publisher (see the note in the root README). Nothing is on the scope yet, so run it from source:

bash
git clone https://github.com/stufently/yandex-mcp.gitcd yandex-mcp && bun installnode packages/yandex-search-mcp/src/index.mjs

Configuration

Add to your MCP client config:

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

Environment Variables

VariableRequiredDescription
YANDEX_SEARCH_API_KEYYesAPI key from Yandex Cloud Console
YANDEX_FOLDER_IDYesFolder ID from Yandex Cloud

No OAuth flow is needed. Get both values from the Yandex Cloud Console.

Tool Reference

search

Search the web using Yandex Search API. Returns ranked results with titles, snippets, and URLs.

Parameters:

ParameterTypeRequiredDefaultDescription
querystringYes--Search query text
maxResultsnumberNo10Maximum results to return (1-100)
regionnumberNo--Yandex region ID
pagenumberNo0Page number (0-based)
familyModeenumNoFAMILY_MODE_MODERATESafe search: FAMILY_MODE_NONE, FAMILY_MODE_MODERATE, FAMILY_MODE_STRICT

Response fields:

Each result contains:

FieldTypeDescription
positionnumberRanking position (1-based)
urlstringResult URL
domainstringHostname extracted from URL
titlestringPage title
headlinestringMeta description
passagesstring[]Relevant text passages
snippetstringCombined headline and passages
sizenumberDocument size in bytes
langstringDocument language
cachedUrlstringYandex cached copy URL

Language detection:

The search type and localization are automatically selected based on the query. Queries containing Cyrillic characters use the Russian search index; Latin-only queries use the international index.

API Details

  • Endpoint: POST https://searchapi.api.cloud.yandex.net/v2/web/search
  • Auth: Api-Key header
  • Response: JSON with base64-encoded XML in rawData field
  • Automatic retry with exponential backoff on 429/5xx errors

License

MIT

來源：packages/yandex-search-mcp/README.md，提交 bdd6c64

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

2
  1. v2.2.1最新Oct 16, 2026
  2. v2.2.0Oct 15, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分