Skip to main content
POST
Interaja com a sessão do navegador associada a um job de scraping
Use este endpoint para continuar interagindo com o mesmo estado do navegador iniciado a partir de um scraping anterior. É necessário fornecer code ou prompt — não ambos. POST /v2/scrape/{jobId}/interact gerencia todo o ciclo de vida:
  1. Se ainda não existir uma sessão do navegador para este job de scraping, o Firecrawl cria uma no mesmo estado da página do scraping original.
  2. Quando code é fornecido, o Firecrawl o executa no sandbox do navegador. Quando prompt é fornecido, um agente de IA automatiza a tarefa usando linguagem natural.
  3. Chamadas posteriores para POST /interact no mesmo jobId reutilizam o mesmo estado ativo do navegador.
Quando terminar, chame DELETE /v2/scrape/{jobId}/interact para encerrar a sessão.

Parâmetros do caminho

Corpo da requisição

resposta

Exemplo de requisição (Código)

Exemplo de resposta (Código)

Exemplo de requisição (Prompt)

Exemplo de resposta (Prompt)

Códigos de erro

Para detalhes de uso e exemplos, consulte o guia do recurso Interact.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

jobId
string<uuid>
obrigatório

O ID do job de scraping

Corpo

application/json
code
string
obrigatório

Código a ser executado no sandbox do navegador vinculado ao job de scraping

Required string length: 1 - 100000
language
enum<string>
padrão:node

Linguagem do código a ser executado. Use node para JavaScript ou bash para comandos CLI do agent-browser.

Opções disponíveis:
python,
node,
bash
origin
string

Rótulo de origem opcional usado para telemetria de execução

timeout
integer
padrão:30

Tempo limite de execução em segundos

Intervalo obrigatório: 1 <= x <= 300

Resposta

Código executado com sucesso

cdpUrl
string | null

URL bruta de WebSocket do Chrome DevTools Protocol (CDP) da sessão do navegador. Use-a para se conectar diretamente com Playwright, Puppeteer ou qualquer cliente CDP.

error
string | null

Mensagem de erro caso o código gere uma exceção

exitCode
integer | null

Código de saída do processo executado

interactiveLiveViewUrl
string | null

URL da visualização em tempo real interativa (os usuários podem controlar o navegador)

killed
boolean

Se o processo foi encerrado devido ao tempo limite

liveViewUrl
string | null

URL da visualização em tempo real somente leitura da sessão do navegador

output
string | null

Resposta final do agente de IA (presente apenas ao usar um prompt)

result
string | null

Saída padrão (alias de stdout)

stderr
string | null

Saída de erro padrão da execução do código

stdout
string | null

Saída padrão da execução do código

success
boolean