dsh-web-search-firecrawl

English | 中文

由 Firecrawl 支持的搜索提供方，用于 DeepSeek Harness 的 web 能力 seam（ctx.web）：让内置的 web_search 工具走 Firecrawl 搜索 API，而不是随产品附带的 DeepSeek 路由。

本插件是一个 Cordis 函数插件，向 seam 注册 WebSearchProvider（id: firecrawl）——它不拥有 ctx.web，也不注册面向模型的工具（工具 schema 仍属于 @deepseek-ai/dsh-tool-web）。它调用 Firecrawl 的 POST /v1/search 端点，把扁平 data[] 映射为 seam 规范化的 WebSearchResult。

环境要求

• DeepSeek Harness 安装在官方包 0.1.0-rc.6 线上（本插件 peer 依赖 @deepseek-ai/dsh-web ^0.1.0-rc.6 等——当前发布线）。更旧线上 pnpm 会在 profile 中嵌套安装第二份 seam 包，错误分类会降级（跨副本 WebError）；可在 profile 目录执行 npm ls @deepseek-ai/dsh-web 检查。
• Firecrawl API 密钥。提供方从 $FIRECRAWL_API_KEY 或下方 apiKey 配置读取（见 API 密钥）。可在 firecrawl.dev 获取。

安装

以下步骤假设 dsh 命令在 PATH 上（例如通过 npm install -g @deepseek-ai/dsh 安装）。如果你是从源码仓库运行 dsh（如 pnpm dsh ...），请把所有 dsh ... 换成对应的调用方式——CLI、profile 与插件必须来自同一个安装。

1. 安装 bundle（需要 PATH 上有 pnpm）：

   dsh plugin --profile web add @yangzhe1003/dsh-web-search-firecrawl
   

   dsh plugin 会在 profile 目录内转发给 pnpm，并自动把 bundle 追加到 profile 的层叠列表。该 bundle patch 插入 web-search-firecrawl 插件行，并把 web seam 行切换为 searchProvider: firecrawl（替换 base bundle 的 deepseek-official）。

2. 提供 API 密钥——临时或持久化，见 API 密钥。

3. 重启 dsh web——bundle 层在启动时组合，运行中的实例不会加载新安装的 bundle。请完全退出当前 dsh web 进程，然后重新启动：

   dsh web
   

4. 验证——在会话中让 agent 执行一次网页搜索，请求会走 Firecrawl；也可用 dsh --profile web --dump-config 查看组合后的配置树。密钥缺失时搜索会以 WEB_PROVIDER_CONFIGURED_UNAVAILABLE 失败。