每日备份 2026-06-10 12:57:13

2026-06-10 12:57:14 +08:00
1 parent fda2ccb8c2
commit 3d2e638c6a
@@ -0,0 +1,72 @@
+# Camoufox Stealth Browser 🦊
+
+**C++ level** anti-bot evasion — not JavaScript band-aids.
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](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)