@deepseek-ai/dsh-web-search-duckduckgo

English | 中文

一个免费的 DuckDuckGo 搜索后端（WebSearchProvider），接入 harness web 能力 seam（ctx.web），并附带模型可见的 web_search_ddg 工具。它使用 HTML 端点（html.duckduckgo.com/html/）搜索，并在无结果时回退到 Instant Answer JSON——无需 API key、无需凭据、每次搜索零成本。

这是实现包：它向 ctx.web 注册 provider，并且与其他 web-search 包不同，它还注册自己的 web_search_ddg 工具。该工具直接调用 provider（绕过 seam 的 provider 选择），因此部署时可以在 seam 上固定另一个 provider（出厂配置为 searchProvider: deepseek-official），同时并提供这条免费路线，让模型每轮自行选择。

配置

键	默认值	含义
proxy	（未设置）	host:port 或 http://host:port 形式的 CONNECT 代理，用于直连无法到达的端点。设置后，隧道失败会自动回退到直连。
baseURL	https://html.duckduckgo.com/html/	HTML 搜索端点；通过 POST q/b/l 表单搜索（查询词、bang 占位、区域）。值无法解析时 provider 不可用。
region	us-en	表单 l 字段的区域代码（如 us-en、uk-en、de-de）。
fallbackBaseURL	https://api.duckduckgo.com/	HTML 无结果时使用的 Instant Answer JSON 端点。值无法解析时 provider 不可用。
userAgent	浏览器 UA	每次请求发送的 User-Agent 头。
timeoutMs	30000	单次请求超时（毫秒）。必须是正整数。
maxResults