{"_id":"deepseek-websearch-mcp","_rev":"4-77298fe3f3c5a8241f49be64a1084744","name":"deepseek-websearch-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"0.0.0-stage":{"name":"deepseek-websearch-mcp","version":"0.0.0-stage","_id":"deepseek-websearch-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"}],"dist":{"shasum":"3ba4c86ccd89db18c27bb5400d608c7d4137731a","tarball":"https://registry.npmjs.org/deepseek-websearch-mcp/-/deepseek-websearch-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-vnaOpiRHCmxU6NQXhv4IiRjOTn5WggkL9MO9ZnDr62RCQN3MPlz4H1UWEWB8K61CEC7YNjzF8CNZTJwYx7lgUQ==","signatures":[{"sig":"MEUCIQCz/9VwL+oeIb9y243tO3Ve0SQ9/XkNpb2Mfzmt2DtMDwIgR98qhuBK9qK+17Xz5lxGMe5nLKRQuxfGbTSGLwoOziE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":344},"_npmUser":{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"deepseek-websearch-mcp","version":"1.0.0","keywords":["deepseek","mcp","mcp-server","model-context-protocol","web-search","search","web-fetch"],"author":{"name":"zengzoxiong"},"license":"MIT","_id":"deepseek-websearch-mcp@1.0.0","maintainers":[{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"}],"homepage":"https://github.com/zengzoxiong/deepseek-search-mcp#readme","bugs":{"url":"https://github.com/zengzoxiong/deepseek-search-mcp/issues"},"bin":{"deepseek-websearch-mcp":"server.mjs"},"dist":{"shasum":"504f577e9a878cd18e3f943cb4f8ff8b7e13b12a","tarball":"https://registry.npmjs.org/deepseek-websearch-mcp/-/deepseek-websearch-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-Mhh7SBOIMRgZ92T9NARto/HXTRIOw7wxJvkWVFzG3fB0iKH4mBA3b9KuNMiMu22T65EUaxkxsllQFahsuGqMDA==","signatures":[{"sig":"MEYCIQCIcJ4dgsT51GJjEX8VJol8DtzhQFXNF2CB2cl2ZsXmuAIhALG4EKneuxVODC7tRiZ34MUiPA/TkyAONRH5/lReMd5U","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCID44ccOCObaHUTf6XbALcIr1KzPlUkWtHfeqGbS0ALyFAiBhbfUH6U7hvg6wAoATLlXNt8Xb8nDMQzLOelJUwNXocQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18456},"type":"module","engines":{"node":">=18"},"_npmUser":{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"},"repository":{"url":"git+https://github.com/zengzoxiong/deepseek-search-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"DeepSeek 官方 Search/Fetch API 的 MCP server（官方 SDK 构建，webSearch/webFetch 双工具，支持时效过滤与结构化输出）","directories":{},"_nodeVersion":"23.9.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/server":"2.3.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/deepseek-websearch-mcp_1.0.0_1792245300178_0.7362742861777696","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"deepseek-websearch-mcp","version":"1.0.1","keywords":["deepseek","mcp","mcp-server","model-context-protocol","web-search","search","web-fetch"],"author":{"name":"zengzoxiong"},"license":"MIT","_id":"deepseek-websearch-mcp@1.0.1","maintainers":[{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"}],"homepage":"https://github.com/zengzoxiong/deepseek-search-mcp#readme","bugs":{"url":"https://github.com/zengzoxiong/deepseek-search-mcp/issues"},"bin":{"deepseek-websearch-mcp":"server.mjs"},"dist":{"shasum":"0b04e2c40f84bb5f7585e341e235d82f14d0546c","tarball":"https://registry.npmjs.org/deepseek-websearch-mcp/-/deepseek-websearch-mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-xhERQh5g8sgwNsfhEI3+6s/afXYljdOcNaDQAx1+3kgCqFWepsLpP/j7vwIFwjdOGDuvUrbpNGjw2dSwNQAiNw==","signatures":[{"sig":"MEUCIQDjZhwh/lfYawQ0j8X5keWuuozv8kWym3AMty+3lpkQWQIgO8GWBRDt/1o9KLHE6tSxZhSUxu2Gj/1G34yEMpgGvX8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIGf5hv6Dl8sGQvTWCuBLkeGArVhiHuydpnYc0W0KRHp5AiEAxy+PctU/KpxOvnXgoXRHS8knFGFoThuj+gXbAtow2dc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19194},"type":"module","engines":{"node":">=18"},"_npmUser":{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"},"repository":{"url":"git+https://github.com/zengzoxiong/deepseek-search-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"DeepSeek 官方 Search/Fetch API 的 MCP server（官方 SDK 构建，webSearch/webFetch 双工具，支持时效过滤与结构化输出）","directories":{},"_nodeVersion":"23.9.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/server":"2.3.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/deepseek-websearch-mcp_1.0.1_1792249470360_0.3540891454690138","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"_id":"deepseek-websearch-mcp@1.0.2","bin":{"deepseek-websearch-mcp":"server.mjs"},"bugs":{"url":"https://github.com/zengzoxiong/deepseek-search-mcp/issues"},"dist":{"shasum":"7a8cd71ce7e69524406010fe39c417812d8d1186","tarball":"https://registry.npmjs.org/deepseek-websearch-mcp/-/deepseek-websearch-mcp-1.0.2.tgz","fileCount":4,"integrity":"sha512-UNWriR2MMddrIwdkDSRHTB0TpN30sSsu4cX33qL72aEr7zyOdGbl0uVlmNUBj7NHP+NPl7Q40XWU2zS/LSsrRg==","signatures":[{"sig":"MEQCICdWbMnSTTP2hf+nPjhmeSm4yzwX2dZ/2F7SvXcnAkU3AiBIs7Q9c4x/rdWvT07Mt2vCUTUkcD46p2rGQdZyBVToFA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCkg4B6NHy6DTQcvlK1iEJ/EK2TWjqoy2QW7pbPm0wDKwIhAN+w1yfm08FyLjQ3ZLo4xG15DAlZngXL5DfgtFf08Ja8"}],"unpackedSize":19192},"name":"deepseek-websearch-mcp","type":"module","author":{"name":"zengzoxiong"},"engines":{"node":">=18"},"license":"MIT","version":"1.0.2","_npmUser":{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"},"homepage":"https://github.com/zengzoxiong/deepseek-search-mcp#readme","keywords":["deepseek","mcp","mcp-server","model-context-protocol","web-search","search","web-fetch"],"repository":{"url":"git+https://github.com/zengzoxiong/deepseek-search-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"DeepSeek 官方 Search/Fetch API 的 MCP server（官方 SDK 构建，webSearch/webFetch 双工具，支持时效过滤与结构化输出）","directories":{},"maintainers":[{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"}],"_nodeVersion":"23.9.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/server":"2.3.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/deepseek-websearch-mcp_1.0.2_1792256051089_0.4159244956851329"}}},"time":{"created":"2026-10-17T13:54:24.472Z","modified":"2026-10-17T16:54:11.327Z","0.0.0-stage":"2026-10-17T13:54:24.472Z","1.0.0":"2026-10-17T13:55:00.256Z","1.0.1":"2026-10-17T15:04:30.458Z","1.0.2":"2026-10-17T16:54:11.168Z"},"bugs":{"url":"https://github.com/zengzoxiong/deepseek-search-mcp/issues"},"author":{"name":"zengzoxiong"},"license":"MIT","homepage":"https://github.com/zengzoxiong/deepseek-search-mcp#readme","keywords":["deepseek","mcp","mcp-server","model-context-protocol","web-search","search","web-fetch"],"repository":{"url":"git+https://github.com/zengzoxiong/deepseek-search-mcp.git","type":"git"},"description":"DeepSeek 官方 Search/Fetch API 的 MCP server（官方 SDK 构建，webSearch/webFetch 双工具，支持时效过滤与结构化输出）","maintainers":[{"name":"zengzoxiong","email":"zengzoxiong@mail.nwpu.edu.cn"}],"readme":"# DeepSeek Search MCP\n\n基于 [MCP 官方 SDK](https://github.com/modelcontextprotocol/typescript-sdk)（`@modelcontextprotocol/server`）构建的 MCP（Model Context Protocol）server，把 [DeepSeek 官方 Search / Fetch API](https://api-docs.deepseek.com/zh-cn/api/search)（自研搜索引擎）封装为标准 MCP 工具，供 Claude Code / Codex / ZCode / Deepseek Harness 等任意支持 MCP 的客户端使用。\n\n- **官方 SDK 构建**：协议层零手写，兼容性有保障；Node 18+，仅 2 个运行时依赖\n- **`webSearch`**：联网搜索（`query` / `count` / `freshness`），输出 `details: Title/Meta/Content/URL` 列表，同时以 `structuredContent` 透传原始结构化数据\n- **`webFetch`**：抓取单个网页，返回 Markdown 标题与正文\n- **结构化元数据**：每条结果附带发布日期、权威度（`authority` 0-4）、相关性分（`rerank_score` 0-3，≥1.5 为优质）\n\n## 工具说明\n\n#### `webSearch(query, count?, freshness?, ori_question?, localization?, need_content?)`\n\n| 参数           | 说明                                                                                                                                                                    |\n| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `query`        | 必填，≤128 字符。支持 `site:` / `-site:` / `lang:` / `after:` / `before:` / `\"精确短语\"` / `-排除词` 操作符（工具描述内嵌完整语法表）                                   |\n| `count`        | 返回条数，1-50，默认 10                                                                                                                                                 |\n| `freshness`    | 时效过滤：`pd`(24h) / `pw`(7天) / `pm`(31天) / `py`(365天) 或 `YYYY-MM-DDtoYYYY-MM-DD`，自动翻译为 `after:`/`before:` 操作符；拼接后超 128 字符时自动降级并在结果中提示 |\n| `ori_question` | 可选，触发搜索的用户原始问题（官方字段，辅助意图理解）                                                                                                                  |\n| `localization` | 可选，用于优先返回本地化结果的 IP 地址（官方字段）                                                                                                                      |\n| `need_content` | 是否返回页面全文，默认 `false` 只返回摘要                                                                                                                               |\n\n输出示例：\n\n```\nInput：\nwebSearch(\"DeepSeek Search API 上线\", count=3, freshness=\"pw\")\n\nOutput：\ndetails: 共 3 条结果, 耗时 0.34s\nTitle: Change Log | DeepSeek API Docs\nMeta: 发布于 2026-10-16 | 站点=DeepSeek | 权威度=3/4 | 相关性=2.61\nContent: Improved Chinese Search Capabilities\nURL: https://api-docs.deepseek.com/updates\n\nTitle: DeepSeek新版本上线\nMeta: 发布于 2026-10-16 | 站点=jingjiribao.cn | 权威度=4/4 | 相关性=2.34\nContent: # DeepSeek新版本上线\n…（长摘要，此处截略）\nURL: http://www.jingjiribao.cn/static/detail.jsp?id=690604\n\nTitle: DeepSeek上线搜索抓取API，V4.1快照短暂出现\nMeta: 发布于 2026-10-16 | 站点=驱动中国 | 权威度=3/4 | 相关性=2.33\nContent: # DeepSeek上线搜索抓取API，V4.1快照短暂出现\n…（长摘要，此处截略）\nURL: https://app.qudong.com/article/526406.html\n```\n\n#### `webFetch(url)`\n\n抓取 `http/https` 网页（≤8192 字符），返回 Markdown 正文（超过 60000 字符自动截断保护）。\n\n输出示例：\n\n```\nInput：\nwebFetch(\"https://example.com/\")\n\nOutput:\n已抓取 0.47s | Example Domain\n\n该域名仅用于文档示例，无需获得许可。这并非一项服务，请勿将其用于测试和监控目的。\n\nThis domain is for use in documentation examples without needing permission\\. This is not a service\\; avoid relying on it for testing and monitoring purposes\\.\n…（多语言正文，此处截略）\n```\n\n## 开始\n\n首先在 [platform.deepseek.com](https://platform.deepseek.com/api_keys) 申请 API Key。\n\n### Linux / macOS \n\n在 MCP 客户端配置中加入：\n\n```json\n{\n  \"mcpServers\": {\n    \"DeepSeek_Search\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"deepseek-websearch-mcp\"],\n      \"env\": {\n        \"DEEPSEEK_API_KEY\": \"你的API Key\"\n      }\n    }\n  }\n}\n```\n\n### Windows\n\nWindows 首先进行全局安装：\n\n```shell\nnpm install -g deepseek-websearch-mcp\n```\n\n再在 MCP 客户端配置中加入：\n\n```json\n{\n  \"mcpServers\": {\n    \"DeepSeek_Search\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"deepseek-websearch-mcp\"],\n      \"env\": {\n        \"DEEPSEEK_API_KEY\": \"你的API Key\"\n      }\n    }\n  }\n}\n```\n\n\n## 计费与限流\n\n- Search / Fetch 定价以[官方文档](https://api-docs.deepseek.com/zh-cn/guides/search)为准；失败、空结果、超时**不计费**，结果条数不影响单价\n- 每账号 Search / Fetch 各限 **5 QPS**（独立计数），Fetch 另有按域名限流，超限返回 429\n- 本 server 对 401（Key 无效）/ 402（余额不足）/ 403（安全策略）/ 404（无内容）/ 429（限流）返回中文错误说明，便于 Agent 自行判断是否重试\n\n## 注意事项\n\n- 本项目为**非官方**社区实现，与 DeepSeek 无关联；API 行为以[官方文档](https://api-docs.deepseek.com/zh-cn/api/search)为准\n- 调用产生费用由使用者自行承担\n- 请勿将 API Key 提交进任何仓库；本 server 仅通过环境变量 `DEEPSEEK_API_KEY` 读取密钥\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}