/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.
Prompts de IA
Describe qué acción quieres realizar en la página
Ejecución de código
Interactúa de forma segura mediante la ejecución de código con playwright, agent-browser
Vista en vivo
Observa o interactúa con el browser en tiempo real mediante un stream incrustable
Cómo funciona
- Haz scraping de una URL con
POST /v2/scrape. La respuesta incluye unscrapeIdendata.metadata.scrapeId. Opcionalmente, pasa unprofilepara conservar el estado del navegador entre sesiones. - Interactúa llamando a
POST /v2/scrape/{scrapeId}/interactcon unprompto con código de Playwrightcode. En la primera llamada, se reanuda la sesión de scraping y puedes empezar a interactuar con la página. - Detén la sesión con
DELETE /v2/scrape/{scrapeId}/interactcuando hayas terminado.
Inicio rápido
Response
Interactúa mediante prompts
output con la respuesta del agente:
Response
Mantén los prompts pequeños y enfocados
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
page (un objeto Page de Playwright) está disponible en Node.js y Python. El modo Bash incluye 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)
page ya está conectado al navegador.
Python
language como "python" para usar la API de Python de Playwright.
Bash (agent-browser)
@e1, @e2, …) — ideal para la automatización controlada por LLM.
vista en vivo
liveViewUrl que puedes incrustar para ver el navegador en tiempo real. Es útil para depuración, demos o para crear interfaces con navegador.
Response
Vista en vivo interactiva
interactiveLiveViewUrl. A diferencia de la vista en vivo estándar, que es solo de visualización, la vista en vivo interactiva permite a los usuarios hacer clic, escribir e interactuar con la sesión del navegador directamente a través del stream integrado. Esto resulta útil para crear interfaces de navegador orientadas al usuario, como flujos de inicio de sesión o flujos de trabajo guiados en los que los usuarios finales necesitan controlar el navegador.
Ciclo de vida de la sesión
Creación
POST /v2/scrape/{scrapeId}/interact continúa la sesión de scraping e inicia la interacción.
Reutilización
interact sobre el mismo scrapeId reutilizan la sesión existente. El navegador permanece abierto y conserva su estado entre llamadas, por lo que puedes encadenar varias interacciones:
Limpieza
Perfiles persistentes
profile, puedes guardar y reutilizar el estado del navegador (cookies, localStorage, sesiones) entre scrapes. Esto resulta útil para mantener la sesión iniciada y conservar las preferencias.
Pasa el parámetro profile al llamar a scrape. Las sesiones con el mismo nombre de perfil comparten estado.
Solo una sesión puede guardar en un perfil a la vez. Si otra sesión ya está guardando, recibirás un error
409. Aun así, puedes abrir el mismo perfil con saveChanges: false o volver a intentarlo más tarde.Cuándo usar cada opción
Interact vs Browser Sandbox: Interact se basa en la misma infraestructura que Browser Sandbox, pero ofrece una mejor interfaz para el patrón más común: hacer scraping de una página y luego profundizar. Browser Sandbox es mejor cuando necesitas una sesión del navegador independiente que no esté vinculada a un scraping específico.
Precios
- Solo código (sin
prompt) — 2 credits por minuto de sesión - Con prompts de IA — 7 credits por minuto de sesión
- scraping — se factura por separado (1 credit por scraping, más cualquier costo específico del formato)
Referencia de la API
- Ejecutar Interact —
POST /v2/scrape/{scrapeId}/interact - Detener Interact —
DELETE /v2/scrape/{scrapeId}/interact
Cuerpo de la solicitud (POST)
Respuesta
¿Tienes comentarios o necesitas ayuda? Envía un correo a help@firecrawl.com o comunícate en Discord.

