Pular para o conteúdo principal
O Firecrawl Browser Sandbox oferece para seus agentes um ambiente de navegador seguro e totalmente gerenciado. Sem configuração local, sem instalações de Chromium, sem problemas de compatibilidade de drivers. Agent browser e Playwright já vêm pré-instalados. Cada sessão é executada em um sandbox isolado e descartável, que escala sem necessidade de gerenciar infraestrutura. Disponível via API, CLI (Bash / agent-browser, Python, Node), Node SDK, Python SDK, Vercel AI SDK e MCP Server. Para adicionar suporte de navegador a um agente de código de IA (Claude Code, Codex, Open Code, Cursor, etc.), instale a skill do Firecrawl: 
npx -y firecrawl-cli@latest init --all --browser
Você também pode instalar o Firecrawl CLI ou deixar que o agente o instale para você, como mostrado acima: 
npm install -g firecrawl-cli

​
Início rápido

Crie uma sessão, execute código e feche-a: 
// npm install @mendable/firecrawl-js
import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

// 1. Iniciar uma sessão
const session = await firecrawl.browser();
console.log(session.cdpUrl); // wss://cdp-proxy.firecrawl.dev/cdp/...

// 2. Execute code
const result = await firecrawl.browserExecute(session.id, {
  code: `
    await page.goto("https://news.ycombinator.com");
    const title = await page.title();
    console.log(title);
  `,
  language: "node",
});
console.log(result.result); // "Hacker News"

// 3. Close
await firecrawl.deleteBrowser(session.id);
  • Sem instalação de drivers - Sem binário do Chromium, sem playwright install, sem problemas de compatibilidade de drivers
  • Python, JavaScript e Bash - Envie código via API, CLI ou SDK e receba os resultados de volta. As três linguagens são executadas remotamente no sandbox
  • agent-browser - CLI pré-instalada com mais de 40 comandos. Agentes de IA escrevem comandos Bash simples em vez de código Playwright
  • Playwright carregado - Playwright vem pré-instalado no sandbox. Agentes podem escrever código Playwright se preferirem.
  • Acesso ao CDP - Conecte sua própria instância do Playwright via WebSocket quando precisar de controle total
  • Visualização em tempo real - Assista às sessões em tempo real por meio de uma URL de transmissão incorporável

​
Iniciar uma sessão

Retorna um ID de sessão, uma URL do CDP e uma URL de visualização em tempo real. 
import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const session = await firecrawl.browser({
  ttl: 120,
  activityTtl: 60,
});

console.log(session.id);
console.log(session.cdpUrl);      // wss://cdp-proxy.firecrawl.dev/cdp/...
console.log(session.liveViewUrl); // https://liveview.firecrawl.dev/...
Response
{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000"
}

​
Executar código

import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const result = await firecrawl.browserExecute("YOUR_SESSION_ID", {
  code: 'await page.goto("https://example.com"); const title = await page.title(); console.log(title);',
  language: "node",
});

console.log(result);
Response
{
  "success": true,
  "result": "Example Domain"
}

​
agent-browser (Modo Bash)

agent-browser é uma CLI de navegador headless pré-instalada em cada sandbox. Em vez de escrever código em Playwright, os agentes enviam comandos bash simples. A CLI injeta automaticamente --cdp para que o agent-browser se conecte automaticamente à sua sessão ativa.

​
Forma abreviada

A maneira mais rápida de usar o browser. Tanto a forma abreviada quanto execute enviam comandos para o agent-browser automaticamente. A forma abreviada apenas ignora o execute e inicia uma sessão automaticamente, se necessário: 
firecrawl browser "open https://example.com"
firecrawl browser "snapshot"
firecrawl browser "click @e5"

​
CLI

A forma explícita usa execute. Os comandos são enviados automaticamente ao agent-browser — você não precisa digitar agent-browser nem usar --bash: 
firecrawl browser execute "open https://example.com"
firecrawl browser execute "snapshot"

​
API & SDK

Use language: "bash" para executar comandos do agent-browser por meio da API ou dos SDKs: 
curl -X POST "https://api.firecrawl.dev/v2/browser/YOUR_SESSION_ID/execute" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "agent-browser snapshot",
    "language": "bash"
  }'

​
Gerenciamento de sessões

​
Listar sessões

import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

const { sessions } = await firecrawl.listBrowsers();
console.log(sessions);

// Filtrar por status
const { sessions: active } = await firecrawl.listBrowsers({ status: "active" });
console.log(active);
Response
{
  "success": true,
  "sessions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "active",
      "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
      "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2025-01-15T10:30:00Z",
      "lastActivity": "2025-01-15T10:35:00Z"
    }
  ]
}

​
Configuração de TTL

As sessões têm dois controles de TTL:
ParâmetroPadrãoDescrição
ttl300s (5 min)Tempo máximo de duração da sessão (30-3600s)
activityTtl120s (2 min)Encerramento automático após inatividade (10-3600s)

​
Encerrar a sessão

import Firecrawl from '@mendable/firecrawl-js';

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });

await firecrawl.deleteBrowser("YOUR_SESSION_ID");

​
Live View

Toda sessão retorna uma liveViewUrl na resposta que você pode incorporar para acompanhar o navegador em tempo real. Útil para depuração, demonstrações ou para criar interfaces baseadas em navegador.
Response
{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-...",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-..."
}

<iframe src="LIVE_VIEW_URL" width="100%" height="600" />

​
Conectando-se ao CDP

Cada sessão expõe uma URL de WebSocket do CDP. A API execute e a opção --bash cobrem a maioria dos casos de uso, mas, se você precisar de controle local total, pode se conectar diretamente. 
import Firecrawl from '@mendable/firecrawl-js';
import { chromium } from "playwright-core";

const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });
const session = await firecrawl.browser();

const browser = await chromium.connectOverCDP(session.cdpUrl);
const context = browser.contexts()[0];
const page = context.pages()[0] || (await context.newPage());

await page.goto("https://example.com");
console.log(await page.title());

await browser.close();
await firecrawl.deleteBrowser(session.id);

​
Quando usar o Browser

Caso de usoFerramenta recomendada
Extrair conteúdo de uma URL conhecidaScrape
Pesquisar na web e obter resultadosSearch
Navegar por paginações, preencher formulários e seguir fluxos de navegaçãoBrowser
Fluxos de trabalho com múltiplas etapas e interaçãoBrowser
Navegação paralela em vários sites ao mesmo tempoBrowser (cada sessão é isolada)

​
Casos de uso

  • Inteligência competitiva - Navegar em sites de concorrentes, usar formulários de busca e filtros, extrair preços e funcionalidades em dados estruturados
  • Ingestão de base de conhecimento - Navegar por centrais de ajuda, documentação e portais de suporte que exigem cliques, paginação ou autenticação
  • Pesquisa de mercado - Iniciar sessões de navegador em paralelo para criar conjuntos de dados a partir de sites de vagas, anúncios de imóveis ou bancos de dados jurídicos

​
Preços

A cobrança é simples: 2 créditos por minuto de uso do navegador. Usuários gratuitos recebem 5 horas de uso grátis.

​
Limites de taxa

No lançamento inicial, todos os planos poderão ter até 20 sessões de navegador simultâneas.

​
Referência da API

Tem alguma sugestão ou precisa de ajuda? Envie um e-mail para help@firecrawl.com ou fale com a gente no Discord.