Executar Código no Navegador

Execute código em um ambiente de navegador isolado (sandbox).

POST /browser/{sessionId}/execute

Executar código em uma sessão de navegador

cURL

curl --request POST \
  --url https://api.firecrawl.dev/v2/browser/{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/browser/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.

Authorizations

Authorization · string · header · required

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

Path Parameters

sessionId · string · required

ID da sessão do navegador

Body

application/json

code · string · required

Código a ser executado no sandbox do navegador

Required string length: 1 - 100000

language · enum<string> · default: node

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

Available options: python, node, bash

timeout · integer

Tempo máximo de execução, em segundos

Required range: 1 <= x <= 300

Response

200

application/json

Código executado com sucesso

error · string | null

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

exitCode · integer | null

Código de saída do processo executado

killed · boolean

Indica se o processo foi encerrado por tempo limite excedido (timeout)

result · string | null

Saída padrão (também conhecida como 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