Firecrawl MCP 工具

选择 Firecrawl MCP 工具，了解其可用性和运行方式。

Firecrawl MCP 提供用于查找、提取、交互和监控网页内容的工具。MCP 客户端连接后，会收到每个可用工具的完整输入 schema。

工具可用性

连接模式	可用工具
托管 OAuth	完整工具集，受套餐和团队策略限制
托管 API 密钥	完整工具集，受套餐和团队策略限制
托管免密钥	firecrawl_search、firecrawl_scrape 和 firecrawl_parse
使用 Firecrawl cloud API 的本地模式	基于 API 的工具；不支持直接解析本地文件
使用自托管 Firecrawl API 的本地模式	该部署中已启用服务支持的工具

请先阅读 开始使用，然后选择面向代理或面向用户。某些可选工具可通过环境配置或团队策略禁用。

选择工具

任务	工具	适用场景
读取单个页面	firecrawl_scrape	您知道 URL，需要页面内容或结构化字段。
提取结构化数据	使用 JSON 格式的 firecrawl_scrape	您有 URL，并希望数据符合 prompt 或 JSON schema。
发现站点 URL	firecrawl_map	您需要先找到页面，再决定要提取什么。
进行网页搜索	firecrawl_search	您有查询条件，而非已知 URL。
从第三方提供商获取数据	先使用 firecrawl_find_tools，再使用带 alexandria 的 firecrawl_scrape	您需要从 Alexandria 目录中的提供商获取类型化记录。经过身份验证的 firecrawl_search 也会在 data.tools 中返回匹配的工具。
解析文件	firecrawl_parse	您需要从 PDF、文档、电子表格或 HTML 文件中获取内容。
提取多个页面	firecrawl_crawl 和 firecrawl_check_crawl_status	您需要遍历整个站点或其中某个部分。爬取工具会轮询任务，直至其进入终态后再返回。
运行自主研究	firecrawl_agent 和 firecrawl_agent_status	任务涉及多个来源，且具体页面未知。
操作实时页面	firecrawl_interact 和 firecrawl_interact_stop	您需要点击、填写表单、导航或提取动态页面内容。
搜索科学文献	firecrawl_research_*	您需要查找论文、阅读论文中的段落，或追溯引用。搜索 PubMed、bioRxiv、medRxiv 和 arXiv 论文摘要的研究索引。
解答编程问题	firecrawl_developer_search	您需要来自 issue、已合并的 pull request、README 和精选文档的一手答案。
监控变化	firecrawl_monitor_*	您需要定期检查、差异对比，以及 webhook 或电子邮件通知。
发送产品反馈	firecrawl_search_feedback 和 firecrawl_feedback	您想为搜索结果评分，或报告端点级别的质量问题。

原有的 提取 MCP 工具已弃用，不属于当前工具集的一部分。对于已知页面，请使用 JSON 格式的 抓取；当 Firecrawl 必须发现来源时，请使用 代理。请参见选择数据提取器了解完整对比。

请使用 MCP 客户端针对当前参数显示的 schema。下方的功能指南介绍 Firecrawl 的底层行为，不会在此重复这些 schema。

重要行为

解析本地文件

连接到自托管 Firecrawl API 的本地 MCP 服务器可直接读取 filePath。托管服务器无法读取您本机上的文件，因此需要通过两次调用完成交接：

1. 使用 filePath 调用 firecrawl_parse，获取上传命令和 uploadRef。
2. 在可读取该文件的机器上运行上传命令。
3. 使用返回的 uploadRef 再次调用 firecrawl_parse。

上传命令使用短期有效的签名上传目标，不包含您的 Firecrawl API 密钥。对于公开文档 URL，请使用 firecrawl_scrape。

检查正在运行的爬取任务

firecrawl_crawl 通常会启动爬取，并在返回前轮询至终态。如果等待超时，请使用 firecrawl_check_crawl_status 和爬取 ID 恢复该任务。对于在当前 MCP 调用之外创建的爬取，也请使用相同的状态工具。

firecrawl_agent 是异步的：它会返回任务标识符，firecrawl_agent_status 会检查该任务，直到其完成或失败。

关闭交互会话

使用 url 启动会话，或复用之前抓取调用中的 scrapeId。工作流完成后，使用 scrapeId 调用 firecrawl_interact_stop 以释放会话。

安全管理监控

firecrawl_monitor_* 系列工具可创建、列出、更新、运行和检查定期监控。firecrawl_monitor_delete 会永久删除监控，只有在用户明确要求删除时才应调用。

使用 Alexandria 数据工具

Alexandria 工具需要经过身份验证的会话。免密钥会话无法使用 Alexandria 工具。

1. 发现。 经过身份验证的 firecrawl_search 默认使用 sources: ["web", "alexandria"]，并在 data.tools 中返回匹配的工具。使用 sources: ["alexandria"] 可仅返回工具，使用 sources: ["web"] 则跳过语义化工具发现。
2. 查看。 不带参数调用 firecrawl_find_tools，可依次浏览类别、提供商和工具。使用 query 或 urls 查找适用于某项任务或某个网站的工具。使用 capabilities 读取工具的完整契约。按照返回的 nextTool 执行下一步。
3. 运行。 调用 firecrawl_scrape 时传入 alexandria: {provider, capability, options}，而不是 url。发送最多包含 10 个调用的数组，即可一次性同时运行。data.alexandria 中的每个结果都包含 data 或 error。

发现环节免费。每次运行按对应工具标注的价格计费。如果某个提供商要求接受条款，工具会返回 THIRD_PARTY_DATA_TERMS_REQUIRED 以及 requiresAction.url。请将该 URL 提供给组织管理员，由其在 Firecrawl Dashboard 中接受条款。代理不得自行接受条款。管理员确认后，再次发送相同的调用即可。

启用可选反馈工具

设置 FIRECRAWL_NO_SEARCH_FEEDBACK=1 可阻止注册 firecrawl_search_feedback。设置 FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 可阻止注册 firecrawl_feedback。

功能指南

抓取

从单个 URL 提取内容或结构化字段。

搜索

查找相关的网页、新闻、图片和开发者资源。

研究索引

搜索论文、阅读段落并追踪引用。

开发者索引

根据 issue、PR、README 和文档回答编程问题。

爬取

遍历并提取整个网站或其中的某个部分。

解析

将文件转换为可供 LLM 使用的输出。

交互

在实时浏览器会话中操作动态页面。

代理

运行自主的多源研究。

监控

跟踪页面变更并接收通知。

Alexandria

查找并运行第三方提供商的数据工具。

故障排除

• **某个工具缺失：**确认 开始使用 的连接模式，重新连接或重启客户端，并检查团队策略是否禁用了可选工具。
• **客户端返回 401：**先检查配置的服务器 URL。
  • 如果配置的 URL 为 /v2/mcp-oauth，请通过客户端重新登录。
  • 如果为 /v2/mcp，请更换该服务器的 API 密钥，或将现有服务器 URL 更新为 /v2/mcp-oauth 并完成登录。
  • 完成任一更改后，启动新的客户端会话。
• **客户端被限流：**查看当前限流规则，等待重试间隔，或从免密钥访问切换为已认证访问。