camoufox-stealth-browser
This skill provides C++-level stealth browser automation (Camoufox) and TLS-spoofed API scraping for evading anti-bot systems. It includes instructions to run shell commands (e.g. distrobox-enter, bash scripts/setup.sh), perform network requests to sites like https://api.example.com and https://www.airbnb.com, and read/save session cookies under ~/.stealth-browser/profiles/<name>/.
Camoufox Stealth Browser 🦊
C++ level anti-bot evasion — not JavaScript band-aids.
Why Camoufox > Chrome-Based Tools
| Approach | Patches At | Detectable? |
|---|---|---|
| Camoufox ✅ | C++ (compiled into browser) | No — fingerprints are genuinely different |
| undetected-chromedriver | JS runtime | Yes — timing analysis reveals patches |
| puppeteer-stealth | JS injection | Yes — applied after page load |
| playwright-stealth | JS injection | Yes — same limitations |
Most "stealth" tools patch Chrome with JavaScript after the browser starts. Anti-bot systems detect this via timing analysis and consistency checks.
Camoufox is different. It's a Firefox fork with stealth patches compiled into the C++ source code. WebGL, Canvas, and AudioContext fingerprints are genuinely spoofed — not masked by JS overrides.
Key Features
- 🦊 C++ Level Stealth — Fingerprints baked into the browser binary
- 📦 Container Isolation — Runs in distrobox, keeps host clean
- ⚡ Dual-Tool Design — Camoufox for browsers, curl_cffi for fast API-only scraping
- 🔥 Firefox-Based — Less fingerprinted than Chrome (bots love Chrome)
Quick Start
# Setup (first time)
distrobox-enter pybox -- python3.14 -m pip install camoufox curl_cffi
# Fetch a Cloudflare-protected page
distrobox-enter pybox -- python3.14 scripts/camoufox-fetch.py \
"https://yelp.com/biz/example" --headless
# API scraping (no browser needed)
distrobox-enter pybox -- python3.14 scripts/curl-api.py \
"https://api.example.com" --impersonate chrome120
Requirements
distroboxwith apyboxcontainer- Residential proxy for Airbnb/Yelp (datacenter IPs = instant block)
Tools
| Tool | Use Case | Speed |
|---|---|---|
| Camoufox | Full browser automation, JS-heavy sites | ~3-5s/page |
| curl_cffi | API endpoints, no JS needed | ~100ms/request |
Documentation
- SKILL.md — Full usage guide with session management
- references/proxy-setup.md — Proxy configuration
- references/fingerprint-checks.md — What anti-bot systems check
Comparison with Other Skills
This skill focuses on doing one thing well: C++ level stealth with Camoufox.
For CAPTCHA solving, task checkpointing, and proxy rotation, see the GitHub issues for planned features.
License
Apache 2.0 — See LICENSE
Made with 🦊 by Kessler.io