> ## 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. # Interact tras el scraping > Interactúa con una página que has obtenido mediante prompts o ejecutando código. Extrae una página para obtener datos limpios y luego llama a `/interact` para empezar a realizar acciones en esa página: hacer clic en botones, completar formularios, extraer contenido dinámico o navegar más a fondo. Solo describe lo que quieres hacer, o escribe código si necesitas un control total. Describe qué acción quieres realizar en la página Interactúa de forma segura mediante la ejecución de código con playwright, agent-browser Observa o interactúa con el browser en tiempo real mediante un stream incrustable
## Cómo funciona
1. **Haz scraping de** una URL con `POST /v2/scrape`. La respuesta incluye un `scrapeId` en `data.metadata.scrapeId`. Si quieres conservar el estado del navegador, pasa `profile` en esta solicitud. 2. **Interactúa** llamando a `POST /v2/scrape/{scrapeId}/interact` con un `prompt` o con código de Playwright `code`. No pases `profile` aquí; la sesión de interacción hereda el perfil del trabajo de scraping. 3. **Detén** la sesión con `DELETE /v2/scrape/{scrapeId}/interact` cuando hayas terminado. En los perfiles con escritura, los cambios se guardan cuando la sesión se detiene.
## Inicio rápido
Haz scraping de una página, interactúa con ella y detén la sesión: ```python Python theme={null} from firecrawl import Firecrawl app = Firecrawl( # No se necesita API key para comenzar — añade una para límites de tasa más altos: # api_key="fc-YOUR-API-KEY", ) # 1. Extraer la página principal de Amazon result = app.scrape("https://www.amazon.com", formats=["markdown"]) scrape_id = result.metadata.scrape_id # 2. Interactuar — buscar un producto y obtener su precio 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. Detener la sesión app.stop_interaction(scrape_id) ``` ```js Node theme={null} import { Firecrawl } from 'firecrawl'; const app = new Firecrawl({ // No se necesita API key para comenzar — agrega una para límites de tasa más altos: // apiKey: 'fc-YOUR-API-KEY', }); // 1. Extraer la página principal de Amazon const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] }); const scrapeId = result.metadata?.scrapeId; // 2. Interactuar — buscar un producto y obtener su precio 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. Detener la sesión await app.stopInteraction(scrapeId); ``` ```bash cURL theme={null} # 1. Extraer la página principal de Amazon # No se necesita API key para comenzar — añade -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos: 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. Interactuar — buscar un producto y obtener su precio 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. Detener la sesión curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" ``` ```bash CLI theme={null} # 1. Scrape la página principal de Amazon (el ID de scrape se guarda automáticamente) firecrawl scrape https://www.amazon.com # 2. Interactúa — busca un producto y obtén su precio firecrawl interact "Search for iPhone 16 Pro Max" firecrawl interact "Click on the first result and tell me the price" # 3. Detén la sesión firecrawl interact stop ``` ```json Response theme={null} { "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 } ```
## Interactúa mediante prompts
La forma más simple de interactuar con una página. Describe lo que quieres en lenguaje natural y hará clic, escribirá, se desplazará y extraerá datos automáticamente. ```python Python theme={null} response = app.interact(scrape_id, prompt="What are the customer reviews saying about battery life?") print(response.output) ``` ```js Node theme={null} const response = await app.interact(scrapeId, { prompt: 'What are the customer reviews saying about battery life?', }); console.log(response.output); ``` ```bash cURL theme={null} # No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos: 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 CLI theme={null} firecrawl interact "What are the customer reviews saying about battery life?" ``` La respuesta incluye un campo `output` con la respuesta del agente: ```json Response theme={null} { "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 } ```
### Mantén los prompts pequeños y enfocados
Los prompts funcionan mejor cuando cada uno consiste en una **única tarea clara**. En lugar de pedirle al agente que realice un flujo de trabajo complejo de varios pasos de una sola vez, divídelo en llamadas `interact` independientes. Cada llamada reutiliza la misma sesión del navegador, por lo que el estado se conserva entre una y otra.
## Ejecución de código
Para tener control total, puedes ejecutar código directamente en el sandbox del navegador. La variable `page` (un objeto Page de Playwright) está disponible en Node.js y Python. El modo Bash incluye [agent-browser](https://github.com/vercel-labs/agent-browser) preinstalado. También puedes hacer capturas de pantalla dentro de la sesión: usa `(await page.screenshot()).toString("base64")` en Node.js, `await page.screenshot(path="/tmp/screenshot.png")` en Python o `agent-browser screenshot` en Bash.
### Node.js (Playwright)
El lenguaje predeterminado. Escribe código de Playwright directamente. `page` ya está conectado al navegador. ```python Python theme={null} response = app.interact(scrape_id, code=""" // Hacer clic en un botón y esperar la navegación await page.click('#next-page'); await page.waitForLoadState('networkidle'); // Extraer contenido de la nueva página const title = await page.title(); const content = await page.$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); """) print(response.result) ``` ```js Node theme={null} const response = await app.interact(scrapeId, { code: ` // Hacer clic en un botón y esperar la navegación await page.click('#next-page'); await page.waitForLoadState('networkidle'); // Extraer contenido de la nueva página const title = await page.title(); const content = await page.$eval('.article-body', el => el.textContent); JSON.stringify({ title, content }); `, }); console.log(response.result); ``` ```bash cURL theme={null} # No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos: 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 CLI theme={null} # Usa el último scrape automáticamente 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 }); " # O pasa un ID de scrape explícitamente # firecrawl interact -c "await page.title()" ```
### Python
Configura `language` como `"python"` para usar la API de Python de Playwright. ```python Python theme={null} 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 Node theme={null} 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 cURL theme={null} # No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obtener límites de tasa más altos: 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 CLI theme={null} 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)
[agent-browser](https://github.com/vercel-labs/agent-browser) es una CLI preinstalada en el sandbox con más de 60 comandos. Proporciona un árbol de accesibilidad con referencias de elementos (`@e1`, `@e2`, ...), lo que es ideal para la automatización controlada por LLM. ```python Python theme={null} # Tomar una instantánea para ver los elementos interactivos snapshot = app.interact( scrape_id, code="agent-browser snapshot -i", language="bash", ) print(snapshot.stdout) # Salida: # [document] # @e1 [input type="text"] "Search..." # @e2 [button] "Search" # @e3 [link] "About" # Interactuar con elementos usando @refs app.interact( scrape_id, code='agent-browser fill @e1 "firecrawl" && agent-browser click @e2', language="bash", ) ``` ```js Node theme={null} // Tomar una instantánea para ver los elementos interactivos const snapshot = await app.interact(scrapeId, { code: 'agent-browser snapshot -i', language: 'bash', }); console.log(snapshot.stdout); // Salida: // [document] // @e1 [input type="text"] "Search..." // @e2 [button] "Search" // @e3 [link] "About" // Interactuar con elementos usando @refs await app.interact(scrapeId, { code: 'agent-browser fill @e1 "firecrawl" && agent-browser click @e2', language: 'bash', }); ``` ```bash cURL theme={null} # Tomar una instantánea para ver los elementos interactivos # No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para mayores límites de tasa: 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"}' # Interactuar con los elementos utilizando @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 CLI theme={null} # Tomar una instantánea para ver los elementos interactivos firecrawl interact --bash -c "agent-browser snapshot -i" # Interactuar con elementos utilizando @refs firecrawl interact --bash -c 'agent-browser fill @e1 "firecrawl" && agent-browser click @e2' ``` Comandos comunes de agent-browser: | Comando | Descripción | | ------------------------- | ------------------------------------------------------------ | | `snapshot` | Árbol de accesibilidad completo con referencias de elementos | | `snapshot -i` | Solo elementos interactivos | | `click @e1` | Hacer clic en un elemento por referencia | | `fill @e1 "text"` | Borrar el campo y escribir texto | | `type @e1 "text"` | Escribir sin borrar | | `press Enter` | Pulsar una tecla del teclado | | `scroll down 500` | Desplazarse 500 píxeles hacia abajo | | `get text @e1` | Obtener el contenido de texto | | `get url` | Obtener la URL actual | | `wait @e1` | Esperar a que aparezca el elemento | | `wait --load networkidle` | Esperar a que la red quede inactiva | | `find text "X" click` | Buscar un elemento por texto y hacer clic | | `screenshot` | Tomar una captura de pantalla de la página actual | | `eval "js code"` | Ejecutar JavaScript en la página |
## vista en vivo
Cada respuesta de interact devuelve una `liveViewUrl` que puedes incrustar para ver el navegador en tiempo real. Es útil para depuración, demos o para crear interfaces con navegador. ```json Response theme={null} { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "stdout": "", "result": "...", "exitCode": 0 } ``` ```html theme={null}