O que é o CamoFox Browser?

O CamoFox Browser é um servidor de automação de navegador sem interface gráfica (headless) construído especificamente para agentes de IA. Ele é alimentado pelo Camoufox — uma versão modificada do Firefox que realiza a falsificação de impressão digital (fingerprint spoofing) no nível do motor C++, ao invés de patches frágeis em JavaScript.

Isso permite que agentes de IA visitem sites reais que normalmente bloqueiam ferramentas de automação como Playwright ou Puppeteer, incluindo aqueles protegidos pelo Cloudflare, Google e outros sistemas avançados de detecção de bots.

É o mesmo motor de navegação utilizado por trás do assistente de IA Jo e integra-se perfeitamente com o OpenClaw e outros frameworks de agentes.

Principais Características

Anti-Detecção em Nível C++: Falsifica propriedades do navigator, WebGL, AudioContext, geometria da tela, WebRTC e mais no nível do motor do navegador para máxima indetectabilidade.
Snapshots Eficientes em Tokens: Retorna snapshots da árvore de acessibilidade (~90% menor que o HTML bruto) + capturas de tela opcionais em base64.
Referências de Elementos Estáveis: Usa referências confiáveis como e1, e2, ... para cliques, digitação e interação.
Isolamento de Sessão: Isolamento por userId e sessionKey com expiração automática e reciclagem de abas.
Alinhamento de Proxy e GeoIP: Roteia o tráfego por meio de proxies residenciais com localidade, fuso horário e geolocalização correspondentes.
Importação de Cookies: Suporta injeção de cookies no formato Netscape para sessões autenticadas (LinkedIn, Amazon, etc.).
Macros de Busca Integradas: @google_search, @youtube_search, @amazon_search, @reddit_subreddit, e mais.
Extração de Transcrição do YouTube: Caminho rápido via yt-dlp ou fallback no navegador.
Baixo Uso de Recursos: ~40MB de memória em idle; lançamento preguiçoso (lazy launch) e desligamento em idle. Executa em Raspberry Pi ou VPS baratos.
API Estruturada: Endpoints REST com logging em JSON e rastreamento de ID de requisição.

Arquitetura

Navegador alimentado pelo Camoufox
BrowserContext isolado por usuário
Grupos de abas organizados por sessionKey
Desligamento automático em idle e relançamento sob demanda

Instalação & Início Rápido

Autônomo (Standalone)

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

O servidor é executado em http://localhost:9377. O Camoufox (~300MB) é baixado automaticamente na primeira execução.

Docker

make up

Suporta Fly.io, Railway e builds multi-architecture.

Integração com OpenClaw

openclaw plugins install @askjo/camofox-browser

Exemplos de Uso

Criar uma nova aba

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

Obter instantâneo de acessibilidade + captura de tela

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

Clicar em elemento por referência (ref)

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

Pesquisar com 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 precisam de navegação web confiável (pesquisa, compras, redes sociais, etc.)
Contornar proteções anti-bot em sites protegidos por Cloudflare ou Google
Navegação autenticada com cookies importados
Interação web eficiente em termos de tokens em fluxos de trabalho de agentes de longa duração
Integração com OpenClaw, Claude Desktop (via MCP), LangChain e agentes personalizados

Recursos

GitHub: https://github.com/jo-inc/camofox-browser
Camoufox: https://camoufox.com
Integração com OpenClaw: https://openclaw.ai
Documentação: https://jo-inc-camofox-browser.mintlify.app

O CamoFox Browser possui licença MIT, é mantido ativamente (última versão em abril de 2026) e amplamente utilizado para automação web de agentes de IA em produção.