# 抓取后交互 (/zh/features/interact) 抓取页面以获取干净的数据，然后调用 `/interact` 在该页面中开始执行 actions：点击按钮、填写表单、提取动态内容，或进一步深入导航。只需描述你想做什么；如果需要完全控制，也可以编写代码。
悬赏：5,000 额度奖励 ，征集对 /interact 的优质反馈

要获得奖励资格，请与我们的 Firecrawl Feedback Assistant 完成一次高质量访谈 (分享经过思考的具体用例等) 。访谈仅需几分钟，随时可以停止，对人类和代理都很友好 (只需将链接粘贴到您的代理框架中！) 。从未使用过 /interact？您的看法同样有价值。

开始访谈

请填写您的 email，才有资格获得奖励。我们会在每周末审核访谈质量。

## 选择合适的交互模型 [#选择合适的交互模型]
| 需求 | 使用 | 权威文档 | | ------------------------ | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 无需先抓取，直接启动独立的浏览器会话 | 浏览器沙箱 / 独立 交互 会话 | [Browser Sandbox](/zh/features/browser), [Create Browser Session](/zh/api-reference/endpoint/browser-create), [Execute Browser Code](/zh/api-reference/endpoint/browser-execute), [List Browser Sessions](/zh/api-reference/endpoint/browser-list), [Delete Browser Session](/zh/api-reference/endpoint/browser-delete) | | 使用 `scrapeId` 基于抓取结果继续交互 | 抓取后交互 | [Execute Interact](/zh/api-reference/endpoint/scrape-execute), [Stop Interact](/zh/api-reference/endpoint/scrape-browser-delete) | 如果工作流以 `POST /v2/scrape` 开始，且响应中包含 `data.metadata.scrapeId`，请使用绑定到抓取的 交互。当你需要具有独立生命周期的独立会话时，请使用 浏览器沙箱。 描述你希望在页面中执行的操作 通过代码安全地与 playwright、agent-browser 交互 通过可嵌入的流实时观看或与浏览器交互
## 工作原理 [#工作原理]
1. 使用 `POST /v2/scrape` **抓取**一个 URL。响应会在 `data.metadata.scrapeId` 中返回 `scrapeId`。如果你想持久保存浏览器状态，请在此请求中传入 `profile`。 2. 调用 `POST /v2/scrape/{scrapeId}/interact`，并传入 `prompt` 或 Playwright `code` 进行**交互**。此处不要传入 `profile`；交互会话会继承抓取任务中的 `profile`。 3. 完成后，使用 `DELETE /v2/scrape/{scrapeId}/interact` **停止**该会话。对于可写的 `profile`，会话停止时会保存更改。
## 快速开始 [#快速开始]
抓取页面、与其交互，然后停止会话： Python Node cURL CLI ```python from firecrawl import Firecrawl app = Firecrawl( # 无需 API 密钥即可开始使用 — 添加一个以获得更高限流： # api_key="fc-YOUR-API-KEY", ) # 1. 抓取 Amazon 首页 result = app.scrape("https://www.amazon.com", formats=["markdown"]) scrape_id = result.metadata.scrape_id # 2. 交互 — 搜索商品并获取价格 app.interact(scrape_id, prompt="Search for iPhone 16 Pro Max") response = app.interact(scrape_id, prompt="Click on the first result and tell me the price") print(response.output) # 3. 停止会话 app.stop_interaction(scrape_id) ``` ```js import { Firecrawl } from 'firecrawl'; const app = new Firecrawl({ // 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流上限： // apiKey: 'fc-YOUR-API-KEY', }); // 1. Scrape Amazon's homepage const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] }); const scrapeId = result.metadata?.scrapeId; // 2. Interact — search for a product and get its price await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' }); const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' }); console.log(response.output); // 3. Stop the session await app.stopInteraction(scrapeId); ``` ```bash # 1. 抓取 Amazon 首页 # 无需 API 密钥即可开始 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高限流： RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \ -H "Content-Type: application/json" \ -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}') SCRAPE_ID=$(echo $RESPONSE | jq -r '.data.metadata.scrapeId') # 2. 交互 — 搜索商品并获取价格 curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"prompt": "Search for iPhone 16 Pro Max"}' curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"prompt": "Click on the first result and tell me the price"}' # 3. 停止会话 curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" ``` ```bash # 1. 抓取 Amazon 首页（scrape ID 自动保存） firecrawl scrape https://www.amazon.com # 2. 交互 — 搜索商品并获取价格 firecrawl interact "Search for iPhone 16 Pro Max" firecrawl interact "Click on the first result and tell me the price" # 3. 停止会话 firecrawl interact stop ``` ```json title="Response" { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.", "exitCode": 0, "killed": false } ```
## 通过 prompt 交互 [#通过-prompt-交互]
这是与页面交互的最简单方式。用自然语言描述你的需求，它会自动点击、输入、滚动并提取数据。 Python Node cURL CLI ```python response = app.interact(scrape_id, prompt="What are the customer reviews saying about battery life?") print(response.output) ``` ```js const response = await app.interact(scrapeId, { prompt: 'What are the customer reviews saying about battery life?', }); console.log(response.output); ``` ```bash # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高的限流配额： curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{ "prompt": "What are the customer reviews saying about battery life?" }' ``` ```bash firecrawl interact "What are the customer reviews saying about battery life?" ``` 响应中包含一个 `output` 字段，其中包含代理的答案： ```json title="Response" { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "output": "Customers are generally positive about battery life. Most reviewers report 8-10 hours of use on a single charge. A few noted it drains faster with heavy multitasking.", "stdout": "...", "result": "...", "stderr": "", "exitCode": 0, "killed": false } ```
### 保持 prompt 简短且聚焦 [#保持-prompt-简短且聚焦]
当每个 prompt 都是**单一且明确的任务**时，效果最好。不要一次性要求代理完成复杂的多步骤工作流，而应将其拆分为单独的交互调用。每次调用都会复用同一个浏览器会话，因此状态会在调用之间延续。
## 运行代码 [#运行代码]
若要实现完全控制，你可以直接在浏览器沙箱中执行代码。`page` 变量 (一个 Playwright Page 对象) 可在 Node.js 和 Python 中使用。Bash 模式已预装 [agent-browser](https://github.com/vercel-labs/agent-browser)。你还可以在当前会话中截取屏幕截图：在 Node.js 中使用 `(await page.screenshot()).toString("base64")`，在 Python 中使用 `await page.screenshot(path="/tmp/screenshot.png")`，或在 Bash 中使用 `agent-browser screenshot`。
### Node.js (Playwright) [#nodejs-playwright]
默认语言。可直接编写 Playwright 代码。`page` 已连接到浏览器。 Python Node cURL CLI ```python response = app.interact(scrape_id, code=""" // 点击按钮并等待页面导航 await page.click('#next-page'); await page.waitForLoadState('networkidle'); // 从新页面提取内容 const title = await page.title(); const content = await page.$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); """) print(response.result) ``` ```js const response = await app.interact(scrapeId, { code: ` // 点击按钮并等待页面导航 await page.click('#next-page'); await page.waitForLoadState('networkidle'); // 从新页面提取内容 const title = await page.title(); const content = await page.$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); `, }); console.log(response.result); ``` ```bash # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高的限流配额： curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{ "code": "await page.click(\"#next-page\"); await page.waitForLoadState(\"networkidle\"); const title = await page.title(); JSON.stringify({ title });", "language": "node", "timeout": 30 }' ``` ```bash # 自动使用最近一次的 scrape firecrawl interact -c " await page.click('#next-page'); await page.waitForLoadState('networkidle'); const title = await page.title(); const content = await page.\$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); " # 或显式传入 scrape ID # firecrawl interact -c "await page.title()" ```
### Python [#python]
将 `language` 设置为 `"python"`，以使用 Playwright 的 Python API。 Python Node cURL CLI ```python response = app.interact( scrape_id, code=""" import json await page.click('#load-more') await page.wait_for_load_state('networkidle') items = await page.query_selector_all('.item') data = [] for item in items: text = await item.text_content() data.append(text.strip()) print(json.dumps(data)) """, language="python", ) print(response.stdout) ``` ```js const response = await app.interact(scrapeId, { code: ` import json await page.click('#load-more') await page.wait_for_load_state('networkidle') items = await page.query_selector_all('.item') data = [] for item in items: text = await item.text_content() data.append(text.strip()) print(json.dumps(data)) `, language: 'python', }); console.log(response.stdout); ``` ```bash # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高的限流配额： curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{ "code": "import json\nawait page.click(\"#load-more\")\nawait page.wait_for_load_state(\"networkidle\")\nitems = await page.query_selector_all(\".item\")\ndata = [await i.text_content() for i in items]\nprint(json.dumps(data))", "language": "python" }' ``` ```bash firecrawl interact --python -c " import json await page.click('#load-more') await page.wait_for_load_state('networkidle') items = await page.query_selector_all('.item') data = [await i.text_content() for i in items] print(json.dumps(data)) " ```
### Bash (agent-browser) [#bash-agent-browser]
[agent-browser](https://github.com/vercel-labs/agent-browser) 是一个预装在沙箱中的 CLI 工具，提供 60 多个命令。它会提供带有元素引用 (`@e1`、`@e2` 等) 的辅助功能树，非常适合由 LLM 驱动的自动化。 Python Node cURL CLI ```python # 拍摄快照以查看交互元素 snapshot = app.interact( scrape_id, code="agent-browser snapshot -i", language="bash", ) print(snapshot.stdout) # 输出： # [document] # @e1 [input type="text"] "Search..." # @e2 [button] "Search" # @e3 [link] "About" # 使用 @refs 与元素交互 app.interact( scrape_id, code='agent-browser fill @e1 "firecrawl" && agent-browser click @e2', language="bash", ) ``` ```js // 拍摄快照以查看可交互元素 const snapshot = await app.interact(scrapeId, { code: 'agent-browser snapshot -i', language: 'bash', }); console.log(snapshot.stdout); // 输出： // [document] // @e1 [input type="text"] "Search..." // @e2 [button] "Search" // @e3 [link] "About" // 使用 @refs 与元素进行交互 await app.interact(scrapeId, { code: 'agent-browser fill @e1 "firecrawl" && agent-browser click @e2', language: 'bash', }); ``` ```bash # 拍摄快照以查看交互元素 # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高限流： curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"code": "agent-browser snapshot -i", "language": "bash"}' # Interact with elements using @refs curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"code": "agent-browser fill @e1 \"firecrawl\" && agent-browser click @e2", "language": "bash"}' ``` ```bash # 拍摄快照以查看交互元素 firecrawl interact --bash -c "agent-browser snapshot -i" # 使用 @refs 与元素交互 firecrawl interact --bash -c 'agent-browser fill @e1 "firecrawl" && agent-browser click @e2' ``` 常见的 agent-browser 命令： | 命令 | 描述 | | ------------------------- | ----------------- | | `snapshot` | 带元素引用的完整辅助功能树 | | `snapshot -i` | 仅显示可交互元素 | | `click @e1` | 通过引用点击元素 | | `fill @e1 "text"` | 清空字段并输入文本 | | `type @e1 "text"` | 不清空直接输入 | | `press Enter` | 按下键盘按键 | | `scroll down 500` | 向下滚动 500 像素 | | `get text @e1` | 获取文本内容 | | `get url` | 获取当前 URL | | `wait @e1` | 等待元素出现 | | `wait --load networkidle` | 等待网络空闲 | | `find text "X" click` | 按文本查找元素并点击 | | `screenshot` | 对当前页面进行截图 | | `eval "js code"` | 在页面中运行 JavaScript |
## 实时视图 [#实时视图]
每个交互响应都会返回一个 `liveViewUrl`，你可以将其嵌入页面中，以实时查看浏览器画面。适用于调试、演示或构建基于浏览器的 UI。 ```json title="Response" { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "stdout": "", "result": "...", "exitCode": 0 } ``` ```html