安装
npx -y firecrawl-cli@latest init -y --browser适合谁
这份指南面向需要在本机终端完成网页搜索、抓取、页面交互、站点爬取、站点地图，或直接跑智能体任务的人。官方把它同时写成命令行入口，以及可装进已检测到的编程编辑器的智能体技能。
若你的工作是先看公开页面再决定要不要改代码，而不是先自建一套抓取服务，这条路径更合适。官方说明还可以检索论文和开发者资料。它不适合只想在图形界面点几下、却不能执行终端命令的人：推荐路径会安装命令行工具、完成登录，并把技能写到已检测到的编辑器。
官方仓库是
https://github.com/firecrawl/cli
请只按该页当前写法操作，不要改用未出现在该页的安装器或技能目录。
3 分钟完成第一次尝试
只走官方推荐的一条路径。
前置条件：终端能运行 npx，并已准备 Firecrawl 访问方式。官方提示也可以设置 FIRECRAWL_API_KEY 环境变量；init 带 --browser 时会走浏览器登录。执行前先确认将登录的是你自己的账号，并看清默认会写入所有已检测到的编程编辑器，而不是某个临时目录。
安装位置：技能默认全局装到已检测到的编辑器。若只想给其中一个，官方写法是加上 --agent <agent>。
复制并执行：
npx -y firecrawl-cli@latest init -y --browser
成功信号：命令正常结束，本机能调用 firecrawl，且已检测到的编辑器出现新技能。先不要抓整站。下一步做一次可逆确认：执行 firecrawl setup core。官方说明这一组提供抓取、搜索、爬取、交互原语以及索引类技能，skills 是它的别名。命令被接受后，再到已装入的智能体里提一个只读请求，例如「用 Firecrawl 搜索某个公开文档标题，只列出结果、不要写文件」。能看到结果列表，说明技能已被找到。
需要对接 Firecrawl API 的应用集成技能时，再执行 firecrawl setup build。需要获客线索或深度研究这类端到端配方时，再执行 firecrawl setup workflows。第一次只装 core，避免一次写入全部配方。
使用案例
案例一：给当前智能体补上搜索与抓取原语。对应官方操作是 firecrawl setup core，安装 scrape、search、crawl、interact 原语以及索引技能。适合你已在某个被检测到的编辑器里工作，希望智能体先搜索或抓取公开页面，再决定是否改仓库。先完成上面的 init，再只装 core。成功时，对话里应能触发一次搜索或抓取，并看到结果摘要。官方材料没有给出技能文件夹路径，因此不要手写未出现的目录。
案例二：需要现成配方而不是单条原语。对应官方操作是 firecrawl setup workflows，材料里举了获客线索和深度研究。适合 core 已经能跑通，现在要按配方做研究。先确认 init 成功，再执行该命令；若只装到一个编辑器，加上 --agent <agent>。成功信号是该组技能出现在目标编辑器。配方内部步骤没有展开，现有材料只能确认「已安装 workflows」，不能补全未写出的子步骤。
使用边界
现有材料止于终端命令、浏览器登录或 FIRECRAWL_API_KEY，以及 core、build、workflows 三组安装。它没有规定必须支持的语言，也没有把「已检测编辑器」写成排他名单；不要从默认安装范围推断只有某几个客户端可用。
不要把这条 npx 初始化套到只允许手工复制技能文件、却没有通用命令行的环境。材料也没有给出第二市场地址，或示例密钥。
init 和 setup 会向已检测编辑器写入技能，属于有副作用的操作。执行前先确认目标编辑器，执行后只检查技能是否出现，不要立刻对未授权站点做整站爬取。抓取、交互、爬取都会访问外部站点，先用公开且可重复打开的页面验证。
FIRECRAWL_API_KEY 是环境变量名，不是要填进正文的示例密钥。不要编造未出现的子命令、技能名或安装路径。更多说明以官方仓库为准：
https://github.com/firecrawl/cli