通过智谱 Web Search API 进行网页检索
npm install cc-zhipu-web-search
一个通过智谱 AI 开放平台（BigModel）的 Web Search API 提供网页搜索能力的命令行工具，并符合 Model-Code-Protocol (MCP) 规范。
这允许任何支持 MCP 的客户端（例如 AI 智能体）调用此工具来获得网页搜索的能力。
* 调用智谱搜索 API：将参数转换并调用智谱 Web Search API。
* 结果格式化：将返回的 JSON 结果格式化为对人类或模型易读的文本格式。
* MCP 服务：作为一个 MCP 服务器运行，可以通过标准输入/输出（STDIO）与客户端通信。
在使用前，你需要一个智谱 AI 的 API Key。你可以在 智谱 AI 开放平台 上获取。
对于支持 MCP 的客户端可使用 npx 直接运行，无需全局安装。客户端会根据需要自动拉取并执行包。
1. 找到你客户端的 mcp.json 配置文件（对于 Cursor，通常是 ~/.cursor/mcp.json）。
2. 在该文件的 mcpServers 对象中，添加以下条目：
``json`
{
"mcpServers": {
"zhipu-web-search": {
"command": "npx",
"args": [
"cc-zhipu-web-search"
],
"env": {
"BIGMODEL_API_KEY": "YOUR_BIGMODEL_API_KEY"
}
}
}
}
如果你已经有其他服务器，只需在 中添加 "zhipu-web-search": { ... } 即可。
本工具提供了一个名为 web-search 的工具，可供 MCP 客户端调用。
工具描述: 使用智谱 Web Search API 进行网页检索
参数:
| 参数名 | 类型 | 描述 | 默认值 |
| ----------------------- | -------- | ------------------------------------------- | ------------ |
| query | string | 搜索关键词，≤70字符 | 必需 |search_engine
| | enum | 要调用的搜索引擎编码。 | search_std |count
| | number | 返回条数 1~50 | 10 |search_domain_filter
| | string | 限定搜索结果的域名 (例如 'www.example.com') | (可选) |search_recency_filter
| | enum | 搜索指定时间范围内的网页。 | noLimit |content_size
| | enum | 控制网页摘要的字数。 | medium` |