Documentation Index
Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
Use this file to discover all available pages before exploring further.
FIRE-1 是一款 AI 代理，通过智能的网页导航与交互增强了 Firecrawl 的抓取能力。它可处理分页、控制浏览器 actions，并在复杂的网站结构中导航，从而实现超越传统抓取方式的全面数据提取。
- 自动浏览并处理分页内容。
- 与按钮、链接、输入框和动态元素交互。
- 跨多个页面执行高级抽取任务。
要启用 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": "点击“下一页”按钮在商品列表中依次浏览，直到该按钮变为不可用为止。抓取每个访问页面的内容。"
}
}'
/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"
}
}'
FIRE-1 为 Firecrawl 带来了全新的智能能力，可在复杂的网站结构中导航、处理分页、与动态内容交互等，从而提升你的抓取任务效果。这个强大的 AI 代理能够实现超越传统抓取方式的更全面数据提取。
- 自动穿梭并处理分页内容。
- 与按钮、链接和动态元素进行交互。
- 跨多个页面执行复杂的提取任务。
启用 FIRE-1 十分简单。只需在你的 /scrape 或 /extract API 请求中包含一个 agent 对象即可：
"agent": {
"model": "FIRE-1",
"prompt": "在此填写详细的导航指令。"
}
prompt 字段，用于精确指示 FIRE-1 如何与网页交互。
下面通过一个简短示例，展示如何使用 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 可能会因任务复杂度和交互深度不同而消耗更多额度。
- 请确保你的 prompt 能清晰地引导 FIRE-1，以优化结果和效率。
立刻体验网页抓取的未来：
