Firecrawl MCP Server已精选

什么是 Firecrawl MCP Server？

Firecrawl MCP 是 Firecrawl 官方推出的 Model Context Protocol 服务器，让 AI 智能体可以在 Claude、Cursor、VS Code 等客户端中搜索网页、把页面抓取为干净的 Markdown 或 JSON、爬取和映射站点，并与实时页面交互。

你可以直接使用托管端点 https://mcp.firecrawl.dev/v2/mcp，无需安装；也可以通过 npx 或 Docker 在本地运行开源的 firecrawl-mcp 包。本地服务器同样支持自托管的 Firecrawl 实例。

如何使用 Firecrawl MCP Server？

前提条件： 要使用完整工具集，需要从 https://www.firecrawl.dev/app/api-keys 获取 Firecrawl API 密钥。只有本地 npx 安装才需要 Node.js。

托管、免密钥： 将客户端指向 https://mcp.firecrawl.dev/v2/mcp。没有密钥时，firecrawl_scrape、firecrawl_search 和 firecrawl_parse 可在限流条件下使用；爬取、映射和 agent 类工具需要密钥。

托管、登录： 使用 https://mcp.firecrawl.dev/v2/mcp-oauth，并在客户端中完成 OAuth 流程。这个 URL 是 MCP 端点，不是要在浏览器中打开的网页。

托管、API 密钥： URL 保持为 https://mcp.firecrawl.dev/v2/mcp，并发送请求头 Authorization: Bearer <FIRECRAWL_API_KEY>。README 明确提醒：不要把密钥放进 URL，也不要在与智能体的对话中粘贴密钥。

本地：

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

Claude Code

# Hosted with OAuth sign-in
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# Local server
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-YOUR_API_KEY -- npx -y firecrawl-mcp

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Cursor

打开 Cursor Settings > Features > MCP Servers，点击 + Add new global MCP server，然后输入：

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

VS Code

在 .vscode/mcp.json 中配置，运行时提示输入密钥而不是明文保存：

{
  "inputs": [
    { "type": "promptString", "id": "apiKey", "description": "Firecrawl API Key", "password": true }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": { "FIRECRAWL_API_KEY": "${input:apiKey}" }
    }
  }
}

Windsurf

将同样的 mcpServers 配置块（服务器名为 mcp-server-firecrawl）添加到 ./codeium/windsurf/model_config.json。

如需自托管，把 FIRECRAWL_API_URL 设置为你的实例地址。设置 HTTP_STREAMABLE_SERVER=true 可让本地服务器通过 Streamable HTTP 在 http://localhost:3000/mcp 提供服务。Docker 镜像发布为 ghcr.io/firecrawl/firecrawl-mcp-server。

Firecrawl MCP Server 的主要功能

• 网页搜索可返回完整页面内容，另有面向编程智能体的搜索索引，覆盖 GitHub issue、已合并的 pull request、README 和文档
• 将任意 URL 抓取为 Markdown、HTML、链接、截图，或符合你所提供 schema 的 JSON
• 爬取和映射整站，支持路径过滤、深度和页数限制
• 实时浏览器交互：在读取页面前进行点击、输入和导航
• 异步研究智能体、文档解析（PDF、Word、电子表格），以及带差异对比的定期页面监控
• 额度用量查询、自动重试和限流处理
• 支持托管（免密钥、OAuth 或 API 密钥）或通过 npx/Docker 本地运行，包括对接自托管 Firecrawl

Firecrawl MCP Server 工具

在完整配置和默认设置下，服务器会列出 27 个工具；免密钥的托管端点只提供 firecrawl_scrape、firecrawl_search 和 firecrawl_parse。

• 抓取与解析： firecrawl_scrape 读取一个已知 URL；firecrawl_parse 转换 PDF 等文档。结构化提取通过 firecrawl_scrape 加 formats: ["json"] 完成（firecrawl_extract 已弃用）。
• 发现： firecrawl_search 从查询词出发；firecrawl_map 列出站点 URL 但不抓取内容。
• 爬取： firecrawl_crawl 收集多个页面；firecrawl_check_crawl_status 查看任务进度。
• 交互： firecrawl_interact 打开实时浏览器会话；firecrawl_interact_stop 关闭会话。
• 研究： firecrawl_agent 和 firecrawl_agent_status 运行多来源研究任务；firecrawl_research_* 工具可检索 PubMed、bioRxiv、medRxiv 和 arXiv 中的论文。
• 监控： firecrawl_monitor_* 工具安排定期检查并报告变化。
• 账户与反馈： firecrawl_credit_usage、firecrawl_search_feedback 和 firecrawl_feedback。

Firecrawl MCP Server 的使用场景

• 在编程会话中拉取最新文档：“Scrape the Next.js caching docs and summarize what changed.”
• 带出处的调研：“Search for recent benchmarks of vector databases and give me the top five with links.”
• 结构化提取：“Get the plan names and prices from this pricing page as JSON.”
• 站点审查：“Map example.com and list every page under /blog.”
• 需要交互才能显示的页面：“Open this page, click Load more, then read the results.”
• 变化追踪：为竞争对手的定价页设置监控，页面变化时收到提醒。

Firecrawl MCP Server 与替代方案对比

Exa MCP Server 和 Tavily MCP 专注于面向智能体的搜索，从自有索引返回内容；Firecrawl MCP 则以抓取、爬取和与你指定的页面交互为核心。Apify Actors MCP 提供针对特定网站的现成爬虫。如果只需要简单的浏览器自动化而不依赖抓取 API，Playwright MCP 会在本地运行浏览器。

Firecrawl MCP Server 常见问题排查

• 只出现三个工具： 你正在使用免密钥的托管端点。通过 /v2/mcp-oauth 登录或添加 API 密钥，即可解锁 crawl、map、agent 等其余工具。
• 限流错误： 服务器会把 Firecrawl 的限流错误返回给客户端。登录或使用 API 密钥可获得更高限额；进行爬取时也可以调低 limit。
• Windows 上 Cursor 命令出错： 尝试 cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp"。
• 在浏览器中打开 OAuth URL 没有效果： 它是服务器 URL；请在 MCP 客户端中添加，并使用客户端的账号连接流程。
• 工具数量超过客户端上限： 设置 FIRECRAWL_NO_SEARCH_FEEDBACK=1 和/或 FIRECRAWL_NO_ENDPOINT_FEEDBACK=1，或使用仅搜索端点 https://mcp.firecrawl.dev/v2/mcp-search。