MCP.so
登录

Firecrawl MCP Server

@Firecrawl

基本信息

传输方式

streamable-http

认证方式

请查阅提供方文档

分类

搜索

作者

Firecrawl

关于 Firecrawl MCP Server

Firecrawl 是面向 AI 代理的网页数据 API。它托管在 mcp.firecrawl.dev 的 MCP 服务器可免密钥使用搜索、抓取和解析,受每个 IP 的每日限额约束。以 bearer token 添加 Firecrawl API 密钥,或通过 OAuth URL 登录,即可解锁 crawl、map、agent、interact、监控等更多功能。

连接信息

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

接入方式

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

Firecrawl MCP Server 工具

3

Scrape one URL and return its content: markdown by default, or HTML, links, screenshots, branding data, a targeted answer, or JSON matching a supplied schema. Use it when the request identifies a page and needs its content or defined fields: the user gives a URL or names a page or PDF and wants it read or summarized, or wants prices, specs, contact details or a table from it. Use `firecrawl_search` when additional web sources are needed; on an authenticated session, `firecrawl_map` lists a site's URLs and `firecrawl_crawl` collects a set of pages. Firecrawl may serve recently indexed content; set `maxAge: 0` for a live fetch or a smaller `maxAge` to bound staleness. A successful response does not by itself confirm the page is still current. A named browser profile loads saved session data without saving changes to it. Authenticated responses can include a `metadata.scrapeId` for optional scrape feedback. On an authenticated session, `firecrawl_search` and `firecrawl_find_tools` can discover providers for the same fields across several pages; a matching provider returns typed records in one call. With `alexandria` in place of `url`, the tool runs catalogued provider capabilities instead of fetching a page. Some providers require accepted terms; when a response reports a terms requirement, direct the user to the Firecrawl dashboard URL in that response.

Search web, news, or image sources and return ranked results with query-relevant highlights. Use it for current information, or to list businesses, people, products, jobs or events with websites, prices or contacts. Each web result is a title, URL, and description; use `firecrawl_scrape` on a result URL when the excerpt is not enough. Authenticated search also returns matching Alexandria data providers in data.tools (companies, people, jobs, finance and filings, public records and government spending, real estate, places and restaurants, retail and prices, package registries and developer data, news, research, and more). Prefer a provider over scraping pages when the task needs the same fields across several entities, exact figures or timestamps, provenance, or many records; use web results when they already answer the question. Authenticated searches always add alexandria to the sources, so sources: ["web"] also returns providers; domainTools: false turns off website-matched tools only. On an authenticated session, tool matches describe available capabilities; `firecrawl_find_tools` returns their contracts and `firecrawl_scrape` with an `alexandria` body executes a selected capability. Keyless sessions get no Alexandria matches in data.tools. For a programming question, add `categories: ["developer"]`; its hits return in `data.web` with `category: "developer"`. For a legal or regulatory question, `categories: ["gov"]` returns hits in `data.web` with `category: "gov"` and cannot be combined with other categories; authenticated sessions also have `firecrawl_gov_search` as the dedicated tool. Verify gov results' issuer, jurisdiction, status, and version before citing current law. `categories: ["research"]` restricts web results to research-affiliated websites; the `firecrawl_research_*` tools are a separate surface over paper abstracts and full text (PubMed, bioRxiv, medRxiv, arXiv). Returns source-type result groups and usage metadata. Authenticated responses can include an `id` for optional search feedback.

Parse one supported document into markdown, HTML, links, summary, targeted answers, or JSON matching a schema. Supported inputs include common HTML, PDF, Word, RTF, OpenDocument, and spreadsheet files; PDF parsing can be bounded with `pdfOptions.maxPages`. Local MCP reads `filePath` from the server filesystem. Hosted MCP uses two calls: first provide `filePath` to receive upload instructions, upload locally, then call again with the returned `uploadRef`; do not send both fields together. Remote web URLs belong in `firecrawl_scrape`. Set `redactPII` to request redaction of personally identifiable information in the returned content. `zeroDataRetention` requires an eligible authenticated account; omit it for anonymous keyless use. Returns upload instructions for hosted phase one or parsed document content for the final call. Authenticated final responses can include a `data.metadata.scrapeId` for optional parse feedback.

概览

什么是 Firecrawl Remote MCP Server?

Firecrawl Remote MCP Server 是 Firecrawl 托管在 mcp.firecrawl.dev 的 MCP 端点。AI 代理可以搜索网页、把页面抓取为干净的 markdown 或 JSON,并解析文档,起步无需 API 密钥。

Firecrawl 是一个为 AI 代理打造的网页数据 API。托管服务器在同一服务上提供三种访问方式:免密钥(无需账号,Search、Scrape 和 Parse 受速率限制)、API 密钥(在同一 URL 上携带 bearer token)和登录(一个会打开浏览器登录的 OAuth URL)。使用密钥或登录后,你可以按团队套餐使用完整的 Firecrawl MCP 工具集,包括 crawl、map、agent、interact 和 monitor。

如何使用 Firecrawl Remote MCP Server?

免密钥端点使用 Streamable HTTP,无需任何凭据:

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

如需更多工具和更高额度,请创建 Firecrawl API 密钥,并在同一 URL 上以 Authorization: Bearer <key> 发送。如果你更希望通过浏览器登录,Firecrawl 另外提供了 OAuth URL:https://mcp.firecrawl.dev/v2/mcp-oauth。

Claude Code

免密钥:

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

使用 API 密钥:

claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp \
  --header "Authorization: Bearer ${FIRECRAWL_API_KEY}"

Claude Desktop 和 claude.ai

Firecrawl 推荐从 Claude 连接器目录安装其原生连接器。也可以打开 Settings > Connectors > Add custom connector,输入 https://mcp.firecrawl.dev/v2/mcp-oauth 以在浏览器中登录 Firecrawl,或输入 https://mcp.firecrawl.dev/v2/mcp 以免密钥使用。

Cursor

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${FIRECRAWL_API_KEY}"
      }
    }
  }
}

免密钥访问时去掉 headers 即可。

VS Code

{
  "servers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}

如需使用 API 密钥,添加包含 bearer token 的 headers 对象。保存后查看客户端的工具列表:免密钥连接会显示 firecrawl_search、firecrawl_scrape 和 firecrawl_parse。

Firecrawl Remote MCP Server 的主要功能

  • 免密钥起步:无需账号或密钥;免费,按 IP 地址每天同时受请求数和积分两项上限限制。
  • 适合 LLM 的干净输出:页面默认以 markdown 返回,也可以返回 HTML、链接、截图、品牌数据、针对性回答,或符合你提供的模式的 JSON。
  • 网页、新闻和图片搜索:返回带有与查询相关高亮的排序结果。
  • 文档解析:支持 HTML、PDF、Word、RTF、OpenDocument 和电子表格文件,可选 PII 脱敏。
  • 使用密钥或登录可获得完整工具集:map、crawl、自主代理研究、实时页面交互、monitor、Alexandria 数据提供方,以及研究、开发者和政府搜索索引。

Firecrawl Remote MCP Server 工具

未提供凭据时,服务器返回三个工具:

  • firecrawl_search 搜索网页、新闻或图片来源。每条网页结果包含标题、URL 和描述;摘要不够时再用 scrape 跟进。
  • firecrawl_scrape 读取一个已知 URL,并按你要求的格式返回内容,包括按模式输出的结构化 JSON。
  • firecrawl_parse 把支持的文档转换为 markdown、HTML、摘要或 JSON。由于托管服务器无法读取你的磁盘,本地文件采用两次调用的交接方式:先带 filePath 调用以获得上传命令和 uploadRef,执行上传,再带 uploadRef 调用一次。

使用 API 密钥或 OAuth 时,Firecrawl 文档还列出了 firecrawl_map、firecrawl_crawl、firecrawl_agent、firecrawl_interact 以及 firecrawl_monitor_* 系列等工具,具体取决于套餐和团队策略。

Firecrawl Remote MCP Server 的使用场景

  • 快速调研:“在网上搜索最新的 Firecrawl 发布说明,并总结这些来源。”
  • 为代理读取页面:“抓取这个定价页面,把套餐名称和价格以 JSON 返回。”
  • 解析文档:“解析这份 PDF 报告,总结前十页。”
  • 使用密钥处理更大任务:映射网站的 URL、爬取某个文档板块,或设置 monitor 报告页面变化。

Firecrawl Remote MCP Server 与替代方案对比

Firecrawl 还发布了可在本地通过 stdio 或 Streamable HTTP 运行的开源 MCP 服务器,在 mcp.so 上的页面是 Firecrawl MCP Server。本地服务器连接 Firecrawl 云 API 或自托管的 Firecrawl API,搭配自托管 API 时可以直接解析磁盘上的文件。远程服务器无需安装、可免密钥使用,本地文件则通过上传交接方式解析。

Firecrawl Remote MCP Server 常见问题排查

  • 只出现三个工具:这就是免密钥模式。添加 API 密钥请求头或通过 OAuth URL 连接,即可获得完整工具集。
  • 出现 429 错误:你的 IP 达到了免密钥模式每天的请求数或积分上限。免费的 Firecrawl 账号包含 1,000 积分和更高的限额。
  • 完全没有 Firecrawl 工具:保存 MCP 配置后,重启或重新加载客户端。
  • 在浏览器中打开 URL 失败:这些端点是供 MCP 客户端使用的服务器 URL,不是网页。

常见问题

1

Firecrawl 远程 MCP 服务器是官方的吗?

是的。它由 Firecrawl 在 mcp.firecrawl.dev 运营,并在 docs.firecrawl.dev 提供文档。

2

Firecrawl MCP 免费吗?

免密钥使用是免费的,按 IP 每天有请求数和积分上限。注册免费 API 密钥可获得 1,000 积分和更高的速率限制;更大用量则按 Firecrawl 的付费套餐计费。

3

使用 Firecrawl MCP 服务器需要 API 密钥吗?

起步不需要。Search、Scrape 和 Parse 可免密钥使用。API 密钥(bearer token)或 OAuth 登录可解锁其他工具和更高额度。

4

/v2/mcp 和 /v2/mcp-oauth 有什么区别?

`/v2/mcp` 用于免密钥访问,或在 `Authorization` 头中携带 API 密钥。`/v2/mcp-oauth` 会打开浏览器登录到你的 Firecrawl 团队,无需密钥或请求头。

5

它支持 Claude Code、Cursor 和 VS Code 吗?

支持。Firecrawl 文档介绍了 Claude Code、Codex、Cursor 及其他 JSON 配置客户端,并为 Claude 和 ChatGPT 提供了原生连接器。

6

可以撤销通过登录授予的访问权限吗?

可以。OAuth 连接可以在 Firecrawl 设置的 MCP 标签页中查看和撤销。

7

Firecrawl 远程 MCP 服务器是什么?

Firecrawl 的远程 MCP 服务器是一个托管的 Model Context Protocol 端点,地址是 https://mcp.firecrawl.dev/v2/mcp,AI 助手无需在本地安装或运行任何东西即可连接。

8

怎么连接 Firecrawl 的 MCP 服务器?

把端点 https://mcp.firecrawl.dev/v2/mcp 添加到任意支持 MCP 的客户端,比如 Claude Code、Cursor 或 VS Code。本页的接入代码块可以一步配置好每个客户端。

9

Firecrawl 的 MCP 服务器需要认证吗?

此收录尚未确认 Firecrawl 的认证要求。连接前请查阅提供方文档。

10

Firecrawl 的 MCP 服务器用的是哪种传输方式?

Firecrawl 暴露的是 streamable-http 端点,这是远程 MCP 服务器普遍使用、主流客户端都支持的传输方式。

评论