# Firecrawl

Canonical: https://cqbase.net/zh/entry/firecrawl
Chinese: https://cqbase.net/zh/entry/firecrawl
English: https://cqbase.net/en/entry/firecrawl

> 面向 AI 代理的网页抓取与整理库，许可是 AGPL-3.0；官方 MCP 已另有条目。

firecrawl/firecrawl 是 Firecrawl 的主仓库，AGPL-3.0 许可，用来给代理提供网页抓取、搜索和整理后的页面内容。站点在 firecrawl.dev。本目录里已经有官方 MCP 封装 firecrawl-mcp-server；这一条说的是产品本身的库和许可。

使用前确认你有权抓取目标站点，并看清 AGPL-3.0 对分发和修改的要求。API 密钥有配额。抓回来的正文只当作资料，不要再发表成自己的文章。

推荐来源：

- [@0x_rody](https://x.com/0x_rody/status/2121328656094244982) 在 2026 年 11 月 14 日 的帖子里提到了这个项目（数字采集于 2026 年 11 月 15 日：26 次喜欢，0 次转发）。

## 解决什么问题

[firecrawl/firecrawl](https://github.com/firecrawl/firecrawl) 是 Firecrawl 的主仓库，也是面向 AI 代理的网页搜索、抓取、整理和交互产品。站点在 [firecrawl.dev](https://www.firecrawl.dev/)。你可以调用托管 API 和官方 SDK，也可以按文档自托管开源服务。本页写的是产品本身：REST API、Python / Node SDK、CLI，以及自托管时必须看清的许可和能力边界。

请不要和已经单独收录的官方 MCP 服务器混淆。MCP 的安装、无密钥远程端点和客户端配置，见本站条目 [Firecrawl MCP](https://cqbase.net/zh/entry/firecrawl-mcp)。那一条覆盖 MCP；这一条覆盖库、API 与自托管。两边可以对照阅读，但不要把 MCP 的工具范围抄到 SDK 上。

## 适合谁

适合要在自己的脚本、服务或数据管道里调用 Firecrawl 的人，也适合必须把抓取栈跑在自己机器上的团队。如果你只是想在 Claude、Cursor 或 Codex 里给助手加网页工具，优先看 [Firecrawl MCP](https://cqbase.net/zh/entry/firecrawl-mcp)，不必先自托管整套服务。

使用前确认你有权抓取目标站点。官方 README 写明：默认遵守 robots.txt，最终是否符合站点条款由使用者自行负责。抓回来的正文只当作资料，不要再发表成自己的文章。API 密钥以 `fc-` 开头，只放在环境变量或官方要求的请求头里。

## 怎么装

核验日期为 2026-11-16（Asia/Shanghai）。SDK 命令以官方 [Python SDK](https://docs.firecrawl.dev/sdks/python) 和 [Node SDK](https://docs.firecrawl.dev/sdks/node) 为准。主仓库许可是 AGPL-3.0；官方同时写明，SDK 和部分 UI 组件使用 MIT，以各目录的 LICENSE 为准。当天 PyPI 上 `firecrawl` 与 `firecrawl-py` 均为 4.57.0（MIT，Python 3.8+），npm 包 `firecrawl` 为 4.54.0（MIT，Node.js 18+）。两个生态的版本号并不相同，本文不加统一。

官方文档写的安装命令是 `pip install firecrawl` 和 `npm install firecrawl`。无密钥也可以先构造客户端，但只能使用文档列出的有限方法，并且按 IP 限速；更高配额和其他接口需要 `fc-` 密钥。

```bash
pip install firecrawl
# 或：npm install firecrawl
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```

Python 最小示例（把网址换成你有权访问的页面）：

```python
from firecrawl import Firecrawl

app = Firecrawl()  # 无密钥时仅限文档列出的方法；更高配额请传入 api_key
result = app.scrape("https://docs.firecrawl.dev", formats=["markdown"])
print("ok" if getattr(result, "markdown", None) else "empty-or-failed")
```

**托管方案与价格**

在 [Pricing](https://www.firecrawl.dev/pricing) 当天展示的方案是：Free 每月 1,000 积分且不需绑卡；Hobby 19 美元/月（年付 16 美元）；Standard 99 / 83 美元；Growth 399 / 333 美元；Scale 749 / 599 美元；Enterprise 需询价。积分在搜索和抓取等操作之间共用；官方以基础 scrape / crawl 约 1 积分/页、Search 每 10 条结果 2 积分等规则计费，JSON 等选项会加收。价格可能调整，以官网为准。

**自托管**

官方 [Self-hosting](https://docs.firecrawl.dev/contributing/self-host) 在核验当天钉在发行版 `v2.11.162`，用 Docker Compose 在 `http://localhost:3002` 启动 API。该快速入门关闭了 API 鉴权，官方明确写它不是生产架构，也没有把 Cloud 的全部能力包含进来。文档列出的缺口包括：截图和页面 actions 默认栈不可用，Agent、Browser、interact 等需 Cloud 或额外部署。克隆和启动命令以该页当时的钉版本为准，换发行版前要重看对应的 `docker-compose.yaml`。

## 一个实际例子

下面用官方 Python SDK 抓取文档站首页的 Markdown，用来确认安装和密钥（或无密钥限额）是否可用。请只对你有权访问的公开页面使用。本次没有实跑，因此不编造页面正文。

1. 执行 `pip install firecrawl`。若你已有 `fc-` 密钥，把它放进 `FIRECRAWL_API_KEY`，不要写进脚本。
2. 运行上一节的最小示例，目标 URL 使用 `https://docs.firecrawl.dev`。
3. 预期效果：调用返回后，你能在结果里看到 Markdown 字段，并应自己打开原页核对引言，而不是把正文再发布出去。若报错或提示需要密钥，先确认你没有调用文档写明必须带密钥的方法（例如 crawl、map、agent；SDK 文档在核验当天把无密钥范围写成 scrape、search 和 interact）。
4. 若你要用 MCP 而不是 SDK，请转到 [Firecrawl MCP](https://cqbase.net/zh/entry/firecrawl-mcp)。注意：MCP 无密钥路径在既有指南里写的是 Search、Scrape 和 Parse，与 SDK 文档的范围并不完全相同，不要混用两套说明。

## 常见坑

- 把本条写成 MCP 教程，或把 MCP 无密钥工具列表套到 SDK 上。两条条目有明确分工，官方对无密钥范围的表述也不完全一致。
- 修改或对外提供自托管服务时，未阅读 AGPL-3.0。主仓库是 AGPL-3.0；SDK 是 MIT。分发前请自己看各目录的 LICENSE。
- 把官方 Compose 快速入门直接暴露到公网。该指南默认关闭鉴权，也没有持久化存储和 TLS。
- 假设自托管等于完整 Cloud。官方对照表写明了截图、actions、Agent、Alexandria 等差异，Alexandria 也不包含在自托管服务器中。
- 把 API 密钥写进仓库或对话。密钥以 `fc-` 开头，应使用环境变量 `FIRECRAWL_API_KEY`。
- 忽略积分与失败计费规则。官方定价页写明：没有结果的 scrape 不计费，但返回 403 或 404 的页面仍会计 1 积分。以定价页为准。

## FAQ

### 这条和 Firecrawl MCP 有什么区别？

本条讲产品本身的 API、SDK、CLI 和自托管，仓库是 `firecrawl/firecrawl`。MCP 服务器在 `firecrawl/firecrawl-mcp-server`，本站条目是 [firecrawl-mcp](https://cqbase.net/zh/entry/firecrawl-mcp)。只想在编辑器里调用时，先看 MCP 那一条。

### 没有 API 密钥也能用 SDK 吗？

官方 Python / Node 文档写明：可以不传密钥就构造客户端，并在按 IP 限速的免费档里使用 `scrape`、`search` 和 `interact`；其他方法需要密钥。具体每日上限请看官方 Rate Limits，本文不编造固定数字。

### 主仓库是 AGPL-3.0，SDK 也是吗？

不一定。README 写的是：项目主体为 AGPL-3.0，SDK 和部分 UI 组件为 MIT，以具体目录的 LICENSE 为准。PyPI 与 npm 上的官方 SDK 包在核验当天标注为 MIT。

### 自托管能获得和 Cloud 一样的功能吗？

不能默认这样认为。官方自托管指南钉在 `v2.11.162` 时写明：这是可信网络上的评估部署，且默认栈缺少部分 Cloud 能力。若你需要那些能力，应使用 Cloud，或按文档单独验证外部依赖。

### 免费方案有多少积分？

[定价页](https://www.firecrawl.dev/pricing) 在 2026-11-16 写的是每月 1,000 积分、无需绑卡。计费细则（例如 Search 每 10 条结果 2 积分、JSON 格式加收）以该页为准，可能会变。

## 来源与许可

主仓库 [firecrawl/firecrawl](https://github.com/firecrawl/firecrawl) 主要使用 AGPL-3.0，SDK 等组件见各目录 LICENSE。本文依据 2026-11-16 查阅的 README、[docs.firecrawl.dev](https://docs.firecrawl.dev)、[定价页](https://www.firecrawl.dev/pricing) 和自托管指南，用自己的话写成，供 CQBase 上下文库使用。核验当天仓库最近一次推送为 2026-11-16 08:15（Asia/Shanghai）。若端点、无密钥范围或价格有变，以官网为准。

## 收录信息

- 作者: firecrawl
- 许可证: AGPL-3.0
- 来源: https://github.com/firecrawl/firecrawl
- 收录: 2026-11-15
- GitHub 星标: 201903（采集 2026-11-15）

