SKILL.md
只读
名称
firecrawl-build-onboarding
描述
将 Firecrawl 凭据和 SDK 设置到项目中。当应用程序需要 `FIRECRAWL_API_KEY`、当代理应将 Firecrawl 添加到 `.env`、当用户想要为应用代码验证 Firecrawl，或为新的 Firecrawl 集成选择第一个 SDK 和文档时使用。此技能包含自己的浏览器认证流程，因此不依赖于网站入门技能。
Firecrawl 构建入门
在 Firecrawl 的入门流程中，使用此技能进行应用程序集成路径。
安装
如果尚未安装，一条命令即可同时设置 CLI 工具（用于实时 Web 工作）和构建技能（用于应用程序集成）：
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 |
| 在此任务期间需要实时 Web 工具 | 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 请求成功
- 使用此仓库中特定于端点的技能进行实现指导
- 如果在当前任务中还需要实时 Web 工具，CLI 技能已安装——使用
firecrawl/cli
