firecrawl/cli

🔥 Firecrawl CLI – 它是什么

Firecrawl CLI 是一个命令行工具，让您可以直接从终端与 Firecrawl 平台交互。Firecrawl 是一个 AI 驱动的网络抓取、搜索与研究服务，能够：

• 爬取并抓取网页（包括 JavaScript 渲染的网站）
• 执行带有重点摘要的网络搜索
• 查询专业的开发者代码索引与庞大的研究论文索引
• 执行更高级的“代理任务”，例如 SEO 审计、潜在客户名单生成或知识库建立。

该 CLI 将所有这些功能整合为简单的指令（scrape、search、developer、research 等），并且可以安装技能，教导支持的 AI 编码代理（Claude Code、Cursor、OpenHands 等）如何自动使用 Firecrawl。

---

快速入门与安装

# 通过 npm 全局安装
npm install -g firecrawl-cli

# 一行指令安装 CLI、登录并为任何检测到的 AI 编码编辑器注册技能
npx -y firecrawl-cli@latest init -y --browser

• -y – 非交互式执行设置。
• --browser – 开启浏览器窗口进行 OAuth 风格登录。
• 除非您使用 --agent 指定范围，否则技能会自动新增至每个检测到的“工具”（Claude Code、Cursor 等）。

---

核心指令

指令	功能	常见选项
scrape <url>	从页面提取内容。默认回传 Markdown，但也可输出原始 HTML、JSON、图片、截图或 AI 生成的摘要。	--format <list>, --html, --summary, --only-main-content, --screenshot, --output <file>
search "query"	执行网络搜索（Google 风格），可选配重点标记。也可以一步抓取回传的页面。	--limit, `--sources web
developer "query"	搜索 Developer Index – 一个精选的公共仓库、GitHub issues、PRs、READMEs 与文档集合。非常适合编程问题解答。	--limit, --json, --pretty
research …	查询 Research Paper Index（约 4300 万篇摘要，主要是生物医学加上 arXiv）。支持语义搜索、论文检查、引用图扩展与阅读特定段落。	子指令：search-papers, inspect-paper, related-papers, read-paper, search-github
login	开启浏览器进行 OAuth 登录或通过 --api-key 接受 API 密钥。
setup …	将技能（CLI 原语、构建 SDK 辅助工具、工作流程配方）安装到 AI 编码代理中，或在编辑器内设置 MCP (Multi-Client Provider) 服务器。

---

技能与代理整合

Firecrawl 提供了一系列 技能 (firecrawl/skills)，教导 AI 编码代理如何：

• 使用 CLI 进行即时网络工作。
• 产出现成的交付成果（SEO 审计、潜在客户名单、研究简报等）。

您可以批量安装它们：

firecrawl setup core      # 基本抓取/搜索/爬取原语
firecrawl setup build    # SDK 风格整合辅助工具
firecrawl setup workflows# 端到端配方

或者针对单一工具：

firecrawl setup core --agent codex

setup defaults 指令可以让 Firecrawl 成为特定代理的默认网络提供者，覆盖代理原生的 fetch 实现。

---

身份验证与自托管

• 首次执行会提示登录（浏览器或手动 API 密钥）。
• 您也可以在环境变量中设置 FIRECRAWL_API_KEY。
• 对于自托管实例，请提供 --api-url <url>（或 FIRECRAWL_API_URL）。当使用自定义 URL 时，CLI 会跳过身份验证，允许在没有密钥的情况下进行本地开发。

---

工作流程示例

1. 一次性抓取为 Markdown

   firecrawl https://example.com -o page.md
   

2. 搜索并自动将前 5 个结果抓取为 JSON

   firecrawl search "AI agents" --scrape --scrape-formats markdown,links --json -o results.json
   

3. 寻找关于 CRISPR 的生物医学论文并阅读特定主张

   firecrawl research search-papers "CRISPR base editing" --limit 10
   firecrawl research read-paper doi:10.1016/j.neunet.2025.108095 \
       --question "What was the sample size?"
   

4. 仅将 Firecrawl 技能新增至 Cursor 编辑器

   firecrawl init --agent cursor
   firecrawl setup skills --agent cursor
   

---

谁适合使用？

• 开发者：构建需要可靠网络抓取或搜索功能，且不想编写自己的爬虫的应用程序。
• AI 代理（Claude Code、Cursor、OpenHands 等）：需要外挂程序来获取即时网络数据。
• 研究人员：想要快速语义访问数百万篇论文摘要。
• 产品团队：通过现成的流程技能自动化 SEO 审计、潜在客户生成或知识库建立。

---

总结

Firecrawl CLI 是一个轻量、对终端友好的封装，建立在强大的 AI 支持网络数据服务之上。它处理身份验证，提供丰富的输出格式，并能通过可重复使用的“技能”扩充 AI 编码代理，让代理无需自定义代码即可获取、抓取并对即时网络内容进行推理。