工作流
Firecrawl
面向 AI 代理的网页抓取与整理库,许可是 AGPL-3.0;官方 MCP 已另有条目。
firecrawl/firecrawl 是 Firecrawl 的主仓库,AGPL-3.0 许可,用来给代理提供网页抓取、搜索和整理后的页面内容。站点在 firecrawl.dev。本目录里已经有官方 MCP 封装 firecrawl-mcp-server;这一条说的是产品本身的库和许可。
使用前确认你有权抓取目标站点,并看清 AGPL-3.0 对分发和修改的要求。API 密钥有配额。抓回来的正文只当作资料,不要再发表成自己的文章。
推荐来源:
- @0x_rody 在 2026 年 11 月 14 日 的帖子里提到了这个项目(数字采集于 2026 年 11 月 15 日:26 次喜欢,0 次转发)。
本页是导读,不是原文。
解决什么问题
firecrawl/firecrawl 是 Firecrawl 的主仓库,也是面向 AI 代理的网页搜索、抓取、整理和交互产品。站点在 firecrawl.dev。你可以调用托管 API 和官方 SDK,也可以按文档自托管开源服务。本页写的是产品本身:REST API、Python / Node SDK、CLI,以及自托管时必须看清的许可和能力边界。
请不要和已经单独收录的官方 MCP 服务器混淆。MCP 的安装、无密钥远程端点和客户端配置,见本站条目 Firecrawl MCP。那一条覆盖 MCP;这一条覆盖库、API 与自托管。两边可以对照阅读,但不要把 MCP 的工具范围抄到 SDK 上。
适合谁
适合要在自己的脚本、服务或数据管道里调用 Firecrawl 的人,也适合必须把抓取栈跑在自己机器上的团队。如果你只是想在 Claude、Cursor 或 Codex 里给助手加网页工具,优先看 Firecrawl MCP,不必先自托管整套服务。
使用前确认你有权抓取目标站点。官方 README 写明:默认遵守 robots.txt,最终是否符合站点条款由使用者自行负责。抓回来的正文只当作资料,不要再发表成自己的文章。API 密钥以 fc- 开头,只放在环境变量或官方要求的请求头里。
怎么装
核验日期为 2026-11-16(Asia/Shanghai)。SDK 命令以官方 Python SDK 和 Node SDK 为准。主仓库许可是 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- 密钥。
pip install firecrawl
# 或:npm install firecrawl
export FIRECRAWL_API_KEY=fc-YOUR-API-KEYPython 最小示例(把网址换成你有权访问的页面):
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 当天展示的方案是: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 在核验当天钉在发行版 v2.11.162,用 Docker Compose 在 http://localhost:3002 启动 API。该快速入门关闭了 API 鉴权,官方明确写它不是生产架构,也没有把 Cloud 的全部能力包含进来。文档列出的缺口包括:截图和页面 actions 默认栈不可用,Agent、Browser、interact 等需 Cloud 或额外部署。克隆和启动命令以该页当时的钉版本为准,换发行版前要重看对应的 docker-compose.yaml。
一个实际例子
下面用官方 Python SDK 抓取文档站首页的 Markdown,用来确认安装和密钥(或无密钥限额)是否可用。请只对你有权访问的公开页面使用。本次没有实跑,因此不编造页面正文。
- 执行
pip install firecrawl。若你已有fc-密钥,把它放进FIRECRAWL_API_KEY,不要写进脚本。 - 运行上一节的最小示例,目标 URL 使用
https://docs.firecrawl.dev。 - 预期效果:调用返回后,你能在结果里看到 Markdown 字段,并应自己打开原页核对引言,而不是把正文再发布出去。若报错或提示需要密钥,先确认你没有调用文档写明必须带密钥的方法(例如 crawl、map、agent;SDK 文档在核验当天把无密钥范围写成 scrape、search 和 interact)。
- 若你要用 MCP 而不是 SDK,请转到 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。只想在编辑器里调用时,先看 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,或按文档单独验证外部依赖。
免费方案有多少积分?
定价页 在 2026-11-16 写的是每月 1,000 积分、无需绑卡。计费细则(例如 Search 每 10 条结果 2 积分、JSON 格式加收)以该页为准,可能会变。
来源与许可
主仓库 firecrawl/firecrawl 主要使用 AGPL-3.0,SDK 等组件见各目录 LICENSE。本文依据 2026-11-16 查阅的 README、docs.firecrawl.dev、定价页 和自托管指南,用自己的话写成,供 CQBase 上下文库使用。核验当天仓库最近一次推送为 2026-11-16 08:15(Asia/Shanghai)。若端点、无密钥范围或价格有变,以官网为准。