安装
https://mcp.firecrawl.dev/v2/mcp适合谁
需要让 MCP 兼容的智能体直接搜索、抓取并与实时网页交互,拿到干净、可供模型使用的上下文的人。适合能先连官方托管入口、接受无密钥免费档只开放 scrape / search / parse 且有速率限制,并且知道 crawl、map、agent 仍要密钥的操作者。不适合要把密钥写进服务器 URL 或聊天窗口的人,也不适合把「已连接」理解成可以无限制爬整站。官方仓库: https://github.com/firecrawl/firecrawl-mcp-server
3 分钟完成第一次尝试
只走一条官方路径:先连托管的无密钥免费档,不要先装本地 npx,也不要先配密钥。
前置:客户端能添加远程 MCP。无密钥档上 scrape、search、parse 可工作但有速率限制;crawl、map、agent 仍需要密钥。
安装与配置位置:在客户端把服务器地址写成托管入口,不要附加任何密钥查询参数:
https://mcp.firecrawl.dev/v2/mcp
低风险动作:连接成功后应只看到 3 个工具:firecrawl_scrape、firecrawl_search、firecrawl_parse。先调用 firecrawl_search,查询词用你手头已有的主题,不要编造未在证据里出现的网站地址。若必须验证抓取,只能抓官方仓库页 https://github.com/firecrawl/firecrawl-mcp-server 这类已出现在证据里的地址。不要在第一次尝试调用需要密钥的 crawl / map / agent。
成功信号:客户端列出上述 3 个工具,search 或 scrape 返回结构化结果,或明确的速率限制说明,而不是要求在 URL 里塞密钥。若出现鉴权失败,先检查自己有没有把密钥拼进地址。
使用案例
案例一:无密钥检索或单页抓取。对应源码「search, scrape, and interact with the live web」以及托管入口仅暴露的 firecrawl_search / firecrawl_scrape / firecrawl_parse。用 search 拿一批网页摘要,或用 scrape 把单一 URL 收成干净结构化数据。证据写明无密钥档有速率限制,没有写出 search 的查询语法或 scrape 的全部参数,所以只能确认「返回干净上下文或限流错误」这一层。
案例二:带密钥后的更深能力。完整默认配置会注册 25 个工具(含反馈工具);源码点名 crawl、map、agent 以及「Deep research with autonomous agent」「Interact with pages — click, navigate, and operate」。这些会访问实时网页,点击和导航有副作用。要走这条路,必须在客户端的安全头或密钥设置里配置 Authorization: Bearer <FIRECRAWL_API_KEY>,永远不要把密钥放进服务器 URL 或对话。证据没有给出这 25 个工具的参数表,也没有写本机 npx 的无占位符启动命令,因此不要编造本地安装串。
使用边界
无密钥托管入口只开放 3 个工具,且 scrape / search / parse 有速率限制。完整档 25 个工具、以及 crawl / map / agent,都超出这条免费边界。
源码另有仅搜索入口 https://mcp.firecrawl.dev/v2/mcp-search 摘录在「exposes a fixed 6」处被截断,因此不能断言那 6 个工具的名称。
永远不要把 API 密钥放进服务器 URL 或智能体对话;只放在客户端密钥管理里。readOnlyHint 也不等于零风险:search 与 scrape 都会访问实时网页并消耗托管配额。
证据未给出固定客户端名单。本地 npx 示例在摘录里带有占位密钥,不能当作可复制的正式安装命令。需要自托管或 SSE 时,源码只列了能力名,没有逐步配置,缺的部分不要补。