前言¶

在 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 倉庫。