SKILL.md
唯讀
名稱
firecrawl-build-onboarding
描述
取得 Firecrawl 憑證並將 SDK 設定加入專案。當應用程式需要 `FIRECRAWL_API_KEY`、當 agent 應將 Firecrawl 加入 `.env`、當使用者想要為應用程式程式碼驗證 Firecrawl，或是在為新的 Firecrawl 整合選擇第一個 SDK 和文件時使用。此技能包含自己的瀏覽器驗證流程，因此不依賴網站 onboarding 技能。
Firecrawl Build Onboarding
使用此技能處理 Firecrawl onboarding 流程中的應用程式整合路徑。
安裝
如果您尚未安裝，一個指令即可同時設定 CLI 工具（用於即時網頁工作）和建置技能（用於應用程式整合）：
npx -y firecrawl-cli@latest init --all --browser
這會一起安裝 Firecrawl CLI、CLI 技能和這些建置技能。它也會開啟瀏覽器驗證，讓使用者可以登入或建立帳戶。不需要另外執行 npx skills add 步驟。
使用時機
- 專案需要
FIRECRAWL_API_KEY - 使用者想要將 Firecrawl 設定到
.env - 您第一次將 Firecrawl 加入應用程式
- 您需要選擇第一個 SDK 或 REST 路徑
如果使用者仍需要在瀏覽器中註冊、登入或授權存取，請使用此技能中的驗證流程參考。
快速開始
如果使用者已經有 API 金鑰，請將其放入 .env：
FIRECRAWL_API_KEY=fc-...
如果專案是自架的，也請設定：
FIRECRAWL_API_URL=https://your-firecrawl-instance.example.com
然後決定適用的整合路徑：
- 全新專案 -> 選擇目標技術棧、安裝 SDK、加入第一個 Firecrawl 呼叫，並執行冒煙測試
- 既有專案 -> 先檢查儲存庫，然後在專案已處理第三方 API 和環境變數的地方整合 Firecrawl
您需要什麼？
| 任務 | 參考 |
|---|---|
執行瀏覽器驗證流程並儲存 FIRECRAWL_API_KEY |
references/auth-flow.md |
| 安裝正確的 SDK | references/sdk-installation.md |
將憑證放入 .env 或專案設定 |
references/project-setup.md |
| 設定後選擇正確的端點 | firecrawl-build |
| 在此任務期間需要即時網頁工具 | CLI 技能已從同一個指令安裝 |
| 從已知 URL 開始實作 | firecrawl-build-scrape |
| 從查詢開始實作 | firecrawl-build-search |
文件（事實來源）
閱讀您專案語言的事實來源頁面，以取得 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 應在產品中做什麼
- 選擇符合該行為的最狹窄端點
- 在撰寫程式碼前閱讀專案語言的事實來源頁面
- 在程式碼中加入 SDK 或 REST 呼叫
- 執行冒煙測試，證明一個真實的 Firecrawl 請求成功
- 使用此儲存庫中特定端點的技能來取得實作指引
- 如果您在目前任務期間也需要即時網頁工具，CLI 技能已安裝——使用
firecrawl/cli
