使用 AI 构建

如果你在使用 AI 开发，Firecrawl 提供了多种资源来提升你的开发体验。Firecrawl 内置了 技能——自包含的知识包，AI 编码代理会自动发现并使用它们。只需一条安装命令，代理即可获得用于实时网页操作的 CLI 技能，以及用于产出可重复交付成果的工作流技能。将 Firecrawl 集成到应用代码中的构建技能则需要单独一步 (firecrawl setup build) 。Firecrawl 用户可以通过两种方式获取 API 密钥。请参见下方的获取凭据。

• 获取凭据
• CLI 和代理技能
• 将 Firecrawl 作为工具使用
• 代理式调试
• Firecrawl MCP 服务器
• 面向代理的 Firecrawl 文档
• 快速开始指南
• 代理接入
• SDKs

Firecrawl 用户可以通过两种方式获取 API 密钥。大多数用户应通过 Dashboard 或 CLI 登录。如果你的代理平台支持 WorkOS ID-JAG，则可以直接向 Firecrawl 注册。

我该用哪一种？ 除非你确定自己的平台支持 WorkOS ID-JAG，否则请使用 Dashboard 或 CLI。

你可能通过以下方式来到这里：

• **文档：**你已进入此页面。请选择下方与你登录方式相对应的选项。
• **API 401：**支持 ID-JAG 的代理可按照 auth.md 中第 1 步的 Discovery 流程操作。其他用户应使用 Dashboard 或 CLI。
• **直接 URL：**按照 SKILL.md 进行浏览器登录和设置，或按照 auth.md 完成 WorkOS ID-JAG 注册。

无法登录或获取密钥？ CLI、SDKs 和 REST API 支持免密钥搜索、抓取、交互和解析。托管 MCP 提供功能范围更有限的免密钥 Search、Scrape 和 Parse；其中交互需要账户连接或 API 密钥。免密钥访问会受到限流，仅作为后备方案，因此一旦可以使用免费账户或 API 密钥，请尽快切换。详情请参见 Keyless (无 API 密钥)。

获得 API 密钥后，继续阅读下方的 CLI 和代理技能。

Firecrawl CLI 让你的代理能够通过终端搜索、抓取、交互、爬取、映射、提取，并运行代理任务。它专为人类用户、AI 代理和 CI/CD 流水线打造。

Firecrawl 技能是一组自包含的知识包，Codex、Claude Code、Cursor 和 OpenCode 等 AI 编码代理会自动发现并使用它们。只需一条安装命令，即可设置用于实时网页操作的 CLI 工具，以及用于产出可重复交付成果的工作流技能。用于将 Firecrawl 集成到应用代码中的构建技能则通过 firecrawl setup build 安装：

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

• --all 会跳过代理选择，并初始化检测到的每个代理
• --browser 会自动打开浏览器进行 Firecrawl 身份验证
• 还可使用 --skip-auth、--skip-install、--skip-skills 和 --agent <name>。请参见 firecrawl init --help。

安装后，请确认一切运行正常：

firecrawl --statusfirecrawl scrape "https://firecrawl.dev"

如需稍后重新安装，或指定特定代理：

firecrawl setup skills      # CLI / 核心技能firecrawl setup build       # 构建技能firecrawl setup workflows   # 工作流技能

Firecrawl 技能分为三类。init 会安装 CLI 技能和工作流技能。运行 firecrawl setup build 可获取构建技能。每个部分都位于各自独立的 repo 中，因此可以独立演进：

• firecrawl/cli — 用于实时网页操作的 CLI 技能
• firecrawl/skills — 用于应用集成的构建技能
• firecrawl/firecrawl-workflows — 用于产出可重复交付成果的工作流技能

CLI 技能 — 用于代理会话期间进行实时网页操作：

上述安装包含两种索引技能。若只想将论文搜索技能添加到现有设置中——处理生物医学或科学文献时值得这样做——请运行：

npx skills add firecrawl/skills@firecrawl-research-index

构建技能 — 用于将 Firecrawl 集成到应用代码中：

工作流技能 — 以结果为导向的技能，可基于 Firecrawl 网页数据产出具体交付物：

CLI 技能和工作流技能通过上面的安装步骤获得。构建技能则需要单独一步：firecrawl setup build。区别在于后续的使用场景：

# 进行网页搜索firecrawl search "best open-source web crawlers"# 将网页抓取为干净的 markdownfirecrawl scrape https://docs.firecrawl.dev# 爬取整个站点firecrawl crawl https://docs.firecrawl.dev

# 针对某个主题的多来源研究简报"Use firecrawl-deep-research to write a brief on AI agent frameworks"# 销售通话前的情报准备"Use firecrawl-lead-research to brief me on stripe.com before my 3pm call"# 带修复优先级的页面 SEO 审计"Use firecrawl-seo-audit on https://example.com"# 将某个站点的设计系统克隆到 DESIGN.md"Use firecrawl-website-design-clone on https://linear.app"

完整的 onboarding 说明见：

• 浏览器登录、CLI 设置、技能、MCP 和 Dashboard 密钥：firecrawl.dev/agent-onboarding/SKILL.md
• 使用 WorkOS ID-JAG 进行代理注册：firecrawl.dev/auth.md

代理可以直接获取任一文档：如需人工参与的 CLI/浏览器 onboarding，请使用 agent-onboarding/SKILL.md；如需 WorkOS ID-JAG 注册，请使用 auth.md。

Firecrawl 为代理提供了 5 个处理网页的核心工具。每个工具都对应一个 API 端点和一条 CLI 命令。代理会根据需求选择合适的工具：

# CLIfirecrawl search "latest OpenAI API pricing"

# REST APIcurl -X POST https://api.firecrawl.dev/v2/search \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"query": "latest OpenAI API pricing"}'

# CLIfirecrawl scrape https://docs.stripe.com/api/charges

# REST APIcurl -X POST https://api.firecrawl.dev/v2/scrape \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"url": "https://docs.stripe.com/api/charges"}'

# CLIfirecrawl crawl https://docs.firecrawl.dev --limit 50

# REST APIcurl -X POST https://api.firecrawl.dev/v2/crawl \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"url": "https://docs.firecrawl.dev", "limit": 50}'

# CLIfirecrawl map https://docs.firecrawl.dev

# REST APIcurl -X POST https://api.firecrawl.dev/v2/map \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"url": "https://docs.firecrawl.dev"}'

# CLIfirecrawl scrape https://example.comfirecrawl interact "Click the pricing tab and extract the plan names"

# REST API# scrapeId 来自抓取响应（data.metadata.scrapeId）curl -X POST https://api.firecrawl.dev/v2/scrape/SCRAPE_ID/interact \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{"prompt": "Click the pricing tab and extract the plan names"}'

大多数代理工作流都会结合使用多个工具。典型模式如下：

1. 搜索 以查找相关页面 → 获取 URL 列表
2. 抓取 最相关的 URL → 获取清洗后的内容
3. 当已抓取的页面需要后续操作时，进行 交互
4. 当任务需要自主发现或结构化的多页面提取时，使用 代理

对于批量任务，代理通常会先使用 Map 发现 URL，然后再对所需页面执行 爬取 或有选择地 抓取。

当 Firecrawl 调用失败或返回异常结果时，你的代理无需升级给人工处理。/support/ask 端点是一个专为代理间通信构建的 AI 支持代理——它会诊断你的任务、账户和 API 使用方式中的问题，然后返回经过验证的答案，以及代理可直接应用的机器可读修复参数。

将它接入代理的错误处理流程中，这样它就能在抓取失败、爬取问题和配置问题出现时自行恢复——通常只需 15–30 秒，无需人工介入。

1. 你的代理描述问题 —— 用自然语言说明遇到的问题。
2. 支持代理展开调查 —— 它会检查任务日志、账户状态、文档和源代码。
3. 支持代理验证修复方案 —— 在可能的情况下，它会针对线上 Firecrawl API 测试修复效果 (例如，使用调整后的参数重新抓取) 。
4. 你的代理获得经过验证的答案 —— 包括文字形式的 answer、可直接应用的机器可读 fixParameters，以及用于说明该修复是否已测试的 validation 结果。

发送一个问题，并可附带一个可选的 rationale，为支持人员提供有关最终用户想要实现什么目标的上下文信息：

curl -X POST https://api.firecrawl.dev/v2/support/ask \  -H "Authorization: Bearer fc-YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "question": "my crawl returned 3 pages but I expected 50",    "rationale": "user is on their third failed crawl attempt today"  }'

响应中包含 answer、confidence 评分、可选的 fixParameters (例如 {"waitFor": 5000}，你的代理可在下一次调用中传入) ，以及用于说明该修复是否已在实时 API 上测试过的 validation。

MCP 是一项开放协议，可让兼容的应用程序为模型提供工具访问权限。开源的 Firecrawl MCP 服务器 支持搜索、抓取、浏览、爬取、映射、通过 Scrape JSON 进行结构化提取，以及自主代理任务。

你可以用结合上下文的方式，向你的代理提供最新的 Firecrawl 文档。代理可以直接拉取这些资源，自行完成接入——无需人工手动配置。

Docs for this page: https://docs.firecrawl.dev/ai-onboarding.md

Here are the Firecrawl docs: https://docs.firecrawl.dev/llms-full.txt

为代理最常使用的技术栈提供可直接上手的快速开始指南。让代理使用其中任意一个，即可端到端快速搭建可运行的 Firecrawl 集成。

更想交给 Cursor 处理？一键安装 Firecrawl MCP 服务器，然后在 Cursor 中开始编写 prompt：

请参见左侧边栏中的完整快速开始列表 (Express、NestJS、Fastify、Hono、Bun、Remix、Nuxt、SvelteKit、Astro、Mastra、Django、Flask、Elixir、Java、Spring Boot、.NET、ASP.NET Core 等) 。

Firecrawl 可与代理实际所处的运行时和框架配合使用——包括代码代理、代理 SDK 以及模型聚合器。大多数代码代理集成都可以通过 npx -y firecrawl-cli@latest init --all --browser 自动发现 Firecrawl 技能；其余则通过 MCP 或 REST API 将 Firecrawl 作为工具调用。

官方类型化 SDK，覆盖完整的 Firecrawl API。为你的代理选择与你技术栈相匹配的语言 SDK。

Firecrawl 还为主流 LLM SDK 和代理框架提供了原生 SDK 绑定——请参见 LLM SDKs and Frameworks，了解 OpenAI、Anthropic、Gemini、Google ADK、Vercel AI SDK、LangChain、LangGraph、LlamaIndex、Mastra 和 ElevenAgents。