🦊 Camofox Browser

Anti-detectie browser server voor AI-agents. Omzeilt Cloudflare, Google CAPTCHA's en bot-detectie via een Camoufox (Firefox-fork) engine met fingerprint-spoofing op C++ niveau.

✅ Status: Draait op VPS, poort :9377, verbonden met Hermes via browser.camofox config.

🎯 Probleem

Hermes' browser toolset (browser_navigate, browser_snapshot, etc.) gebruikt een headless Chromium via Playwright. Op een VPS zonder residential proxies wordt dit snel geblokkeerd:

DuckDuckGo → "Unfortunately, bots use DuckDuckGo too" — CAPTCHA
Google → CAPTCHA (via google.com/sorry/)
Cloudflare challenges op veel sites
Bot-detectie fingerprinted headless browsers

🔧 Oplossing

Camofox draait naast Hermes en vangt alle browser-verzoeken af. Hermes' browser tools gebruiken Camofox als backend zodra die op :9377 detecteerbaar is.

Aspect	Oude situatie (Chromium)	Nieuwe situatie (Camofox)
Engine	Chromium (Playwright)	Firefox-fork (Camoufox)
Anti-detectie	JavaScript stealth plugins	C++ fingerprint spoofing
CAPTCHA-bypass	❌ Wordt geblokkeerd	✅ Omzeilt detectie
Resource usage	Hele Chromium instance	~40MB idle, lazy launch
Token efficiency	Ruwe HTML (groot)	Accessibility snapshots (~90% kleiner)

🚀 Gebruik

Gewoon Hermes vragen zoals altijd. Hermes gebruikt Camofox automatisch achter de schermen.

Voorbeelden

"Zoek naar klimaatdoelstellingen RWS"
"Open nos.nl en vat het nieuws samen"
"Wat is de actuele euro/dollar koers?"
"Geef me de transcriptie van youtube.com/watch?v=..."
"Zoek naar ministerie van infrastructuur aanbesteding 2026"

Je merkt alleen dat Hermes niet meer vastloopt op CAPTCHA's — verder werkt alles hetzelfde.

Zoekmacros (voor Hermes, niet voor jou)

Macro	Site
`@google_search`	Google
`@youtube_search`	YouTube
`@reddit_subreddit`	Reddit
`@amazon_search`	Amazon
`@wikipedia_search`	Wikipedia

🛠️ Installatie & Config

Locaties

Wat	Locatie
Repo	`/opt/data/camofox-browser/`
Start script	`/opt/data/camofox-browser/start.sh`
Watchdog	`/opt/data/camofox-browser/watchdog.sh`
Logs	`/opt/data/camofox-browser/camofox.log`
PID bestand	`/opt/data/camofox-browser/camofox.pid`
Libs (non-root)	`/opt/data/camofox-libs/`
Camoufox binary	`~/.cache/camoufox/` (~713MB)
Watchdog cron	job `e57726a48ef3`, elke 5 min (no_agent)

Hermes config

browser:
  camofox:
    managed_persistence: false
    user_id: "hermes-telegram"
    session_key: ""

ℹ️ De browser toolset checkt bij Hermes-sessie-start of er een Camofox-server op :9377 draait. Zo ja → automatisch backend. Nieuwe sessie nodig na config-wijziging (/reset of herstart).

API (direct gebruik)

# Status check
curl http://localhost:9377/

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

# Snapshot (accessibility tree met refs)
curl "http://localhost:9377/tabs/<tabId>/snapshot?userId=hugo"

# Klikken op element
curl -X POST http://localhost:9377/tabs/<tabId>/click \
  -d '{"userId":"hugo","ref":"e1"}'

🔄 Beheer

Server herstarten

bash /opt/data/camofox-browser/watchdog.sh

Server stoppen

kill $(cat /opt/data/camofox-browser/camofox.pid)
kill $(lsof -ti:9377)  # forceer

Logs bekijken

tail -f /opt/data/camofox-browser/camofox.log

⚠️ Afhankelijkheden

Node.js — v22.22.3 (geïnstalleerd)
npm — 10.9.8 (geïnstalleerd)
System libs — GTK3, Xinerama, ALSA, NSS, CUPS e.a. (non-root via /opt/data/camofox-libs/)
Xvfb — virtueel display (draait automatisch)
yt-dlp — optioneel, voor snelle YouTube transcripties (ontbreekt nu, browser fallback)

⚠️ RAM: Camoufox binary is ~713MB. Server gebruikt ~40MB idle, maar de browser neemt extra geheugen tijdens gebruik.

← Terug naar wiki