{"_id":"@yyaylt/zhipu-web-search-mcp-server","_rev":"7-c4f87a80703c65cb6b9a4883365b460d","name":"@yyaylt/zhipu-web-search-mcp-server","dist-tags":{"latest":"1.0.8"},"versions":{"1.0.1":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.1","keywords":["zhipu","web-search","mcp-server"],"author":{"name":"lost_fish"},"license":"Apache-2.0","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.1","maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"dist":{"shasum":"bc9df0d6f2cfbed3239a3cae613414de40849e32","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.1.tgz","fileCount":28,"integrity":"sha512-lc1wEqp0+Br1XCCaTMaOWppzqEn6Wq9itwAfXIE6FjtAVr3Xzngn00SW2Fb/4YmO5lh0Qkvrp9N4genD2KKa/w==","signatures":[{"sig":"MEYCIQDwJDCucHLowgFgdBccWfYtGjieBv0pxMvr4YfYdyO85AIhAKxLzs4Tz0koBYGkeLJy8Sm2W0zgHUnychP9Yqgh4UWP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59851},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"9bd51b97b049f65000e0bacdaf04f7ecaea3eedf","scripts":{"dev":"tsx watch src/index.ts","test":"node --test --import tsx \"tests/**/*.test.ts\"","build":"tsc","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"repository":{"url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git","type":"git"},"_npmVersion":"11.19.0","description":"MCP server for ZHIPU AI Web Search API integration","directories":{"doc":"docs"},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/zhipu-web-search-mcp-server_1.0.1_1787213167089_0.7960081205265881","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.2","keywords":["zhipu","web-search","mcp-server"],"author":{"name":"lost_fish"},"license":"Apache-2.0","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.2","maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"dist":{"shasum":"bbd7be8699e448396e6f75718ba4fce662a50e40","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.2.tgz","fileCount":28,"integrity":"sha512-SPdT5+ZWp6ksD5lxGXr78sw3f9gtWv3WQ2AH7zx0UIl8H5zPvSeKKxCTRmj3qnjJKI43PHW+PUaF2VD5KwoQ8Q==","signatures":[{"sig":"MEQCIG12zm9ubTB7vOh/ib8gEhWvVt8iPfQmz3+S/vbkY6iLAiAttxzUryLYs6OUVqxxku/yXNQVGI5ItKtdj+rX24bbyA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62703},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"726f121fc61696a35a190978ed7a704646807b9e","scripts":{"dev":"tsx watch src/index.ts","test":"node --test --import tsx \"tests/**/*.test.ts\"","build":"tsc","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"repository":{"url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git","type":"git"},"_npmVersion":"11.19.0","description":"MCP server for ZHIPU AI Web Search API integration","directories":{"doc":"docs"},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/zhipu-web-search-mcp-server_1.0.2_1787221771617_0.5853055393676283","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.4","keywords":["zhipu","web-search","mcp-server"],"author":{"url":"https://gitee.com/yyaylt","name":"lost_fish"},"license":"MIT","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.4","maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"contributors":[{"url":"https://gitee.com/yyaylt","name":"lost_fish"}],"dist":{"shasum":"ec9f3a99a70588324cc7fba2f83e5ecf28a1cee5","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.4.tgz","fileCount":29,"integrity":"sha512-Yar7K2lrjoZt6eUc6iXcs00mPfIKDIpZhHutU3Exa+3PV0kpHNQZAv4NenkMWBBq4WCH9xshApU28OTo1QpA5A==","signatures":[{"sig":"MEQCICd3e7Mt4S3vjZnwf0aal/pTglP6M3NblZOFvhCP89bOAiBscOS1VISNGujejnjU/SPo8lD6UBYznu/uafN6I+im1Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55054},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"9bb30fcaee07735ad1101e77cc9b461a87747a8e","scripts":{"dev":"tsx watch src/index.ts","test":"node --test --import tsx \"tests/**/*.test.ts\"","build":"tsc","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"repository":{"url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git","type":"git"},"_npmVersion":"11.19.0","description":"MCP server for ZHIPU AI Web Search API integration","directories":{"doc":"docs"},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/zhipu-web-search-mcp-server_1.0.4_1787275680514_0.27572079630027746","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.5","keywords":["zhipu","web-search","mcp-server"],"author":{"url":"https://gitee.com/yyaylt","name":"lost_fish"},"license":"MIT","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.5","maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"contributors":[{"url":"https://gitee.com/yyaylt","name":"lost_fish"}],"dist":{"shasum":"1a81d24bfe503699c91cae9001f7395bf0cecc9d","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.5.tgz","fileCount":29,"integrity":"sha512-wJ/rQhFpp+no1BDg3FdmgP2s2edwKd4w+Pxq7fMuourQo+Qs0m+yawrZui7r0ITl5vFkWgnci9jUb2mRn48isA==","signatures":[{"sig":"MEUCIC+PqZi6kH7OKEB/S64HGqaK9CTbQALzP/oC+i2ymMHbAiEA75avkCH62ZIao3u45km6TozfUS5czuq22iHUHCX7/dA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65583},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"9bb30fcaee07735ad1101e77cc9b461a87747a8e","scripts":{"dev":"tsx watch src/index.ts","test":"node --test --import tsx \"tests/**/*.test.ts\"","build":"tsc","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"repository":{"url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git","type":"git"},"_npmVersion":"11.19.1","description":"MCP server for ZHIPU AI Web Search API integration","directories":{"doc":"docs"},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/zhipu-web-search-mcp-server_1.0.5_1788610172941_0.15724770922457165","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.6","keywords":["zhipu","web-search","mcp-server"],"author":{"url":"https://gitee.com/yyaylt","name":"lost_fish"},"license":"MIT","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.6","maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"contributors":[{"url":"https://gitee.com/yyaylt","name":"lost_fish"}],"bin":{"zhipu-web-search-mcp-server":"dist/index.js"},"dist":{"shasum":"3edb0ed0075fc51b9bd08da7366349874ddfe448","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.6.tgz","fileCount":44,"integrity":"sha512-GC5TjgbRoPjnZ71GnONStwPGV8zCAZ3IuQR5RVutn+WFeSANgpm0LnhlF+gyjnwZqHfpPdgMILns8JbG++YjiA==","signatures":[{"sig":"MEUCICxUDuZJVW5RjhegP3cdloOHIkYefdWBGsAJQjo84f9tAiEA+HbhjLaEmXXvoKO/7Y9O1DBLyZPf7STZCQy0V8+Yuto=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92124},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"a1e6a28ae1f3226f03bbffc7763b66da869f53e3","scripts":{"dev":"tsx watch src/index.ts","test":"node --test --import tsx \"tests/**/*.test.ts\"","build":"tsc","clean":"rimraf dist","start":"node dist/index.js","prepack":"npm run build","pretest":"npm run build","typecheck":"tsc --noEmit && tsc -p tsconfig.test.json","test:package":"node tests/package-smoke.mjs","pretest:package":"npm run build"},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"repository":{"url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git","type":"git"},"_npmVersion":"11.19.1","description":"MCP server for ZHIPU AI Web Search API integration","directories":{"doc":"docs"},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/zhipu-web-search-mcp-server_1.0.6_1788699454794_0.2801121366277868","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.7","keywords":["zhipu","web-search","mcp-server"],"author":{"url":"https://gitee.com/yyaylt","name":"lost_fish"},"license":"MIT","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.7","maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"contributors":[{"url":"https://gitee.com/yyaylt","name":"lost_fish"}],"bin":{"zhipu-web-search-mcp-server":"dist/index.js"},"dist":{"shasum":"3bf118d9e4781dc53960a411f55b0320923a3539","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.7.tgz","fileCount":49,"integrity":"sha512-22K1tbIlTKzZPWhAIROqHgE+AXDXbbOZQGFaWhIaW/aLoIA+hlf+E3/HGFCqueoTxHwUiTdLPu5U0aMOfFBB2g==","signatures":[{"sig":"MEUCIQCWh7oBs/4wm93BuCa6A24a4o1ZI80Fsul163CpPkwPKgIgeOGyNaM+9wV+WcXLukD+S/kEh20ARlPZGuOguFML94A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":101760},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"ceec9e556730e7a880ae4a227c64e2da0531687b","scripts":{"dev":"tsx watch src/index.ts","test":"node --test --import tsx \"tests/**/*.test.ts\"","build":"tsc","clean":"rimraf dist","start":"node dist/index.js","prepack":"npm run build","pretest":"npm run build","typecheck":"tsc --noEmit && tsc -p tsconfig.test.json","test:package":"node tests/package-smoke.mjs","pretest:package":"npm run build"},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"repository":{"url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git","type":"git"},"_npmVersion":"11.19.1","description":"MCP server for ZHIPU AI Web Search API integration","directories":{"doc":"docs"},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.24.1","axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","rimraf":"^6.0.1","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/zhipu-web-search-mcp-server_1.0.7_1788703361752_0.7554596828968201","host":"s3://npm-registry-packages-npm-production"}},"1.0.8":{"name":"@yyaylt/zhipu-web-search-mcp-server","version":"1.0.8","description":"MCP server for ZHIPU AI Web Search API integration","keywords":["zhipu","web-search","mcp-server"],"repository":{"type":"git","url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git"},"license":"MIT","author":{"name":"lost_fish","url":"https://gitee.com/yyaylt"},"contributors":[{"name":"lost_fish","url":"https://gitee.com/yyaylt"}],"type":"module","main":"dist/index.js","bin":{"zhipu-web-search-mcp-server":"dist/index.js"},"types":"./dist/index.d.ts","directories":{"doc":"docs"},"scripts":{"start":"node dist/index.js","dev":"tsx watch src/index.ts","build":"tsc","prepack":"npm run build","clean":"rimraf dist","pretest":"npm run build","typecheck":"tsc --noEmit && tsc -p tsconfig.test.json","pretest:package":"npm run build","test:package":"node tests/package-smoke.mjs","test":"node --test --import tsx \"tests/**/*.test.ts\""},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","axios":"^1.7.9","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.10.0","rimraf":"^6.0.1","tsx":"^4.19.2","typescript":"^5.7.2"},"engines":{"node":">=18"},"gitHead":"ceec9e556730e7a880ae4a227c64e2da0531687b","_id":"@yyaylt/zhipu-web-search-mcp-server@1.0.8","_nodeVersion":"24.10.0","_npmVersion":"11.19.1","dist":{"integrity":"sha512-lzjn3gNurcgVjAJvLwI8Nq1Hqz+pX+3JBsQtj8+N/cVY+FUS21r/9B0sp9qxX1DBtfOtbn9o0rmENwN0xbhpgA==","shasum":"70a12d48b4f390672aba122e8b60538fee8188d4","tarball":"https://registry.npmjs.org/@yyaylt/zhipu-web-search-mcp-server/-/zhipu-web-search-mcp-server-1.0.8.tgz","fileCount":44,"unpackedSize":92591,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAvsMnGKdiY2sqMZNhlwqPERhk+ox+PQgJ4X2+veHGBIAiEA6RGQ931fmugxSZu7dyKBwLaIHlJ3kJZ2iGXqerJ9cdQ="}]},"_npmUser":{"name":"yyaylt","email":"yyaylt@foxmail.com"},"maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zhipu-web-search-mcp-server_1.0.8_1788705689246_0.4606484882968942"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-20T08:06:06.844Z","modified":"2026-09-06T14:41:29.489Z","1.0.1":"2026-08-20T08:06:07.250Z","1.0.2":"2026-08-20T10:29:31.759Z","1.0.4":"2026-08-21T01:28:00.638Z","1.0.5":"2026-09-05T12:09:33.068Z","1.0.6":"2026-09-06T12:57:34.959Z","1.0.7":"2026-09-06T14:02:41.881Z","1.0.8":"2026-09-06T14:41:29.364Z"},"author":{"name":"lost_fish","url":"https://gitee.com/yyaylt"},"license":"MIT","keywords":["zhipu","web-search","mcp-server"],"repository":{"type":"git","url":"https://gitee.com/yyaylt/zhipu-web-search-mcp-server.git"},"description":"MCP server for ZHIPU AI Web Search API integration","contributors":[{"name":"lost_fish","url":"https://gitee.com/yyaylt"}],"maintainers":[{"name":"yyaylt","email":"yyaylt@foxmail.com"}],"readme":"# zhipu-web-search-mcp-server\n\n基于智谱开放平台 [Web Search API](https://docs.bigmodel.cn/cn/guide/tools/web-search) 实现的 MCP 服务器，为 Codex、opencode 等 MCP 客户端提供网络搜索能力。\n\n## 功能特性\n\n- 支持 4 种搜索引擎：智谱基础版（`search_std`）、智谱高阶版（`search_pro`）、搜狗（`search_pro_sogou`）、夸克搜索（`search_pro_quark`）\n- 支持搜索意图识别（`search_intent`）\n- 支持结果条数、域名白名单过滤、时间范围过滤、内容长度控制\n- 返回 Markdown 文本 + 结构化 JSON 数据\n\n## 环境要求\n\n- Node.js >= 18\n- 智谱 API Key：从 [https://bigmodel.cn/usercenter/proj-mgmt/apikeys](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) 获取\n\n## 使用 npx 启动\n\n发布包含此功能的 npm 版本后，无需克隆仓库或手动构建即可启动：\n\n```powershell\n$env:ZHIPU_API_KEY = \"your_api_key_here\"\nnpx -y @yyaylt/zhipu-web-search-mcp-server\n```\n\n服务器通过 stdio 与 MCP 客户端通信，启动后等待客户端请求。首次运行需要联网下载 npm 包。\n\n## 从源码安装与构建\n\n开发和测试使用 Node.js 22 或 24；已发布包的运行要求仍为 Node.js >= 18。\n\n```bash\nnpm install\nnpm run build\n```\n\n## 在 Codex 中使用\n\nCodex 通过 stdio 连接本地 MCP 服务器。使用 `codex mcp add` 添加并传入 API Key：\n\n```bash\ncodex mcp add zhipu-web-search --env ZHIPU_API_KEY=your_api_key_here -- npx -y @yyaylt/zhipu-web-search-mcp-server\n```\n\nWindows 下若客户端无法直接执行 `npx`，可将启动命令改为 `cmd /c npx -y @yyaylt/zhipu-web-search-mcp-server`。添加后重启 Codex，即可在会话中调用 `zhipu_web_search` 工具。\n\n## 配置\n\n通过环境变量 `ZHIPU_API_KEY` 提供 API Key：\n\n```bash\n# PowerShell\n$env:ZHIPU_API_KEY = \"your_api_key_here\"\n```\n\n## 在 opencode 中使用\n\n在 `opencode.json` 中添加 MCP 服务器配置：\n\n```json\n{\n  \"mcp\": {\n    \"zhipu-web-search\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@yyaylt/zhipu-web-search-mcp-server\"],\n      \"environment\": {\n        \"ZHIPU_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n或使用 `opencode mcp add` 命令添加：\n\n```bash\nopencode mcp add zhipu-web-search -- npx -y @yyaylt/zhipu-web-search-mcp-server\n```\n\n然后设置环境变量后重启 opencode 即可。\n\n若 Windows 客户端无法直接执行 `npx`，可将 `command` 改为 `[\"cmd\", \"/c\", \"npx\", \"-y\", \"@yyaylt/zhipu-web-search-mcp-server\"]`。\n使用本地源码时，仍可将 `command` 设置为 `[\"node\", \"D:\\\\path\\\\to\\\\zhipu-web-search-mcp-server\\\\dist\\\\index.js\"]`。\n\n## 可用工具\n\n### zhipu_web_search\n\n执行网络搜索，返回网页标题、摘要、链接、网站名称等信息。\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| search_query | string | 必填 | 搜索内容，不超过 70 字符 |\n| search_engine | string | search_std | 搜索引擎：search_std / search_pro / search_pro_sogou / search_pro_quark |\n| search_intent | boolean | false | 是否执行搜索意图识别 |\n| count | number | 支持的引擎默认 10 | search_std / search_pro：1-50 的整数；search_pro_sogou：仅 10/20/30/40/50；search_pro_quark：不支持，不能指定 |\n| search_domain_filter | string | - | 白名单域名过滤（search_std / search_pro / search_pro_sogou 支持） |\n| search_recency_filter | string | noLimit | 时间过滤：oneDay / oneWeek / oneMonth / oneYear / noLimit |\n| content_size | string | medium | 内容长短：medium / high |\n| user_id | string | - | 终端用户 ID，6-128 字符 |\n\n条数行为依据 [Web Search API 官方参数文档](https://docs.bigmodel.cn/api-reference/工具-api/网络搜索)：\n\n- `count` 是请求条数，输出 JSON 的 `count` 是实际收到的 `results.length`，不能将两者视为必然相等。\n- 官网在搜狗枚举说明后注明同时指定 `search_domain_filter` 和 `search_recency_filter` 时 `count` 不生效，未明确此备注对其他引擎的适用范围。项目保留用户的具体过滤条件并提示此限制。\n- `search_recency_filter` 为 `noLimit` 时省略该请求字段，避免默认值导致同时携带域名和时间过滤；官网未明确服务端是否将显式 `noLimit` 计入上述限制。\n- 夸克不发送 `count`；显式指定会返回参数错误。搜狗的非法条数也会在发送请求前拒绝。\n- 夸克不支持 `search_domain_filter`，显式指定会返回参数错误；纯空白搜索词也会被拒绝。\n- 最终 Markdown（含意图、标题和提示）最多 100,000 字符，按完整条目截断；超长意图最多使用四分之一文本预算。截断标题显示“展示 X 条，共 Y 条”，结构化结果保留完整列表。\n- HTTP 响应体限制为 8 MiB，超过时返回错误；无效响应不会被当作空结果。客户端取消请求会中止 HTTP 请求，不自动重试。\n\n## 隐私与安全提示\n\n- `ZHIPU_API_KEY` 仅通过环境变量注入，请勿将其写入代码、配置仓库或提交到 Git 历史。\n- `user_id` 参数会原样透传给智谱开放平台，请仅传入**匿名化/不可逆**的终端用户标识，切勿传入邮箱、手机号、身份证号等真实个人身份信息。\n- 搜索内容（`search_query`）会发送至智谱开放平台进行检索，请避免在搜索词中包含个人敏感信息。\n- 服务器不主动存储搜索历史；错误日志仅记录固定分类，不记录 API Key、请求体或原始异常。MCP 客户端可能自行保存通信内容或 stderr，请根据客户端配置管理日志。\n\n## 错误码说明\n\n| 错误码 | 含义 | 处理建议 |\n|--------|------|----------|\n| 1701 | 网络搜索并发已达上限 | 稍后重试或减少并发请求 |\n| 1702 | 系统未找到可用的搜索引擎服务 | 检查配置或联系管理员 |\n| 1703 | 搜索引擎未返回有效数据 | 调整查询条件 |\n\n## 开发\n\n```bash\nnpm run dev    # tsx watch 模式开发\nnpm run build  # 编译到 dist/\nnpm pack       # 自动构建并生成包含可执行入口的 npm 包\nnpm run typecheck # 检查源码和测试的 TypeScript 类型\nnpm test          # 自动构建并执行回归测试\nnpm run test:package # 临时安装真实 npm 包，验证 bin 启动和 MCP 握手（需要联网）\n```\n\n## 验证\n\n构建成功后启动服务器，若未设置 `ZHIPU_API_KEY` 会提示缺失：\n\n```bash\nnode dist/index.js\n# ERROR: ZHIPU_API_KEY 环境变量是必需的\n```\n\n## License & Acknowledgments\n\nThis project is licensed under the MIT License. See [LICENSE](./LICENSE) for details.\n\nContributions are welcome — please read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting code.\n\nIt includes third-party packages with the following licenses (historical snapshot; manually refresh via `npx license-checker --summary`; counts may vary with dependency versions):\n- MIT (95 packages)\n- BlueOak-1.0.0 (7 packages)\n- ISC (7 packages)\n- Apache-2.0 (1 package)\n- BSD-3-Clause (2 packages)\n- BSD-2-Clause (1 package)\n\n> 提示：以上数量为生成本文档时的快照。依赖升级后可用 `npx license-checker --summary` 重新生成核对。\n","readmeFilename":"README.md"}