FIRE-1 代理（测试版）

FIRE-1 是一款 AI 代理，支持对网页进行智能导航与交互

FIRE-1 是一款 AI 代理，通过智能的网页导航与交互增强了 Firecrawl 的抓取能力。它可处理分页、控制浏览器 actions，并在复杂的网站结构中导航，从而实现超越传统抓取方式的全面数据提取。

​

FIRE-1 能做什么：

• 自动浏览并处理分页内容。
• 与按钮、链接、输入框和动态元素交互。
• 跨多个页面执行高级抽取任务。

​

启用 FIRE-1（代理）

要启用 FIRE-1（代理），你需要在对 scrape 或 extract 端点的 API 请求负载中包含 agent 对象。

agent 对象包含以下属性：

• model（string，可选）：指定要使用的 AI 模型。如果未提供，默认为 FIRE-1。当前仅提供 FIRE-1 模型。
• prompt（string，对 scrape 端点必填）：为 AI 代理提供指令，描述要查找的内容以及如何在网站上导航（例如如何处理分页、需要点击的按钮等）。在 /extract 中将使用 prompt 参数中提供的内容。

​

将 FIRE-1 与 /scrape 端点配合使用

你可以在 /v1/scrape 端点中使用 FIRE-1（代理），在抓取最终内容前先进行智能导航。

示例（cURL）：

curl -X POST https://api.firecrawl.dev/v1/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "url": "https://example.com/products?page=1",
      "formats": ["markdown"],
      "agent": {
        "model": "FIRE-1",
        "prompt": "点击“下一页”按钮在商品列表中依次浏览，直到该按钮变为不可用为止。抓取每个访问页面的内容。"
      }
    }'

在此示例中，已指示 FIRE-1（代理）在进行最终抓取前对产品列表进行分页。

​

使用 FIRE-1 与 /extract 端点

同样，你也可以通过 /v1/extract 端点使用 FIRE-1（代理），处理需要跨多个页面导航或与页面元素交互的复杂提取任务。

示例 (cURL) ：

curl -X POST https://api.firecrawl.dev/v1/extract \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "urls": ["https://example-forum.com/topic/123"],
      "prompt": "Extract all user comments from this forum thread.",
      "schema": {
        "type": "object",
        "properties": {
          "comments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {"type": "string"},
                "comment_text": {"type": "string"}
              },
              "required": ["author", "comment_text"]
            }
          }
        },
        "required": ["comments"]
      },
      "agent": {
        "model": "FIRE-1"
      }
    }'

在这里，代理会先与 “Load More Comments” 按钮交互，确保页面上的所有评论都已加载，然后再根据提供的 schema 和 prompt 开始提取流程。 注意： FIRE-1（代理）功能强大，但根据导航指令的复杂程度以及交互页面的数量，可能会消耗更多额度。

​

了解 FIRE-1：智能导航与交互

FIRE-1 为 Firecrawl 带来了全新的智能能力，可在复杂的网站结构中导航、处理分页、与动态内容交互等，从而提升你的抓取任务效果。这个强大的 AI 代理能够实现超越传统抓取方式的更全面数据提取。

​

FIRE-1 能做什么：

• 自动穿梭并处理分页内容。
• 与按钮、链接和动态元素进行交互。
• 跨多个页面执行复杂的提取任务。

​

如何启用 FIRE-1

启用 FIRE-1 十分简单。只需在你的 /scrape 或 /extract API 请求中包含一个 agent 对象即可：

"agent": {
  "model": "FIRE-1",
  "prompt": "在此填写详细的导航指令。"
}

注意： 发起 scrape 请求时必须提供 prompt 字段，用于精确指示 FIRE-1 如何与网页交互。

​

使用 /scrape 端点 的示例

下面通过一个简短示例，展示如何使用 FIRE-1 和 /scrape 端点 对产品列表进行分页：

curl -X POST https://api.firecrawl.dev/v1/scrape \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "url": "https://example.com/products?page=1",
    "formats": ["markdown"],
    "agent": {
      "model": "FIRE-1",
      "prompt": "Navigate through the product listings by clicking the \'Next Page\' button until disabled. Scrape each page."
    }
  }'

在这种情况下，FIRE-1 会智能处理分页，并收集所有产品。

​

注意事项

• 使用 FIRE-1 可能会因任务复杂度和交互深度不同而消耗更多额度。
• 请确保你的 prompt 能清晰地引导 FIRE-1，以优化结果和效率。

​

立即开始使用 FIRE-1

立刻体验网页抓取的未来：

• 试用 FIRE-1： 将智能导航集成到你的抓取与提取工作流中。
• 查阅文档： 在我们的完整文档中了解更多。
• 需要帮助？ 加入我们的Discord 社区或发送邮件至[e-mail]。 准备好利用 AI 赋能的抓取了吗？ 注册 Firecrawl，立即开始使用 FIRE-1。