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	合并后的标题和段落
size	number	文档大小（字节）
lang	string	文档语言
cachedUrl	string	Yandex 缓存副本 URL

语言检测：

搜索类型和本地化设置会根据查询自动选择。包含西里尔字母的查询使用俄语搜索索引；仅包含拉丁字母的查询使用国际索引。

API 详情

• 端点：POST https://searchapi.api.cloud.yandex.net/v2/web/search
• 身份验证：Api-Key 标头
• 响应：JSON，其中 rawData 字段包含经 base64 编码的 XML
• 遇到 429/5xx 错误时，自动采用指数退避策略重试

许可证

MIT