Firecrawl 官方入口怎么找：官网、下载页与文档

Firecrawl 是网页搜索与抓取 API，可为 AI Agent 输出 Markdown。官方文档在 2026 年 10 月更新过入门页，现在仍可从同一处完成 API 试用、CLI 安装和 Agent 接入，不必在多个仓库之间辨别真假。

先分清四个官方入口

搜索“Firecrawl 官网”时，最容易混淆产品官网、文档站、CLI 安装页和 GitHub 仓库。它们不是同一入口，分别负责认识产品、查接口、下载工具和阅读源码。

要找的东西	官方入口	页面或菜单路径	适合谁
产品官网	https://www.firecrawl.dev/	首页直接进入产品介绍	想确认产品、套餐和登录入口
官方文档	https://docs.firecrawl.dev/	首页右侧导航选择 Introduction、CLI、API Reference	准备调用 API 或安装工具
CLI 下载与安装	https://docs.firecrawl.dev/	Get Started → Install the Firecrawl CLI	想在终端或 Coding Agent 中使用
MCP 开源仓库	https://github.com/firecrawl/firecrawl-mcp-server#readme	仓库首页 → README	想阅读 MCP 工具、源码或自行部署

这里的“下载页”需要特别说明：Firecrawl 官方入门页提供的是 CLI 安装方式，没有把官网、API 控制台和 GitHub Releases 包装成一个单独的软件下载站。个人用户直接执行文档里的 CLI 安装命令；开发者要读源码，再进入官方 GitHub 仓库。CLI 是命令行工具，作用是在终端或 AI 编程工具中调用 Firecrawl。

安装前只准备三样东西

1. 准备一个能运行 npx 的终端。新版 CLI 的官方安装方式依赖 npx；后续直接执行安装命令，出现浏览器授权页即说明该入口可用。
2. 准备一个现代浏览器。CLI 安装会在浏览器中完成身份验证，官方文档要求安装后重启 Coding Agent，让它重新发现新增的 skills。
3. 准备 Firecrawl 账号，但不是试玩 API 的硬门槛。官方入门请求明确写着首次请求不需要账号或 API key；需要更高限额时，再到文档首页选择 “Build and test directly → Get your API key” 注册并创建密钥。

按目标选择最直接的入口

1. 只想抓一个网页，先在官网文档试用

进入 Firecrawl 文档首页，找到 “Build directly with the API”，复制页面中的 cURL 示例。它会直接请求 v2/scrape，返回 Markdown 和 HTML：

curl -s -X POST "https://api.firecrawl.dev/v2/scrape" 
-H "Content-Type: application/json" 
-d '{
  "url": "https://firecrawl.dev",
  "formats": ["markdown", "html"]
}'

这一步不要先注册账号。官方说明是“No API key needed to get started”，因此适合先确认网络、接口和返回格式都正常。输出中应出现 success 为 true，以及抓取到的 data；如果之后需要更高限额，再加入认证头：

curl -s -X POST "https://api.firecrawl.dev/v2/scrape" 
-H "Authorization: Bearer $FIRECRAWL_API_KEY" 
-H "Content-Type: application/json" 
-d '{
  "url": "https://firecrawl.dev",
  "formats": ["markdown", "html"]
}'

认证头能否生效取决于当前 shell 中 FIRECRAWL_API_KEY 是否已设置。API key 是账号内生成的密钥；不要把它写进公开仓库、截图或前端代码。

2. 要在 Cursor、Claude Code 等工具里使用，走 CLI 安装

回到文档首页的 “Other ways to get started → Install the Firecrawl CLI”，执行页面给出的完整命令：

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

这条命令会完成三件事：安装 Firecrawl CLI、在浏览器中验证身份、向检测到的 Coding Agent 添加 skills。执行结束后必须重启 Coding Agent，否则新 skills 可能不会被识别。这是官方页面明确要求的步骤，不是可选优化。

安装后想确认 Firecrawl 已被当前终端识别，可在终端运行：

firecrawl search "firecrawl web scraping" --limit 5 --pretty

该命令来自官方入门页，成功时会返回搜索结果及预览内容。--limit 5 控制本次返回数量，--pretty 用于让终端输出更易读。

3. 要查完整参数，别在首页来回搜索

文档首页提供两个机器可读索引：

https://docs.firecrawl.dev/llms.txt
https://docs.firecrawl.dev/llms-full.txt

llms.txt 是页面目录，适合先定位主题；llms-full.txt 是完整文本，适合让 AI 编程助手一次读取文档。需要人工浏览时，从左侧导航进入 API Reference，查看 V2 接口的请求参数和响应结构；只想快速试接口，则进入 Playground，在浏览器中填写 URL、选择 Markdown 或结构化输出后测试。

4. 要研究 MCP、部署服务或读源码，进入官方仓库

MCP（Model Context Protocol，模型上下文协议）是一套让 AI 客户端调用外部工具的接口规范。Firecrawl 的官方 MCP 仓库位于：

https://github.com/firecrawl/firecrawl-mcp-server

仓库首页顶部显示仓库名 firecrawl/firecrawl-mcp-server，About 区域将其标为 “Official Firecrawl MCP server”。需要下载源码时，可点击 GitHub 页面右上角 Code，再选择 Download ZIP；需要逐文件阅读，则直接进入仓库目录。仓库还提供 Cloud 与 self-hosted 支持、API 文档、云端和本地部署说明、集成示例以及 MCP 工具列表。

不要把个人 Fork 当成下载页。判断是否官方，先看仓库所有者是否为 firecrawl，再确认 About 中的官方说明；README 还把项目官网指向 firecrawl.dev。

最容易卡住的三个位置

第一处是找错“官网”。 docs.firecrawl.dev 是文档入口，www.firecrawl.dev 是产品官网，github.com/firecrawl 是源码入口。搜索结果混在一起时，先记住：查接口进文档，下载或读代码进 GitHub，看套餐和产品介绍进产品官网。

第二处是 CLI 安装后，Agent 仍提示找不到 Firecrawl 能力。 官方要求安装结束后重启 Coding Agent。原因不是重新安装，而是已经运行的 Agent 进程不会自动重新读取新增 skills；关闭当前会话或重启编辑器后再试。

第三处是把搜索摘要误当成完整网页。 官方 MCP README 明确区分：搜索结果自带摘要；若在同一次调用中通过 scrapeOptions 获取每个结果的全文，每个结果都会另行计为一次 scrape。只想找候选页面时不要请求全文；确定目标 URL 后再调用 firecrawl_scrape，否则可能得到更多内容却消耗更多额度。

另一个容易忽略的差异是，抓取已知 URL 用 firecrawl_scrape；只知道站点范围、需要先发现 URL，用 firecrawl_map；要批量读取多个页面，用 firecrawl_crawl，并通过 limit、includePaths、excludePaths 或 maxDiscoveryDepth 控制范围。入口选错时，命令可能能运行，却做了远超需要的工作。

怎么判断已经接通

API 路线：运行首次抓取命令后，应看到 success: true、目标页面内容和 data；没有 API key 时也应能完成官方所说的首次请求。

CLI 路线：浏览器认证完成后应返回终端，重启 Agent 后能找到 Firecrawl 相关 skill；执行搜索命令后应出现 firecrawl web scraping 的搜索结果。

MCP 路线：仓库 README 的功能列表应包含搜索、抓取、解析、爬取、站点映射、浏览器交互、Agent 和 Monitor 等工具。若使用的是自托管版本，还应在服务启动日志中确认 MCP 服务成功监听，再让客户端连接。

后续入口按用途收藏

• Introduction：API 入门与第一条请求
• API Reference：V2 接口参数与响应
• AI Onboarding：把 Firecrawl 接入 AI 工具
• ChatGPT 与 Codex 集成
• Claude Code 快速开始
• Firecrawl MCP Server 官方仓库
• Firecrawl 主仓库

日常使用只需收藏两个入口：查文档用 docs.firecrawl.dev，读源码或下载 ZIP 用 github.com/firecrawl/firecrawl-mcp-server。这样再遇到“官网入口”“下载页”“CLI 安装”或“接入 Agent”，可以直接落到对应位置，不必再猜链接。

参考来源

• Firecrawl for Platforms | Firecrawl
• Enterprise | Firecrawl