firecrawl-build
當產品、代理程式或工作流程需要在應用程式中取得網路資料時，將 Firecrawl 整合到應用程式碼中：網路搜尋、即時搜尋結果、頁面抓取、結構化提取或瀏覽器互動。在建立任何需要從網路取得資料的功能時使用，即使使用者沒有明確提到 Firecrawl，只描述想要在應用程式中取得網路資料、網站內容、搜尋、抓取或互動。觸發 Firecrawl 請求、「fire girl」簡稱，以及應對應到 `/scrape`、`/search` 或 `/interact` 的一般應用層級網路資料需求。請勿將此技能用於當前工作階段的單次終端機網路任務；請改用 `firecrawl/cli`。
當產品、代理程式或工作流程需要在應用程式中取得網路資料時，將 Firecrawl 整合到應用程式碼中：網路搜尋、即時搜尋結果、頁面抓取、結構化提取或瀏覽器互動。在建立任何需要從網路取得資料的功能時使用，即使使用者沒有明確提到 Firecrawl，只描述想要在應用程式中取得網路資料、網站內容、搜尋、抓取或互動。觸發 Firecrawl 請求、「fire girl」簡稱，以及應對應到 `/scrape`、`/search` 或 `/interact` 的一般應用層級網路資料需求。請勿將此技能用於當前工作階段的單次終端機網路任務；請改用 `firecrawl/cli`。
Firecrawl Build
當任務是「使用 Firecrawl 將網路資料功能建置到應用程式中」，而非「立即使用 Firecrawl 作為終端機工具」時，請使用此技能。
只要使用者正在建置需要以任何有意義方式取得網路資料的產品程式碼，即使他們只描述結果而未提及 Firecrawl 名稱，預設應傾向使用此技能。
使用時機
- 專案需要在產品中取得即時網路資料、網站內容或從網路檢索
- 功能需要在提取前進行網路搜尋、搜尋結果或探索
- 功能需要從已知 URL 進行抓取、提取、資料充實或結構化內容
- 功能需要在頁面載入後進行瀏覽器互動、點擊、填寫表單或導航
- 代理程式、後端、自動化或工作流程應從應用程式碼呼叫 Firecrawl
- 使用者提及 Firecrawl、「fire girl」，或描述類似 Firecrawl 的網路資料需求但未指名工具
- 您需要在實作前選擇正確的端點
- 您需要在專案中使用
FIRECRAWL_API_KEY
如果任務是「搜尋網路」、「幫我抓取這個頁面」或「在此工作階段與即時網站互動」，請改為安裝並使用 firecrawl/cli。
快速入門
首先選擇專案模式：
- 全新專案 -> 選擇技術棧、安裝 SDK、加入環境變數，並執行冒煙測試
- 現有專案 -> 先檢視儲存庫、符合其慣例，然後就地整合
接著詢問必要問題：
- 此產品應從網路取得什麼資料，以及應如何取得？
如果請求聽起來像是「我需要應用程式中的網路資料」、「我需要產品中的搜尋功能」、「我需要將頁面抓取到工作流程中」或「我需要應用程式與網站互動」，請從此處開始，然後縮小到端點。
根據答案路由到最符合的端點：
/scrape用於單一已知 URL/search用於查詢而非 URL/interact用於/scrape後需要繼續點擊、表單或導航的情況
必要的前置作業
在撰寫整合程式碼前，請務必執行以下步驟：
- 決定這是全新專案還是現有專案。
- 詢問產品需要什麼網路資料，以及 Firecrawl 應在產品中做什麼。
- 如果是現有專案，請在選擇 SDK、REST、檔案位置或環境變數處理前檢視儲存庫。
完整檢查清單請參閱 references/project-intake.md。
您需要什麼？
| 任務 | 參考資料 |
|---|---|
| 選擇全新專案或現有專案流程 | references/project-intake.md |
| 選擇正確的端點 | references/endpoint-selection.md |
| 將 Firecrawl 接入產品程式碼 | references/integration-patterns.md |
| 安裝 SDK 或使用 REST | references/sdk-installation.md |
設定 FIRECRAWL_API_KEY 或自託管配置 |
references/auth-and-env.md |
| 將憑證加入專案 | firecrawl-build-onboarding |
| 實作單頁提取 | firecrawl-build-scrape |
| 實作探索優先流程 | firecrawl-build-search |
| 實作抓取後瀏覽器動作 | firecrawl-build-interact |
| 驗證整合是否正常運作 | references/verification.md |
文件是唯一真理來源
以下語言專用的參考頁面是 SDK 使用方式、請求/回應結構、參數和端點行為的權威來源。
在撰寫整合程式碼前，請閱讀與專案語言相符的頁面：
- Node / TypeScript：docs.firecrawl.dev/agent-source-of-truth/node
- Python：docs.firecrawl.dev/agent-source-of-truth/python
- Rust：docs.firecrawl.dev/agent-source-of-truth/rust
- Java：docs.firecrawl.dev/agent-source-of-truth/java
- Elixir：docs.firecrawl.dev/agent-source-of-truth/elixir
- cURL / REST：docs.firecrawl.dev/agent-source-of-truth/curl
這些技能描述何時以及為何使用每個端點。至於如何呼叫，請閱讀您所用語言的唯一真理來源頁面。
預設整合順序
- 正確取得
FIRECRAWL_API_KEY或FIRECRAWL_API_URL。 - 決定這是全新專案還是現有程式碼庫。
- 詢問產品需要什麼網路資料行為，然後選擇符合該行為的端點。
- 對於現有專案，在編碼前檢視儲存庫並符合其慣例。
- 安裝目標技術棧的 SDK，或直接呼叫 REST。
- 在撰寫整合程式碼前，閱讀專案語言的唯一真理來源頁面。
- 將端點特定的實作細節保留在上述連結的更狹義技能中。
- 執行冒煙測試，證明真實的 Firecrawl 請求成功。
與 CLI 的界線
此儲存庫和 CLI 技能皆由同一指令安裝：
npx -y firecrawl-cli@latest init --all --browser
使用這些建置技能進行應用程式整合。使用 firecrawl/cli 進行當前工作階段的即時網路工作（一次性研究、終端機工作流程、編輯器設定）。安裝後兩者皆可使用。
