Interagir com uma página extraída
Execute código ou um prompt de IA na sessão do navegador vinculada a um job de scraping.
code ou prompt — não ambos.
POST /v2/scrape/{jobId}/interact gerencia todo o ciclo de vida:
- 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.
- Quando
codeé fornecido, o Firecrawl o executa no sandbox do navegador. Quandoprompté fornecido, um agente de IA automatiza a tarefa usando linguagem natural. - Chamadas posteriores para
POST /interactno mesmojobIdreutilizam o mesmo estado ativo do navegador.
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
Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parâmetros de caminho
O ID do job de scraping
Corpo
Código a ser executado no sandbox do navegador vinculado ao job de scraping
1 - 100000Linguagem do código a ser executado. Use node para JavaScript ou bash para comandos CLI do agent-browser.
python, node, bash Rótulo de origem opcional usado para telemetria de execução
Tempo limite de execução em segundos
1 <= x <= 300Resposta
Código executado com sucesso
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.
Mensagem de erro caso o código gere uma exceção
Código de saída do processo executado
URL da visualização em tempo real interativa (os usuários podem controlar o navegador)
Se o processo foi encerrado devido ao tempo limite
URL da visualização em tempo real somente leitura da sessão do navegador
Resposta final do agente de IA (presente apenas ao usar um prompt)
Saída padrão (alias de stdout)
Saída de erro padrão da execução do código
Saída padrão da execução do código

