¿Qué es CamoFox Browser?

CamoFox Browser es un servidor de automatización de navegador sin interfaz (headless) creado específicamente para agentes de IA. Funciona con Camoufox — un fork de Firefox que realiza suplantación de huella digital (fingerprint spoofing) a nivel del motor C++, en lugar de usar parches frágiles en JavaScript.

Esto permite que los agentes de IA visiten sitios web reales que normalmente bloquean herramientas de automatización como Playwright o Puppeteer, incluyendo aquellos protegidos por Cloudflare, Google y otros sistemas avanzados de detección de bots.

Es el mismo motor de navegación que se utiliza en el asistente Jo AI y se integra perfectamente con OpenClaw y otros frameworks de agentes.

Características Principales

Anti-Detección a Nivel C++: Suplanta propiedades del navegador, WebGL, AudioContext, geometría de pantalla, WebRTC y más a nivel del motor del navegador para una máxima indetectabilidad.
Capturas Eficientes en Tokens: Devuelve capturas del árbol de accesibilidad (~90% más pequeñas que el HTML crudo) + capturas de pantalla en base64 opcionales.
Referencias Estables de Elementos: Usa referencias confiables e1, e2, ... para clics, escritura e interacción.
Aislamiento de Sesión: Aislamiento por userId y sessionKey con expiración automática y reciclaje de pestañas.
Alineación de Proxy y GeoIP: Enruta el tráfico a través de proxies residenciales con configuración regional, zona horaria y geolocalización coincidentes.
Importación de Cookies: Soporta inyección de cookies en formato Netscape para sesiones autenticadas (LinkedIn, Amazon, etc.).
Macros de Búsqueda Integrados: @google_search, @youtube_search, @amazon_search, @reddit_subreddit, y más.
Extracción de Transcripciones de YouTube: Ruta rápida mediante yt-dlp o respaldo (fallback) del navegador.
Bajo Uso de Recursos: ~40MB de memoria en reposo; lanzamiento perezoso (lazy launch) y apagado en inactividad. Funciona en Raspberry Pi o VPS económicos.
API Estructurada: Endpoints REST con registro JSON y trazabilidad por ID de solicitud.

Arquitectura

Navegador impulsado por Camoufox
BrowserContext aislado por usuario
Grupos de pestañas organizados por sessionKey
Apagado automático por inactividad y relanzamiento bajo demanda

Instalación e Inicio Rápido

Independiente (Standalone)

git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser
npm install
npm start

El servidor se ejecuta en http://localhost:9377. Camoufox (~300MB) se descarga automáticamente en la primera ejecución.

Docker

make up

Soporta Fly.io, Railway y builds multi-arquitectura.

Integración con OpenClaw

openclaw plugins install @askjo/camofox-browser

Ejemplos de Uso

Crear una nueva pestaña

curl -X POST http://localhost:9377/tabs \
  -H "Content-Type: application/json" \
  -d '{"userId": "agent1", "sessionKey": "task1", "url": "https://example.com"}'

Obtener captura de accesibilidad + captura de pantalla

curl "http://localhost:9377/tabs/{TAB_ID}/snapshot?userId=agent1&includeScreenshot=true"

Hacer clic en un elemento por su ref

curl -X POST http://localhost:9377/tabs/{TAB_ID}/click \
  -d '{"userId": "agent1", "ref": "e1"}'

Buscar usando una macro

curl -X POST http://localhost:9377/tabs/{TAB_ID}/navigate \
  -d '{"userId": "agent1", "macro": "@google_search", "query": "best wireless headphones"}'

Casos de Uso

Agentes de IA que necesitan navegación web confiable (investigación, compras, redes sociales, etc.)
Evadir protecciones anti-bot en sitios protegidos por Cloudflare o Google
Navegación autenticada con cookies importadas
Interacción web eficiente en tokens para flujos de trabajo de agentes de larga duración
Integración con OpenClaw, Claude Desktop (vía MCP), LangChain y agentes personalizados

Recursos

GitHub: https://github.com/jo-inc/camofox-browser
Camoufox: https://camoufox.com
Integración con OpenClaw: https://openclaw.ai
Documentación: https://jo-inc-camofox-browser.mintlify.app

CamoFox Browser está licenciado bajo MIT, se mantiene activamente (última versión abril de 2026) y se usa ampliamente para la automatización web de agentes de IA en producción.