Executar Código em uma Sessão

Execute código do Playwright ou do agent-browser em uma sessão autônoma do Interact.

POST /interact/{sessionId}/execute

Executar código em uma sessão de interação

cURL

curl --request POST \
  --url https://api.firecrawl.dev/v2/interact/{sessionId}/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "language": "node",
  "timeout": 150
}
'

200

{
  "error": "<string>",
  "exitCode": 123,
  "killed": true,
  "result": "<string>",
  "stderr": "<string>",
  "stdout": "<string>",
  "success": true
}

​

Cabeçalhos

Cabeçalho	Valor
Authorization	Bearer <API_KEY>
Content-Type	application/json

​

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
code	string	Sim	-	Código a ser executado (1-100.000 caracteres)
language	string	Não	"node"	Idioma do código: "python", "node" ou "bash" (para comandos de CLI do agent-browser)
timeout	number	Não	-	Tempo máximo de execução em segundos (1-300)

​

Resposta

Campo	Tipo	Descrição
success	boolean	Indica se o código foi executado com sucesso
stdout	string	Saída padrão da execução do código
result	string	Saída padrão da execução do código
stderr	string	Saída de erro padrão da execução do código
exitCode	number	Código de saída do processo executado
killed	boolean	Indica se o processo foi finalizado por tempo limite (timeout)
error	string	Mensagem de erro caso a execução falhe (apenas em caso de falha)

​

Exemplo de requisição

curl -X POST "https://api.firecrawl.dev/v2/interact/550e8400-e29b-41d4-a716-446655440000/execute" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "await page.goto(\"https://example.com\")\ntitle = await page.title()\nprint(title)",
    "language": "python"
  }'

​

Exemplo de resposta (sucesso)

{
  "success": true,
  "result": "Example Domain"
}

​

Exemplo de resposta (erro)

{
  "success": true,
  "error": "TimeoutError: page.goto: Timeout 30000ms exceeded."
}

Você é um agente de IA que precisa de uma Firecrawl API key? Veja firecrawl.dev/agent-onboarding/SKILL.md para instruções de onboarding automatizado.

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

sessionId · string · obrigatório

O ID da sessão de interação

Corpo

application/json

code · string · obrigatório

Código a ser executado no browser sandbox

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 de CLI do agent-browser.

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

timeout · integer

Tempo limite de execução em segundos

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

Resposta

200

application/json

Código executado com sucesso

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

killed · boolean

Se o processo foi encerrado devido ao tempo limite

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