Interactuar con una página extraída

Ejecuta código o un prompt de IA en la sesión del navegador asociada a un trabajo de scrape.

Usa este endpoint para seguir interactuando con el mismo estado del navegador inicializado a partir de un scrape anterior. Debes proporcionar code o prompt, pero no ambos.

POST /v2/scrape/{jobId}/interact gestiona el ciclo de vida completo:

Si todavía no existe una sesión del navegador para este trabajo de scrape, Firecrawl crea una con el mismo estado de la página que el scrape original.
Cuando se proporciona code, Firecrawl lo ejecuta en el sandbox del navegador. Cuando se proporciona prompt, un agente de IA automatiza la tarea al utilizar lenguaje natural.
Las llamadas posteriores a POST /interact con el mismo jobId reutilizan el mismo estado activo del navegador.

Cuando hayas terminado, llama a DELETE /v2/scrape/{jobId}/interact para detener la sesión.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`jobId`	string (UUID)	Sí	El ID del trabajo de scrape de `data.metadata.scrapeId` en la respuesta de scrape

Request Body

parámetro	tipo	Required	Default	descripción
`code`	string	No	—	Código que se ejecutará en el sandbox del navegador (1–100,000 caracteres). Obligatorio si no se establece `prompt`.
`prompt`	string	No	—	Tarea en lenguaje natural para el agente de IA (1–10,000 caracteres). Obligatorio si no se establece `code`.
`language`	string	No	`"node"`	Uno de `"python"`, `"node"` o `"bash"`. Solo se usa con `code`.
`timeout`	number	No	`30`	Tiempo de espera de ejecución en segundos (1–300).
`origin`	string	No	—	Etiqueta de origen opcional que se usa para telemetría.

respuesta

Field	tipo	descripción
`success`	boolean	Si la ejecución se completó sin errores
`cdpUrl`	string	URL de WebSocket sin procesar del Chrome DevTools Protocol (CDP) para la sesión del navegador. Conéctate directamente con Playwright, Puppeteer o cualquier cliente CDP
`liveViewUrl`	string	URL de vista en vivo de solo lectura para la sesión del navegador
`interactiveLiveViewUrl`	string	URL de vista en vivo interactiva (los espectadores pueden controlar el navegador)
`output`	string	Respuesta final del agente de IA (solo presente al utilizar `prompt`)
`stdout`	string	Salida estándar de la ejecución del código
`result`	string	Valor de retorno — valor de la última expresión para Node.js, instantánea final de la página para `prompt`
`stderr`	string	Salida de error estándar
`exitCode`	number	Código de salida de la ejecución (`0` = éxito)
`killed`	boolean	Si la ejecución se terminó debido al tiempo de espera
`error`	string	Mensaje de error (solo presente en caso de fallo)

solicitud de ejemplo (Code)

curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655440000/interact" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "const title = await page.title(); JSON.stringify({ title });",
    "language": "node",
    "timeout": 30
  }'

Respuesta de ejemplo (código)

{
  "success": true,
  "cdpUrl": "wss://browser.firecrawl.dev/...",
  "liveViewUrl": "https://liveview.firecrawl.dev/...",
  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
  "stdout": "",
  "result": "{\"title\":\"Example Domain\"}",
  "stderr": "",
  "exitCode": 0,
  "killed": false
}

Solicitud de ejemplo (Prompt)

curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655440000/interact" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Find the pricing section and tell me the price of the Pro plan",
    "timeout": 60
  }'

respuesta de ejemplo (Prompt)

{
  "success": true,
  "cdpUrl": "wss://browser.firecrawl.dev/...",
  "liveViewUrl": "https://liveview.firecrawl.dev/...",
  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
  "output": "The Pro plan costs $49/month and includes unlimited scrapes, priority support, and custom integrations.",
  "stdout": "...",
  "result": "...",
  "stderr": "",
  "exitCode": 0,
  "killed": false
}

Códigos de error

Status	descripción
`402`	Créditos insuficientes para una sesión del navegador
`403`	El trabajo de scrape pertenece a otro equipo
`404`	No se encontró el trabajo de scrape
`409`	Contexto de repetición no disponible — vuelve a ejecutar el scrape e inténtalo de nuevo
`410`	La sesión del navegador ya ha sido destruida
`429`	Se alcanzó el número máximo de sesiones simultáneas del navegador
`502`	Falló el servicio del navegador o la ejecución del agente de IA
`503`	La función del navegador no está configurada (solo autogestionado)

Para obtener información detallada sobre el uso con ejemplos, consulta la guía de la función Interact.

Interactuar con una página extraída

On this page