介绍 - Firecrawl Docs

快速开始#

Set up Firecrawl MCP

See all setup options

Run this in your terminal to add Firecrawl as a remote MCP server in Codex.

codex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp-oauth && codex mcp login firecrawl

Then enter /mcp in Codex and confirm firecrawl is connected.

Run this in your terminal to add Firecrawl as a remote MCP server in Claude Code.

claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

Then enter /mcp in Claude Code and complete the browser sign-in.

Install the hosted MCP server in one click, or copy the configuration below.

Add to Cursor

mcp.json

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

Open Cursor Settings, select MCP, and complete the Firecrawl sign-in.

Add this remote server configuration to your global or project config. OpenCode opens Firecrawl in your browser on first use.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "firecrawl": {
      "type": "remote",
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth",
      "enabled": true
    }
  }
}

直接使用 API 构建#

立即抓取你的第一个页面。此请求无需账户或 API 密钥。

cURL

# 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高的限流配额：curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \  -H "Content-Type: application/json" \  -d '{    "url": "https://firecrawl.dev",    "formats": ["markdown", "html"]  }'

需要更高限额时，请添加 API 密钥。请参见 Python SDK、Node SDK 或 API Reference，了解如何将其集成到你的应用中。

其他开始使用方式#

安装 Firecrawl CLI#

只需一条命令，即可安装 Firecrawl CLI、在浏览器中完成身份验证，并为检测到的每个编码代理添加技能。

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

Note

完成设置后请重启你的编码代理，以便其发现这些新技能。完整的配置流程请参见 CLI。

使用代理设置#

将此 Firecrawl 设置 prompt 提供给你的代理，或请参见所有 MCP 设置选项。

Note

**对于 AI 代理：**使用 llms.txt 获取文档索引，或使用 llms-full.txt 获取完整文本。

直接构建和测试#

获取你的 API 密钥

创建一个免费账户，以直接访问 API 并享有更高的限制额度

在 Playground 中试用

无需编写代码即可在浏览器中测试 Firecrawl

Firecrawl 可以做什么？#

搜索

进行网页搜索并从结果中获取完整页面内容

抓取

从任意 URL 提取内容，支持 markdown、HTML 或结构化 JSON 格式

交互

继续处理任何已抓取的页面：点击、填写表单、提取动态内容

为什么选择 Firecrawl？#

适用于 LLM 的输出：干净的 markdown、结构化 JSON、截图等。
应对复杂场景：代理、反机器人机制、JavaScript 渲染以及动态内容。
可靠：专为生产环境打造，具备高可用性和稳定一致的结果。
快速：数秒内返回结果，并针对高吞吐量进行了优化。
MCP Server：通过模型上下文协议将 Firecrawl 连接到任何 AI 工具。

悬赏：5,000 额度奖励，征集对 Firecrawl 的优质反馈

如需获得奖励资格，请通过我们的 Firecrawl Feedback Assistant 完成一次高质量访谈 (提供经过思考的具体用例等) 。只需几分钟，随时可停止，且对人类和代理都很友好 (只需将链接粘贴到您的代理工具中！) 。刚接触 Firecrawl？您的看法同样重要。

开始访谈

请填写您的 Email 以获得奖励资格。我们会在每周结束时审核访谈质量。

搜索#

进行网页搜索，并在一次调用中获取搜索结果的完整页面内容。请参见 Search 功能文档了解所有选项。

响应

SDK 会直接返回数据对象。cURL 会返回完整的 payload。

JSON

{  "success": true,  "data": {    "web": [      {        "url": "https://www.firecrawl.dev/",        "title": "Firecrawl - 面向 AI 的 Web 数据 API",        "description": "用于 AI 的网页爬取、抓取与搜索 API。为规模而建。Firecrawl 将整个互联网送达 AI 代理与开发者。",        "position": 1      },      {        "url": "https://github.com/firecrawl/firecrawl",        "title": "mendableai/firecrawl：将整站转换为可供 LLM 使用的内容 - GitHub",        "description": "Firecrawl 是一项 API 服务，接收一个 URL，对其进行爬取，并将其转换为干净的 Markdown 或结构化数据。",        "position": 2      },      ...    ],    "images": [      {        "title": "快速上手 | Firecrawl",        "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png",        "imageWidth": 5814,        "imageHeight": 1200,        "url": "https://docs.firecrawl.dev/",        "position": 1      },      ...    ],    "news": [      {        "title": "Y Combinator 创业公司 Firecrawl 准备出资 100 万美元雇用三名 AI 代理作为员工",        "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",        "snippet": "目前它在 YC 的招聘板发布了三则"仅限 AI 代理"的新职位，并为此预留了总计 100 万美元的预算。",        "date": "3 个月前",        "position": 1      },      ...    ]  }}

抓取#

抓取任意 URL，并以 markdown、HTML 或其他格式获取其内容。请参见 Scrape 功能文档了解所有选项。

响应

各 SDK 将直接返回数据对象。cURL 将按下方所示原样返回有效载荷。

{  "success": true,  "data" : {    "markdown": "Launch Week I 开始了！[查看我们第 2 天的发布 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 获享 2 个月免费...",    "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",    "metadata": {      "title": "首页 - Firecrawl",      "description": "Firecrawl 可抓取并将任何网站转换为干净的 Markdown。",      "language": "en",      "keywords": "Firecrawl,Markdown,Data,Mendable,Langchain",      "robots": "follow, index",      "ogTitle": "Firecrawl",      "ogDescription": "将任意网站转换为可直接用于 LLM 的数据。",      "ogUrl": "https://www.firecrawl.dev/",      "ogImage": "https://www.firecrawl.dev/og.png?123",      "ogLocaleAlternate": [],      "ogSiteName": "Firecrawl",      "sourceURL": "https://firecrawl.dev",      "statusCode": 200,      "contentType": "text/html"    }  }}

交互#

抓取页面后，继续与其交互：点击按钮、填写表单、提取动态内容，或继续深入导航。你可以用简单的英文描述你的需求，或编写代码以实现完全控制。请参见 Interact 功能文档了解所有选项。

响应

Response

{  "success": true,  "cdpUrl": "wss://browser.firecrawl.dev/...",  "liveViewUrl": "https://liveview.firecrawl.dev/...",  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",  "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.",  "exitCode": 0,  "killed": false}

资源#

API Reference

完整的 API 参考文档，包含交互式示例

SDKs

Python、Node.js、CLI 以及社区 SDK

Open Source

自行托管 Firecrawl 或为项目做出贡献

Integrations

LangChain、LlamaIndex、OpenAI 等

快速开始#

Set up Firecrawl MCP

直接使用 API 构建#

其他开始使用方式#

安装 Firecrawl CLI#

使用代理设置#

直接构建和测试#

Firecrawl 可以做什么？#

为什么选择 Firecrawl？#

搜索#

抓取#

交互#

更多功能#

资源#