Was ist CamoFox Browser?

CamoFox Browser ist ein Headless-Browser-Automatisierungsserver, der speziell für KI-Agenten entwickelt wurde. Er wird von Camoufox angetrieben – einem Firefox-Fork, der Fingerprint-Spoofing auf der C++-Engine-Ebene durchführt und nicht auf fehleranfälligen JavaScript-Patches basiert.

Dies ermöglicht es KI-Agenten, echte Websites zu besuchen, die typischerweise Automatisierungswerkzeuge wie Playwright oder Puppeteer blockieren, einschließlich solcher, die durch Cloudflare, Google und andere fortschrittliche Bot-Erkennungssysteme geschützt sind.

Es ist dieselbe Browsing-Engine, die hinter dem Jo KI-Assistenten verwendet wird, und integriert sich nahtlos mit OpenClaw und anderen Agenten-Frameworks.

Hauptfunktionen

Anti-Detection auf C++-Ebene: Fälscht Navigator-Eigenschaften, WebGL, AudioContext, Bildschirmgeometrie, WebRTC und mehr auf der Browser-Engine-Ebene für maximale Unerkennbarkeit.
Token-effiziente Snapshots: Gibt Accessibility-Tree-Snapshots zurück (~90 % kleiner als rohes HTML) + optionale Base64-Screenshots.
Stabile Elementreferenzen: Verwendet zuverlässige e1, e2, ... Referenzen für Klicks, Eingaben und Interaktionen.
Sessionsisolierung: Pro-userId und sessionKey-Isolierung mit automatischem Ablauf und Tab-Recycling.
Proxy & GeoIP-Abgleich: Leitet Datenverkehr über Residential Proxies mit übereinstimmendem Gebietsschema, Zeitzone und Geolokation.
Cookie-Import: Unterstützt Netscape-Format-Cookie-Injection für authentifizierte Sessions (LinkedIn, Amazon, etc.).
Integrierte Suchmakros: @google_search, @youtube_search, @amazon_search, @reddit_subreddit und mehr.
YouTube-Transkript-Extraktion: Schneller Pfad über yt-dlp oder Browser-Fallback.
Geringer Ressourcenverbrauch: ~40MB Leerlauf-Speicher; Lazy-Launch und Leerlauf-Shutdown. Läuft auf Raspberry Pi oder günstigen VPS.
Strukturierte API: REST-Endpunkte mit JSON-Logging und Request-ID-Tracing.

Architektur

Browser angetrieben von Camoufox
Isolierter BrowserContext pro Benutzer
Tab-Gruppen organisiert nach sessionKey
Automatischer Leerlauf-Shutdown und On-Demand-Relaunch

Installation & Schnellstart

Standalone

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

Der Server läuft auf http://localhost:9377. Camoufox (~300MB) wird beim ersten Start automatisch heruntergeladen.

Docker

make up

Unterstützt Fly.io, Railway und Multi-Arch-Builds.

OpenClaw-Integration

openclaw plugins install @askjo/camofox-browser

Verwendungsbeispiele

Neuen Tab erstellen

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

Barrierefreiheit-Snapshot + Screenshot abrufen

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

Element per Referenz klicken

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

Mit Makro suchen

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

Anwendungsfälle

KI-Agenten, die zuverlässiges Web-Browsing benötigen (Recherche, Shopping, Soziale Medien, etc.)
Umgehung von Anti-Bot-Schutz auf Cloudflare-geschützten oder Google-Seiten
Authentifiziertes Browsing mit importierten Cookies
Token-effiziente Web-Interaktion in langlebigen Agenten-Workflows
Integration mit OpenClaw, Claude Desktop (via MCP), LangChain und eigenen Agenten

Ressourcen

GitHub: https://github.com/jo-inc/camofox-browser
Camoufox: https://camoufox.com
OpenClaw Integration: https://openclaw.ai
Dokumentation: https://jo-inc-camofox-browser.mintlify.app

CamoFox Browser ist MIT-lizenziert, wird aktiv gepflegt (neueste Version April 2026) und weit verbreitet für produktive KI-Agenten-Webautomatisierung eingesetzt.