# CamoFox Browser

CamoFox Browser es un servidor de automatización de navegador antidetectores sin cabeza (headless), impulsado por Camoufox (un fork de Firefox con suplantación de huellas digitales a nivel C++). Permite que los agentes de IA naveguen de forma confiable por sitios bloqueados por Cloudflare, Google y otros sistemas de detección de bots.

Canonical URL: https://a2a-mcp.org/entry/camofox-browser-es

Language: es

Category: Tools & Extensions

Updated: 2026-04-08

## ¿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)

```bash
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

```bash
make up
```

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

### Integración con OpenClaw

```bash
openclaw plugins install @askjo/camofox-browser
```

## Ejemplos de Uso

**Crear una nueva pestaña**

```bash
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**

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

**Hacer clic en un elemento por su ref**

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

**Buscar usando una macro**

```bash
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.

## Tags

- agente-ia
- navegador-headless
- anti-deteccion
- automatizacion-navegador
- camoufox
- openclaw
- mcp
- playwright
- suplantacion-huella-digital
- typescript
- node-js

## Sources

- [Project website](https://github.com/jo-inc/camofox-browser)