firecrawl 代理
AI 驅動的自動化提取。代理會導航網站並提取結構化數據（需 2-5 分鐘）。
在開始針對結構化記錄或列表進行自主提取之前，請先使用 firecrawl search alexandria '<你需要的資料>' 檢查是否有現成的積木流程或數據提供者。使用 firecrawl list <provider> <capability> --pretty 檢視符合需求的合約，若該合約涵蓋任務，則用 firecrawl scrape --alexandria <provider>/<capability> --options '<輸入 JSON>' 執行。請使用合約中確切的提供者、能力和輸入欄位。只有在沒有適合的工具，或任務需要自主導航時，才繼續使用代理。
快速入門
# 提取結構化資料
firecrawl agent "提取所有定價層級" --wait --json -o .firecrawl/pricing.json
# 搭配 JSON schema 輸出結構化結果
firecrawl agent "提取產品" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json
# 聚焦特定頁面
firecrawl agent "獲取功能列表" --urls "<網址>" --wait --json -o .firecrawl/features.json
執行 firecrawl agent --help 查看完整的選項列表。
完成條件： 輸出檔案包含有效的 JSON 並回應請求——或故意返回 job ID 供後續輪詢。
Alexandria 提供者
只有在執行時使用 Alexandria 旗標時，才會連接已啟用的 Alexandria 數據提供者：--alexandria、--toolkits <slugs>（最多 5 個）、--max-calls <n>、--require-approval 或 --on-terms-required skip|ask。後續在其執行緒上的追蹤操作會保留這些設定。
firecrawl agent "在 <公司> 尋找銷售主管" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json
使用 --require-approval（需搭配 --mode chat）時，執行可能因需要付費呼叫而結束於 pendingApproval。請詢問使用者，然後在同一執行緒中以 firecrawl agent "<後續提示>" --thread <threadId> --mode chat --approve <approvalId>（或 --decline <approvalId>）回覆。terms 類的核准只有在組織管理員在 Firecrawl 控制台接受提供者的條款後才會繼續；請提供使用者 https://www.firecrawl.dev/app/settings?tab=data-sources，如果他們想先檢視條款，可以使用 firecrawl alexandria terms show <provider>。核准並不代表接受條款。
Job ID
省略 --wait 會返回 job ID。UUID 位置參數會自動被偵測為狀態檢查：
# 檢查一次（等效於加上 --status）
firecrawl agent "<job-id>"
# 等待現有作業完成，每 10 秒輪詢一次，最多 5 分鐘
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300
# 取消進行中的作業
firecrawl agent "<job-id>" --cancel
提示
- 使用
--wait取得即時結果；只有在你想稍後輪詢 job ID 時才省略它（請見 Job ID）。 - 使用
--schema取得可預測的結構化輸出——否則代理會回傳自由格式的資料。 - 代理執行消耗的點數比單純爬取更多。使用
--max-credits來限制花費。 - 對於簡單的單頁提取，建議使用
scrape——它更快且更便宜。
另請參閱
- firecrawl-scrape —— 更簡單的單頁提取
- firecrawl-interact —— 爬取 + 互動，用於手動頁面操作（更多控制）
- firecrawl-crawl —— 無需 AI 的大量提取
- firecrawl-build-scrape —— 將結構化提取整合到應用程式中，而非在此處執行
Alexandria 回饋
若要回報 Alexandria 工作階段結果或提供者/能力缺口，請使用 firecrawl alexandria feedback --rating good|partial|bad --url <網站> --requested-functionality '<所需功能>' --objective '<任務的根本目標>' --rationale '<發生了什麼>' --json。請在理由中使用觀察到的結果。不需要 job ID；請在最後一次 Alexandria 搜尋、探索或執行後的 20 分鐘內發送，否則會被拒絕。每次提交可退還 1 點積分，每個網站每天最多 10 點，每個團隊每天最多 100 點（UTC 時間）。可選的 --provider-feedback 和 --capability-feedback JSON 陣列用於描述特定缺口；請查閱 firecrawl alexandria feedback --help 了解其欄位。當提供者存在但缺乏所需能力時，請使用能力問題 missing_capability；若要請求新能力，請使用 new_capability_request（並附上 requestedFunctionality）。