DeepSeek Search 与 Fetch API：DSH 配置、计费与限流

DeepSeek Search 与 Fetch API 把“找页面”和“读页面”拆成两个独立接口。Search 返回排序后的网页结果，Fetch 把指定 URL 转为适合 Agent 使用的 Markdown 正文。DeepSeek Harness v0.2.1-rc.2 已在 Web Search 设置中接入这两项能力。

接口与认证

Search 使用：

POST https://api.deepseek.com/v1/tools/search

Fetch 使用：

POST https://api.deepseek.com/v1/tools/fetch

两者都通过 Bearer Token 使用现有 DeepSeek API Key。它们不是模型对话接口，拥有独立的请求字段、限流和计费记录。

Search 请求

query 是必填字段，长度为 1–128 个 Unicode 字符。count 可取 1–50，默认 10。还可以传入原始问题 ori_question、本地化参数 localization，并用 need_content 决定是否在结果中包含正文。

{
  "query": "DeepSeek Harness site:github.com after:2026-10-01",
  "count": 10,
  "need_content": false
}

查询支持 site:、-site:、减号排除、引号精确匹配、lang:、after: 与 before:。高质量 Agent 检索通常从限定站点和日期开始，而不是一次拉取 50 条结果。

结果可包含标题、URL、摘要、正文、日期、0–3 的相关性分数和 -1 到 4 的权威度。排序字段可以辅助筛选，但最终引用仍应回到原始页面核对。

Fetch 请求

Fetch 接收目标 URL，返回页面标题与 Markdown 正文。它适合在 Search 选出候选页面后读取少量高价值来源，也会遵守目标站点的访问策略。

在 DSH 中，合理流程是“Search 缩小范围—Agent 选择来源—Fetch 正文—保留引用 URL”。不要默认抓取所有搜索结果，否则会增加延迟、费用和上下文噪音。

计费与免费期

Search 和 Fetch 均为每 1000 次成功且非空的 200 响应收费 0.75 美元。空结果、失败与超时不收费，Search 的 count 不改变单次调用价格。

通过 DSH、Claude Code 和 Codex 发起的服务端工具调用，官方公告的免费期截止到北京时间 2026 年 11 月 1 日 00:00。免费期结束后应按实际调用数设置预算与监控。

限流与重试

Search 与 Fetch 分别有账号级 5 QPS 限制，Fetch 还存在目标域名级 QPS 限制。400、401、402、403、404 与 413 通常需要修改请求或账号状态；408、429 和 5xx/504 才适合等待后重试。Agent 不应对所有错误无限循环。

在 DSH 中配置

升级到 v0.2.1-rc.2 后，进入 Web Search 设置启用 DeepSeek Search 与 Fetch，并填写对应账号凭据。随后用一个受限查询完成端到端测试：搜索官方文档、选择一条结果、Fetch 正文、输出带 URL 的摘要。

建议同时设置：单任务最大 Search 次数、最大 Fetch 次数、允许域名、重试上限和最终引用要求。这样网页工具才是可审计的研究链路，而不是无边界的背景流量。

参考资料

• DeepSeek Search 与 Fetch API 官方指南
• DeepSeek Harness v0.2.1-rc.2 Release