技能包

Firecrawl CLI:在終端機為智慧體補上抓取與搜尋

適合要在本機終端機完成網頁搜尋、抓取或跑智慧體任務的人;先準備好 Firecrawl 存取方式,再用官方一條初始化命令,不要另找安裝器。

官方來源 · Firecrawl CLI

安裝

npx -y firecrawl-cli@latest init -y --browser

適合誰

這份指南面向需要在本機終端機完成網頁搜尋、抓取、頁面互動、站點爬取、網站地圖,或直接跑智慧體任務的人。官方把它同時寫成命令列入口,以及可裝進已偵測到的程式編輯器的智慧體技能。

若你的工作是先看公開頁面再決定要不要改程式碼,而不是先自建一套抓取服務,這條路徑更合適。官方說明還可以檢索論文與開發者資料。它不適合只想在圖形介面點幾下、卻不能執行終端機命令的人:建議路徑會安裝命令列工具、完成登入,並把技能寫到已偵測到的編輯器。

官方倉庫是

https://github.com/firecrawl/cli

請只按該頁目前寫法操作,不要改用未出現在該頁的安裝器或技能目錄。

3 分鐘完成第一次嘗試

只走官方建議的一條路徑。

前置條件:終端機能執行 npx,並已準備 Firecrawl 存取方式。官方提示也可以設定 FIRECRAWL_API_KEY 環境變數;init 帶 --browser 時會走瀏覽器登入。執行前先確認將登入的是你自己的帳號,並看清預設會寫入所有已偵測到的程式編輯器,而不是某個暫存目錄。

安裝位置:技能預設全域裝到已偵測到的編輯器。若只想給其中一個,官方寫法是加上 --agent <agent>。

複製並執行:

npx -y firecrawl-cli@latest init -y --browser

成功訊號:命令正常結束,本機能呼叫 firecrawl,且已偵測到的編輯器出現新技能。先不要抓整站。下一步做一次可逆確認:執行 firecrawl setup core。官方說明這一組提供抓取、搜尋、爬取、互動原語以及索引類技能,skills 是它的別名。命令被接受後,再到已裝入的智慧體裡提一個唯讀請求,例如「用 Firecrawl 搜尋某個公開文件標題,只顯示結果、不要寫檔案」。能看到結果,代表技能已被找到。

需要對接 Firecrawl API 的應用整合技能時,再執行 firecrawl setup build。需要獲客線索或深度研究這類端到端配方時,再執行 firecrawl setup workflows。第一次只裝 core,避免一次寫入全部配方。

使用案例

案例一:給目前智慧體補上搜尋與抓取原語。對應官方操作是 firecrawl setup core,安裝 scrape、search、crawl、interact 原語以及索引技能。適合你已在某個被偵測到的編輯器裡工作,希望智慧體先搜尋或抓取公開頁面,再決定是否改倉庫。先完成上面的 init,再只裝 core。成功時,對話裡應能觸發一次搜尋或抓取,並看到結果摘要。官方材料沒有給出技能資料夾路徑,因此不要手寫未出現的目錄。

案例二:需要現成配方而不是單條原語。對應官方操作是 firecrawl setup workflows,材料裡舉了獲客線索和深度研究。適合 core 已經能跑通,現在要按配方做研究。先確認 init 成功,再執行該命令;若只裝到一個編輯器,加上 --agent <agent>。成功訊號是該組技能出現在目標編輯器。配方內部步驟沒有展開,現有材料只能確認「已安裝 workflows」,不能補全未寫出的子步驟。

使用邊界

現有材料止於終端機命令、瀏覽器登入或 FIRECRAWL_API_KEY,以及 core、build、workflows 三組安裝。它沒有規定必須支援的語言,也沒有把「已偵測編輯器」寫成排他名單;不要從預設安裝範圍推斷只有某幾個用戶端可用。

不要把這條 npx 初始化套到只允許手工複製技能檔、卻沒有通用命令列的環境。材料也沒有給出第二市場地址,或示例金鑰。

init 和 setup 會向已偵測編輯器寫入技能,屬於有副作用的操作。執行前先確認目標編輯器,執行後只檢查技能是否出現,不要立刻對未授權站點做整站爬取。抓取、互動、爬取都會造訪外部站點,先用公開且可重複開啟的頁面驗證。

FIRECRAWL_API_KEY 是環境變數名稱,不是要填進正文的示例金鑰。不要編造未出現的子命令、技能名或安裝路徑。更多說明以官方倉庫為準:

https://github.com/firecrawl/cli