Firecrawl MCP 工具

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

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

工具可用性

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

请先使用 Agent MCP 或 Human MCP，选择 OAuth、API 密钥或免密钥访问方式。某些可选工具可通过环境配置或团队策略禁用。

选择工具

任务	工具	适用场景
读取单个页面	firecrawl_scrape	您知道 URL，需要页面内容或结构化字段。
发现站点 URL	firecrawl_map	您需要先找到页面，再决定要提取什么。
进行网页搜索	firecrawl_search	您有查询条件，而非已知 URL。
解析文件	firecrawl_parse	您需要从 PDF、文档、电子表格或 HTML 文件中获取内容。
提取多个页面	firecrawl_crawl 和 firecrawl_check_crawl_status	您需要遍历整个站点或其中某个部分。爬取工具会轮询任务，直至其进入终态后再返回。
运行自主研究	firecrawl_agent 和 firecrawl_agent_status	任务涉及多个来源，且具体页面未知。
操作实时页面	firecrawl_interact 和 firecrawl_interact_stop	您需要点击、填写表单、导航或提取动态页面内容。
研究论文和仓库	firecrawl_research_*	您需要发现或阅读论文、查找相关工作，或搜索公开仓库。
解答编程问题	firecrawl_developer_search	您需要来自 issue、已合并的 pull request、README 和精选文档的一手答案。
监控变化	firecrawl_monitor_*	您需要定期检查、差异对比，以及 webhook 或电子邮件通知。
发送产品反馈	firecrawl_search_feedback 和 firecrawl_feedback	您想为搜索结果评分，或报告端点级别的质量问题。

请使用 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_agent 会返回任务标识符。使用 firecrawl_check_crawl_status 或 firecrawl_agent_status 查询状态，直到任务完成或失败。

关闭交互会话

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

安全管理监控

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

启用可选反馈工具

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

功能指南

抓取

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

搜索

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

爬取

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

解析

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

交互

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

代理

运行自主的多源研究。

监控

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

故障排除

• **某个工具缺失：**确认 Agent MCP 或 Human MCP 的连接模式，重新连接或重启客户端，并检查团队策略是否禁用了可选工具。
• **客户端返回 401：**重新进行 OAuth 登录，或确认配置的 Bearer 令牌环境变量中包含当前有效的 Firecrawl API 密钥。
• **客户端被限流：**查看当前限流规则，等待重试间隔，或从免密钥访问切换为已认证访问。