Saltar al contenido principal
Firecrawl Browser Sandbox ofrece a tus agentes un entorno de navegador seguro y totalmente gestionado. Sin configuración local, sin instalaciones de Chromium, sin problemas de compatibilidad de controladores. Agent Browser y Playwright ya vienen preinstalados. Cada sesión se ejecuta en un sandbox aislado y desechable que escala sin necesidad de gestionar infraestructura. Disponible a través de API, CLI (Bash / agent-browser, Python, Node), Node SDK, Python SDK, Vercel AI SDK y MCP Server. Para añadir compatibilidad con navegador a un agente de programación de IA (Claude Code, Codex, Open Code, Cursor, etc.), instala la skill de Firecrawl: 
npx -y firecrawl-cli@latest init --all --browser
También puedes instalar la CLI de Firecrawl o dejar que el agente la instale por ti como se muestra arriba: 
npm install -g firecrawl-cli

​
Inicio rápido

Crea una sesión, ejecuta código y ciérrala: 
// npm install @mendable/firecrawl-js
import Firecrawl from '@mendable/firecrawl-js';

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

// 1. Iniciar una sesión
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);
  • Sin instalación de controladores - Sin binario de Chromium, sin playwright install, sin problemas de compatibilidad de controladores
  • Python, JavaScript y Bash - Envía código vía API, CLI o SDK y recibe los resultados. Los tres lenguajes se ejecutan de forma remota en el sandbox
  • agent-browser - CLI preinstalada con más de 40 comandos. Los agentes de IA escriben comandos bash simples en lugar de código de Playwright
  • Playwright disponible - Playwright viene preinstalado en el sandbox. Los agentes pueden escribir código con Playwright si lo prefieren.
  • Acceso CDP - Conecta tu propia instancia de Playwright por WebSocket cuando necesites control completo
  • Vista en vivo - Mira las sesiones en tiempo real mediante una URL de streaming integrable

​
Iniciar una sesión

Devuelve un ID de sesión, una URL de CDP y una URL de vista en tiempo 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"
}

​
Ejecutar 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 es una CLI de navegador headless preinstalada en cada sandbox. En lugar de escribir código de Playwright, los agentes envían comandos de bash sencillos. La CLI inyecta automáticamente --cdp para que agent-browser se conecte a tu sesión activa.

​
Atajo

La forma más rápida de usar browser. Tanto el atajo como execute envían comandos a agent-browser automáticamente. El atajo simplemente omite execute y abre una sesión automáticamente si es necesario: 
firecrawl browser "open https://example.com"
firecrawl browser "snapshot"
firecrawl browser "click @e5"

​
CLI

La forma explícita usa execute. Los comandos se envían automáticamente a agent-browser; no necesitas escribir agent-browser ni usar --bash: 
firecrawl browser execute "open https://example.com"
firecrawl browser execute "snapshot"

​
API y SDK

Utiliza language: "bash" para ejecutar comandos de agent-browser a través de la API o los SDK: 
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"
  }'

​
Gestión de sesiones

​
Listar sesiones

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 estado
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"
    }
  ]
}

​
Configuración de TTL

Las sesiones tienen dos controles de TTL:
ParámetroPredeterminadoDescripción
ttl300s (5 min)Vida útil máxima de la sesión (30-3600s)
activityTtl120s (2 min)Cierre automático tras inactividad (10-3600s)

​
Cerrar una sesión

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

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

await firecrawl.deleteBrowser("YOUR_SESSION_ID");

​
Vista en vivo

Cada sesión devuelve un liveViewUrl en la respuesta que puedes insertar para ver el navegador en tiempo real. Resulta útil para depuración, demostraciones o para crear interfaces de usuario basadas en el 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" />

​
Conexión mediante CDP

Cada sesión expone una URL de WebSocket de CDP. La API execute y la bandera --bash cubren la mayoría de los casos de uso, pero si necesitas control local completo puedes conectarte directamente. 
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);

​
Cuándo usar Browser

Caso de usoHerramienta adecuada
Extraer contenido de una URL conocidaScrape
Buscar en la web y obtener resultadosSearch
Gestionar la paginación, completar formularios y hacer clic en flujosBrowser
Flujos de trabajo multietapa con interacciónBrowser
Navegación en paralelo en muchos sitiosBrowser (cada sesión es independiente)

​
Casos de uso

  • Inteligencia competitiva - Explorar sitios de la competencia, navegar por formularios de búsqueda y filtros, y extraer precios y características en datos estructurados
  • Ingesta de base de conocimientos - Navegar por centros de ayuda, documentación y portales de soporte que requieren clics, paginación o autenticación
  • Investigación de mercado - Iniciar sesiones de navegador en paralelo para crear conjuntos de datos a partir de bolsas de trabajo, listados inmobiliarios o bases de datos legales

​
Precios

El precio es sencillo: 2 créditos por minuto de navegador. Los usuarios del plan gratuito disponen de 5 horas de uso sin coste.

​
Límites de uso

En el lanzamiento inicial, permitimos hasta 20 sesiones simultáneas de navegador en todos los planes.

​
Referencia de la API

¿Tienes comentarios o necesitas ayuda? Escríbenos a help@firecrawl.com o contáctanos por Discord.