73 lines
2.6 KiB
Markdown
73 lines
2.6 KiB
Markdown
# Camoufox Stealth Browser 🦊
|
|
|
|
**C++ level** anti-bot evasion — not JavaScript band-aids.
|
|
|
|
[](LICENSE)
|
|
|
|
## 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
- `distrobox` with a `pybox` container
|
|
- 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](SKILL.md) — Full usage guide with session management
|
|
- [references/proxy-setup.md](references/proxy-setup.md) — Proxy configuration
|
|
- [references/fingerprint-checks.md](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](https://github.com/kesslerio/stealth-browser-clawhub-skill/issues) for planned features.
|
|
|
|
## License
|
|
|
|
Apache 2.0 — See [LICENSE](LICENSE)
|
|
|
|
---
|
|
|
|
Made with 🦊 by [Kessler.io](https://kessler.io)
|