CamoFox Browser

Qu'est-ce que CamoFox Browser ?

CamoFox Browser est un serveur d'automatisation de navigateur sans interface, conçu spécifiquement pour les agents d'IA. Il est propulsé par Camoufox — un fork de Firefox qui effectue la falsification d'empreinte numérique au niveau du moteur C++ plutôt qu'avec des correctifs JavaScript fragiles.

Cela permet aux agents d'IA de visiter de vrais sites web qui bloquent généralement les outils d'automatisation comme Playwright ou Puppeteer, y compris ceux protégés par Cloudflare, Google et autres systèmes de détection de bots avancés.

Il utilise le même moteur de navigation que l'assistant IA Jo et s'intègre parfaitement avec OpenClaw et d'autres frameworks pour agents.

Fonctionnalités principales

• Anti-détection au niveau C++ : Falsifie les propriétés du navigateur, WebGL, AudioContext, la géométrie d'écran, WebRTC et plus encore au niveau du moteur du navigateur pour une indétectabilité maximale.
• Captures efficaces en tokens : Renvoie des captures de l'arbre d'accessibilité (~90 % plus petites que le HTML brut) + des captures d'écran en base64 optionnelles.
• Références d'éléments stables : Utilise des références fiables e1, e2, ... pour les clics, la saisie et l'interaction.
• Isolation de session : Isolation par userId et sessionKey avec expiration automatique et recyclage des onglets.
• Alignement Proxy & GeoIP : Achemine le trafic via des proxies résidentiels avec la localisation, le fuseau horaire et la géolocalisation correspondants.
• Importation de cookies : Prend en charge l'injection de cookies au format Netscape pour les sessions authentifiées (LinkedIn, Amazon, etc.).
• Macros de recherche intégrées : @google_search, @youtube_search, @amazon_search, @reddit_subreddit, et plus encore.
• Extraction de transcriptions YouTube : Chemin rapide via yt-dlp ou repli sur le navigateur.
• Faible utilisation des ressources : ~40 Mo de mémoire au repos ; lancement différé et arrêt en inactivité. Fonctionne sur Raspberry Pi ou un VPS économique.
• API structurée : Points de terminaison REST avec journalisation JSON et traçage des ID de requête.

Architecture

• Navigateur propulsé par Camoufox
• BrowserContext isolé par utilisateur
• Groupes d'onglets organisés par sessionKey
• Arrêt automatique en inactivité et relance à la demande

Installation & Démarrage rapide

Autonome

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

Le serveur s'exécute sur http://localhost:9377. Camoufox (~300 Mo) est téléchargé automatiquement au premier lancement.

Docker

make up

Prend en charge Fly.io, Railway et les builds multi-architectures.

Intégration avec OpenClaw

openclaw plugins install @askjo/camofox-browser

Exemples d'utilisation

Créer un nouvel onglet

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

Obtenir un instantané d'accessibilité + capture d'écran

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

Cliquer sur un élément par référence (ref)

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

Rechercher avec une macro

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

Cas d'utilisation

• Agents d'IA nécessitant une navigation web fiable (recherche, shopping, médias sociaux, etc.)
• Contournement des protections anti-bot sur les sites protégés par Cloudflare ou Google
• Navigation authentifiée avec importation de cookies
• Interaction web économe en tokens pour des flux de travail d'agents de longue durée
• Intégration avec OpenClaw, Claude Desktop (via MCP), LangChain et des agents personnalisés

Ressources

• GitHub : https://github.com/jo-inc/camofox-browser
• Camoufox : https://camoufox.com
• Intégration OpenClaw : https://openclaw.ai
• Documentation : https://jo-inc-camofox-browser.mintlify.app

Le navigateur CamoFox est sous licence MIT, activement maintenu (dernière version en avril 2026) et largement utilisé pour l'automatisation web des agents IA en production.