# Firecrawl MCP

Canonical: https://cqbase.net/zh/entry/firecrawl-mcp
Chinese: https://cqbase.net/zh/entry/firecrawl-mcp
English: https://cqbase.net/en/entry/firecrawl-mcp

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

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

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

## 解决什么问题

[firecrawl/firecrawl-mcp-server](https://github.com/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](https://www.firecrawl.dev/) 为准。无密钥托管的具体每日上限，官方未给出可引用的固定数字，本文不编造。

## 怎么装

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

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

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

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

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

在 Claude Code 中：

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

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

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

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

```bash
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](https://github.com/firecrawl/firecrawl-mcp-server) 使用 MIT 许可。本文依据 2026-11-15 查阅的 README、官方 MCP 文档和 [firecrawl.dev](https://www.firecrawl.dev/) 上的方案说明，用自己的话写成，供 CQBase 上下文库使用。若端点、工具范围或价格有变，以官网为准。

## 收录信息

- 作者: firecrawl
- 许可证: MIT
- 来源: https://github.com/firecrawl/firecrawl-mcp-server
- 收录: 2026-11-15
- GitHub 星标: 7824（采集 2026-11-15）

