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

​
工具可用性

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

​
选择工具

原有的 提取 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 工具。
  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 并完成登录。
    • 完成任一更改后，启动新的客户端会话。
  • **客户端被限流：**查看当前限流规则，等待重试间隔，或从免密钥访问切换为已认证访问。