Firecrawl CLI
在终端或任意编码代理中搜索、抓取并与网页交互的上下文 API 命令行工具。
- Star 数
- ★ 677
- 最近更新
- 今天
- 主语言
- TypeScript
- FA 评分
- 47/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用Codex · Claude CodeOpenAI API · Claude API（部分支持）
- 开始前需要
- 典型场景
- 需要在 Claude Code 或 Codex 中直接抓取文档、搜索网页并拿回 markdown 的开发者
- 主要局限
- 核心抓取与检索依赖 Firecrawl 云 API 与账号额度，credit-usage 显示消耗，agent 任务需用 --max-credits 控成本
- 源码审查
- 47/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Firecrawl CLI 是 Firecrawl（面向 AI 代理的上下文 API）的官方命令行客户端，通过 npm 全局安装 firecrawl-cli 后即可在终端使用。它把 scrape、search、map、crawl、batch-scrape、agent、interact、monitor 等操作封装为子命令，输出 markdown、HTML、截图或结构化 JSON，并可写入文件或通过管道交给 jq、pandoc 等工具。除通用网页抓取外，它还提供 developer（开发者索引）、gov（美国政府法规索引）和 research（约 4300 万篇论文摘要，含 search-papers、inspect-paper、related-papers、read-paper）等专用检索入口。它同时承担代理集成的角色：init 与 setup 命令可把 CLI/工作流技能安装到 Claude Code、Codex、Cursor、Windsurf 等编码代理，并通过 setup mcp 写入 Firecrawl MCP 服务器配置，还能用 setup defaults 把 Firecrawl 设为代理的默认网页提供商。运行需要 Node.js 环境与 Firecrawl API 密钥，也可用 --api-url 指向自托管实例并跳过鉴权。
命令行读取用户给出的 URL、查询词或 JSON 选项文件，调用 Firecrawl 云 API（默认 https://api.firecrawl.dev）执行任务并返回结果。scrape 提取网页内容，支持 markdown、html、rawHtml、links、images、screenshot、summary、json、changeTracking、attributes、branding 等格式，可加 --only-main-content、--wait-for、--screenshot、--schema、--actions、--redact-pii 等选项；search 在 web、news、images、alexandria 源上检索，支持 --categories research/pdf/developer/gov、--tbs 时间过滤、--scrape 回溯抓取结果；map 只列举站点 URL，crawl 与 batch-scrape 以异步任务方式运行并可用 --wait、--progress、--webhook、--cancel 管理；agent 用自然语言提示驱动提取，支持 --schema、--effort、--max-credits、--thread 续跑及 Alexandria 提供方审批；interact 在实时浏览器会话中用自然语言或 Playwright 代码（--node/--python/--bash）操作已抓取页面。输出可写 stdout、-o 文件或 --json/--pretty 结构化 JSON。setup 系列命令把技能安装到共享目录 ~/.agents/skills 并链接到检测到的编辑器，setup mcp 写入各客户端的 MCP 配置，setup defaults 关闭代理原生网页抓取以改走 Firecrawl。
- 需要在 Claude Code 或 Codex 中直接抓取文档、搜索网页并拿回 markdown 的开发者
- 要把网页内容批量转成结构化 JSON（如商品名与价格）的数据工程师
- 做 SEO 审计或竞品调研、需要 crawl 与 map 全站 URL 的营销与增长团队
- 需要检索生物医学或 arXiv 论文并沿引用图扩展的科研人员
- 要查美国联邦/州法规、判例与政府出版物的法律与合规从业者
- 希望为团队内多个编码代理统一配置网页搜索 MCP 的工程负责人
如何安装或部署这个 Agent？
需要 Node.js 与 npm。全局安装：
npm install -g firecrawl-cli或用 npx 一键完成安装 CLI、鉴权与技能安装（-y 非交互，--browser 自动打开浏览器登录）：
npx -y firecrawl-cli@latest init -y --browser也可通过安装脚本指定单一代理：
curl -fsSL https://firecrawl.dev/install.sh | bash -s -- --agent openclaw如何使用这个 Agent？
首次运行任意命令会提示鉴权，可选浏览器登录或手动输入 API 密钥：
firecrawl https://example.com
firecrawl login --api-key fc-your-api-key也可用环境变量或自托管地址：
firecrawl scrape https://example.com
export FIRECRAWL_API_KEY=fc-your-api-key
export FIRECRAWL_API_URL=http://localhost:3002
firecrawl --api-url http://localhost:3002 scrape https://example.com常用命令：
firecrawl search "AI news" --limit 10 --scrape
firecrawl map https://example.com --search blog
firecrawl crawl https://example.com --wait --progress
firecrawl agent "Extract product names and prices" --wait --json --pretty为编码代理安装技能与 MCP：
firecrawl setup core
firecrawl setup workflows
firecrawl setup mcp --agent all --global
firecrawl setup defaults --agent codex这个 Agent 有哪些优点和局限？
- 一个 CLI 覆盖 scrape、search、map、crawl、batch-scrape、agent、interact、monitor 等完整网页操作面，输出可管道或落盘
- 提供 developer、gov、research 三个专用索引，含 search-papers、related-papers、read-paper 等学术检索子命令，超出普通网页抓取
- 原生面向编码代理：setup core/build/workflows 安装技能，setup mcp 一次性写入 Claude Code、Codex、Cursor、Zed 等多客户端配置
- 支持自托管或本地实例，--api-url 指向非默认地址时自动跳过鉴权，便于本地开发
- 核心抓取与检索依赖 Firecrawl 云 API 与账号额度，credit-usage 显示消耗，agent 任务需用 --max-credits 控成本
- 仓库未声明开源许可证（License: unknown），企业采用前需自行确认授权条件
- 技能与 MCP 配置会写入用户目录（~/.agents/skills、各编辑器设置），并默认修改代理原生网页抓取行为
- CLI 默认收集匿名遥测（不含命令数据、URL 与文件内容），需手动设置 FIRECRAWL_NO_TELEMETRY=1 关闭
- agent 任务通常需 2 到 5 分钟，且部分能力（如 Alexandria 提供方）需组织管理员先在仪表盘接受数据条款
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Firecrawl CLI 当前 | 47 · 缺口较多 | — | ★ 677 | 今天 | TypeScript | Codex · Claude Code |
| Deep Code CLI | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 2.2k | 1 天前 | TypeScript | — |
| Firecrawl 网页研究 MCP | 66 · 存在缺口 | MCP 服务器免费版 + 付费版 | ★ 7.8k | 今天 | JavaScript | Claude.ai |
| wigolo | 54 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.5k | 1 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 显示 CLI 会写入多个编辑器/代理的全局配置（setup defaults、setup mcp、setup skills），并默认对所有检测到的 harness 生效，属于较宽的权限面，仅提供 --agent 与 --undo 作为收窄手段，故 least_privilege 与 user_confirmation 仅给 1。数据流方面仅说明请求发往 Firecrawl API 与自定义 --api-url，未系统说明抓取内容、API key 与遥测（更新检查、skill-lock）如何传输与存储，data_flow_transparency 与 sensitive_data_handling 各 1（虽有 --redact-pii 选项，但未说明默认行为）。依赖安全有 lockfile、固定版本 firecrawl 4.51.0、CI 中 actions 按 SHA 固定、npm publish 带 --provenance，给 2；但未提供依赖审计证据。外部副作用（修改编辑器配置、禁用原生 web 工具）有 --undo 但无事务性回滚说明，external_effects 与 rollback 各 1。来源归属仅 README 与 package.json 声明 Firecrawl，发布者未经注册表验证，source_attribution 1。
README 的命令、选项表与 package.json 的 bin/engines 基本一致，self_consistency 给 2；但 README 在 gov 命令处被截断，部分选项表不完整。依赖可用性方面有 lockfile、Node>=22 声明与 npm 发布流程，dependency_availability 给 2。失败信息方面 README 提到非交互运行打印提示、客户端配置失败会汇总，但缺少具体错误码/退出码说明，failure_messages 仅 1。
README 明确面向终端用户与多种编码代理（Claude Code、Codex、Cursor 等），场景覆盖搜索、抓取、研究、政府索引，audience_and_scenarios 给 2。能力边界有说明（如 gov 类别不可与其他类别组合、developer 命令刻意精简），capability_boundaries 给 2。触发精度方面技能安装与默认路由依赖自动检测 harness，且 npx 安装总是包含 Codex，行为边界不够精确，trigger_precision 仅 1。环境适配有自托管 --api-url、XDG/CLAUDE_CONFIG_DIR、多平台二进制，environment_fit 给 2。
README 结构清晰、按命令分节，information_architecture 给 2；安装说明详尽（npm、npx init、curl 安装脚本），install_notes 给 2；示例丰富，examples_and_faq 给 2。命名稳定性方面存在 core/build/workflows 与 skills 别名、多个 --agent 别名，命名不够稳定，naming_stability 仅 1。已知限制仅零散提及（如 Antigravity/Zed 跳过），known_limitations 给 1。许可证：package.json 声明 ISC，但描述中 license metadata 为 unknown，且仓库未见 LICENSE 文件，license 仅 1。版本号在 package.json 中，但无 CHANGELOG，versioning_changelog 给 1。维护责任仅指向 Firecrawl 与 issues 链接，发布者未验证，maintenance_responsibility 给 1。
输出可用性较好：支持 markdown/JSON/文件输出、多格式与 --pretty，output_usability 给 2。相对原生 web 工具，提供研究/开发者/政府索引与结构化抽取，marginal_value 给 2。成本收益方面依赖 Firecrawl 付费 API 与 API key，README 未说明配额、计费或离线降级，cost_benefit 仅 1。
README 的多数能力声明可追溯到具体命令与选项，但缺少指向 API 文档或测试的逐条引用，claim_traceability 给 1。跨源印证有限：README、package.json、CI 工作流相互一致（版本、发布流程），但无测试或第三方佐证，cross_source_corroboration 给 1。事实与推断分离方面，README 多为描述性陈述，未标注哪些是已验证行为，fact_inference_separation 给 1。
- setup defaults 会禁用代理原生 web 抓取/搜索并改写多个编辑器全局配置，默认对所有检测到的 harness 生效，使用前应确认 --agent 范围并保留 --undo 路径。
- CLI 依赖 Firecrawl 托管 API 与 API key，README 未说明数据留存、遥测（更新检查、skill-lock）与计费细节，敏感抓取内容需自行评估。
- 发布者身份未经 FollowAgents 注册表验证，license 元数据为 unknown 且未见 LICENSE 文件，采用前应核实授权与来源。
- README 在 gov 命令处被截断，部分选项与行为说明不完整，不能据此推断全部能力。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v1.28.0 Firecrawl CLI v1.28.0
发布说明摘录
- Merge pull request #370 from firecrawl/release/v1.28.0 - chore(release): bump version to 1.28.0 - feat: add --sort to research search-papers and print row dates (#364)在 GitHub 查看 ↗ -
v1.27.0 Firecrawl CLI v1.27.0
发布说明摘录
- chore(release): bump version to 1.27.0 (#365) - fix(update): run firecrawl update from the installed package (#366) - feat: automatically update global CLI installations (#359)在 GitHub 查看 ↗ -
v1.26.25 Firecrawl CLI v1.26.25
发布说明摘录
- fix: follow the API's main-content default and send crawl --delay in seconds (#354) - Merge pull request #358 from firecrawl/kris/retire-research-search-github - test(search): assert both github category replacements - fix(search): point the removed github category to developer - fix(research): retire search-github and point to firecrawl developer在 GitHub 查看 ↗