> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-8bb4v8.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl MCP 工具

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

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

<div id="tool-availability">
  ## 工具可用性
</div>

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

请先使用 [Agent MCP](/zh/mcp-server/agent-mcp) 或 [Human MCP](/zh/mcp-server/human-mcp)，选择 OAuth、API 密钥或免密钥访问方式。某些可选工具可通过环境配置或团队策略禁用。

<div id="choose-a-tool">
  ## 选择工具
</div>

| 任务       | 工具                                                 | 适用场景                                             |
| -------- | -------------------------------------------------- | ------------------------------------------------ |
| 读取单个页面   | `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` | 您想为搜索结果评分，或报告端点级别的质量问题。                          |

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

<div id="important-behavior">
  ## 重要行为
</div>

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

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

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

  <Accordion title="检查正在运行的爬取任务">
    `firecrawl_crawl` 和 `firecrawl_agent` 会返回任务标识符。使用 `firecrawl_check_crawl_status` 或 `firecrawl_agent_status` 查询状态，直到任务完成或失败。
  </Accordion>

  <Accordion title="关闭交互会话">
    使用 `url` 启动会话，或复用之前 Scrape 调用中的 `scrapeId`。工作流完成后，使用 `scrapeId` 调用 `firecrawl_interact_stop` 以释放会话。
  </Accordion>

  <Accordion title="安全管理监控">
    `firecrawl_monitor_*` 系列工具可创建、列出、更新、运行和检查定期监控。`firecrawl_monitor_delete` 会永久删除监控，只有在用户明确要求删除时才应调用。
  </Accordion>

  <Accordion title="启用可选反馈工具">
    设置 `FIRECRAWL_NO_SEARCH_FEEDBACK=1` 可阻止注册 `firecrawl_search_feedback`。设置 `FIRECRAWL_NO_ENDPOINT_FEEDBACK=1` 可阻止注册 `firecrawl_feedback`。
  </Accordion>
</AccordionGroup>

<div id="feature-guides">
  ## 功能指南
</div>

<CardGroup cols={3}>
  <Card title="抓取" href="/zh/features/scrape" icon="file-lines">
    从单个 URL 提取内容或结构化字段。
  </Card>

  <Card title="搜索" href="/zh/features/search" icon="magnifying-glass">
    查找相关的网页、新闻、图片和开发者资源。
  </Card>

  <Card title="爬取" href="/zh/features/crawl" icon="spider-web">
    遍历并提取整个网站或其中的某个部分。
  </Card>

  <Card title="解析" href="/zh/features/parse" icon="file-import">
    将文件转换为可供 LLM 使用的输出。
  </Card>

  <Card title="交互" href="/zh/features/interact" icon="arrow-pointer">
    在实时浏览器会话中操作动态页面。
  </Card>

  <Card title="代理" href="/zh/features/agent" icon="sparkles">
    运行自主的多源研究。
  </Card>

  <Card title="监控" href="/zh/features/monitoring" icon="bell">
    跟踪页面变更并接收通知。
  </Card>
</CardGroup>

<div id="troubleshooting">
  ## 故障排除
</div>

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