cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

MCP

Firecrawl MCP

官方 Firecrawl MCP,让代理搜索、抓取和整理网页。

firecrawl/firecrawl-mcp-server 是 Firecrawl 的官方 MCP 服务器,MIT 许可,站点在 firecrawl.dev。它把搜索、抓取、爬取和解析暴露给代理,用来给回答补上来源,而不是让模型凭记忆描述一个网页。

使用前确认你有权抓取目标站点,并看清 API 密钥的配额。把抓回来的正文当资料,不要把它再发表成自己的文章。

本页是导读,不是原文。

解决什么问题

firecrawl/firecrawl-mcp-server 是 Firecrawl 官方 MCP 服务器(MIT 许可),用来让 Claude、Cursor、Codex 等客户端调用 Firecrawl 的搜索、抓取、解析、爬取和映射等能力。官方现在推荐优先使用托管的 HTTP 远程服务器,不一定要在本机长期跑 Node 进程。

重要区别:无需密钥的托管地址也可以用,但官方写明只开放 Search、Scrape 和 Parse,而且有速率限制;Crawl、Map、Agent 等仍需要 API 密钥。密钥以 fc- 开头,必须放在请求头里,不要写进 URL,也不要贴进对话。

适合谁

适合已经在用支持 MCP 的客户端、需要给助手受控网页抓取能力的人。官网在 2026-11-15 展示的方案是:Free 每月 1000 积分且不需绑卡;Hobby 19 美元/月(年付 16 美元);Standard 99 / 83 美元;Growth 399 / 333 美元;Scale 749 / 599 美元;Enterprise 需另行询价。积分在产品和 API 之间共用;官方以 1 积分约等于抓取或爬取 1 页基础页面来说明,搜索等操作按文档另计。价格可能调整,以 firecrawl.dev 为准。无密钥托管的具体每日上限,官方未给出可引用的固定数字,本文不编造。

怎么装

核验日期为 2026-11-15(Asia/Shanghai),命令来自仓库 README 和官方 MCP 文档。无密钥的托管入口:

https://mcp.firecrawl.dev/v2/mcp

带 OAuth 的入口是 https://mcp.firecrawl.dev/v2/mcp-oauth(这是 MCP 端点,不是浏览器里打开的页面)。用 API 密钥时,仍使用 /v2/mcp,并加上 Authorization: Bearer <FIRECRAWL_API_KEY>。

在 Codex 中添加无密钥远程服务器:

codex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp

在 Claude Code 中:

claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp

Cursor 或通用 mcp.json 的无密钥示例:

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}

若使用密钥,按官方文档在对应客户端加上 Bearer 请求头。本地运行需要 Node.js 22 或更新,可用:

env FIRECRAWL_API_KEY=fc-YOUR-API-KEY npx -y firecrawl-mcp

README 中的本地示例通常不固定版本;部分本地文档出现过 @3.33.2 这类钉版本写法,那只是该页当时的示例,不是本文另行规定的必须版本。Windows 故障排除示例使用 cmd /c "set FIRECRAWL_API_KEY=... && npx -y firecrawl-mcp"。不要把密钥写进聊天或仓库。

一个实际例子

下面使用官方无密钥工具名,抓取对象请换成你有权访问的公开页面。本次没有实跑,因此不编造页面正文。

  1. 按上一节在客户端添加 https://mcp.firecrawl.dev/v2/mcp,用 /mcp 或客户端的 MCP 列表确认已连接。
  2. 发送:Use firecrawl_search or firecrawl_scrape on https://docs.firecrawl.dev to get the current introductory description of Firecrawl. Do not invent text if the tool fails.
  3. 按官方说明,无密钥模式应能使用 firecrawl_search、firecrawl_scrape 和 firecrawl_parse。若工具报错或要求密钥,先检查是否误用了需要密钥的 crawl / map / agent。
  4. 请自己打开原页核对摘要。需要更高配额或完整工具时,再在 Firecrawl 控制台创建 fc- 密钥,并改为带 Authorization 头的配置。

常见坑

  • 把 API 密钥写进 URL。官方明确禁止,应使用 Authorization: Bearer。
  • 无密钥模式下调用 crawl、map 或 agent。这些需要密钥;无密钥只覆盖 search、scrape、parse,并有速率限制。
  • 重连 OAuth 时又添加了一条服务器。官方说明 mcp-oauth 是 MCP 端点,重新授权时不要再添加第二个条目。
  • 本地 Node 版本不够。官方本地文档要求 Node.js 22+。Cursor 的 JSON 形状在不同版本中略有差异,README 提到了 0.45.6 及以后等说明,请以当前 Cursor 文档为准。
  • 超过方案积分。积分在产品之间共用。具体消耗规则以官方定价和文档为准。

FAQ

没有 API 密钥也能用吗?

可以。用 https://mcp.firecrawl.dev/v2/mcp 即可使用 Search、Scrape 和 Parse,但有速率限制。Crawl、Map、Agent 仍需要密钥。

密钥应该放在哪里?

放在 Authorization: Bearer <FIRECRAWL_API_KEY> 请求头,或本地进程的 FIRECRAWL_API_KEY 环境变量中。不要放进 URL,也不要发给模型。官方密钥以 fc- 开头。

必须在本地用 npx 跑吗?

不是。官方推荐托管 HTTP 远程服务器。本地 npx 适合你要自己管进程、或必须走环境变量注入密钥的环境,并需要 Node.js 22+。

无密钥模式每天能用多少次?

官方只说明有速率限制,本文在 2026-11-15 没有查到可引用的固定每日数字,因此不编造。需要稳定配额请使用带密钥的方案,并以官网为准。

这是社区 MCP 还是官方 MCP?

这是 Firecrawl 官方仓库 firecrawl/firecrawl-mcp-server,许可为 MIT。

来源与许可

仓库 firecrawl/firecrawl-mcp-server 使用 MIT 许可。本文依据 2026-11-15 查阅的 README、官方 MCP 文档和 firecrawl.dev 上的方案说明,用自己的话写成,供 CQBase 上下文库使用。若端点、工具范围或价格有变,以官网为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。