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_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。托管服务器无法读取您本机上的文件，因此需要通过两次调用完成交接：
- 使用
filePath调用firecrawl_parse，获取上传命令和uploadRef。 - 在可读取该文件的机器上运行上传命令。
- 使用返回的
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 会永久删除监控，只有在用户明确要求删除时才应调用。
启用可选反馈工具
设置 FIRECRAWL_NO_SEARCH_FEEDBACK=1 可阻止注册 firecrawl_search_feedback。设置 FIRECRAWL_NO_ENDPOINT_FEEDBACK=1 可阻止注册 firecrawl_feedback。