前言¶

在 DeepSeek Harness（DSH）中开发智能体时，让模型获取外部信息是常见需求。通过命令行或编程方式手动抓取网页并转换为 Markdown，容易受限于页面结构或动态加载。下面介绍一个社区插件，它通过 Firecrawl Cloud API 提供了直接调用抓取和搜索的能力。

是什么¶

zoahdev/dsh-firecrawl 是一个社区维护的 DSH 插件。它作为 Firecrawl 的桥接层，允许 DSH 直接使用 Firecrawl 的能力：将任意 URL 转换为 LLM 可用的 Markdown 格式（支持处理包含大量 JavaScript 的页面），以及通过搜索返回结果页面的内容。

核心功能¶

该插件提供了两个核心工具：
1. firecrawl_scrape：抓取指定 URL，返回 Markdown 格式内容。
2. firecrawl_search：执行网络搜索，返回搜索结果页面的内容。

安装与启用¶

安装该插件需要使用 DSH 的插件安装命令。

dsh plugin --profile web add dsh-firecrawl

安装后需配置 Firecrawl 的凭证。可以通过配置项 apiKey 设置，或设置环境变量 FIRECRAWL_API_KEY。此外，还可配置 baseUrl（默认 https://api.firecrawl.dev）和 timeoutMs（默认 120000）。

典型用法¶

安装并配置完成后，可以在 DSH 的对话或脚本中直接调用上述工具。例如，调用 firecrawl_scrape 抓取一个复杂页面：

firecrawl_scrape <URL>

调用 firecrawl_search 进行搜索：

firecrawl_search <query>

注意事项¶

使用前需注意：
* 这是一个基于 Cloud API 的桥接插件，必须拥有有效的 Firecrawl API Key。
* 插件返回的是原始响应数据，不支持流式传输或轮询等待完成。
* 需要依赖 @deepseek-ai/dsh-tools 版本 ^0.1.0-rc.6 及以上。
* 该插件为社区项目，非官方产品，建议在使用前检查源码与许可证（MIT）。

短结尾¶

该插件为 DSH 开发者提供了一个稳定的网页数据获取方案。更多细节请参考其 GitHub 仓库。