camofox-browser
Anti-detection browser automation using Camoufox (Firefox fork with C++ fingerprint spoofing). Use when standard browser tools get blocked by Cloudflare, Akamai, or bot detection. Triggers include "stealth browse", "anti-detection", "bypass bot", "camofox", "blocked by Cloudflare", scraping protecte
By yelban · 374 installs
npx skills add yelban/camofox-browser-skills --skill camofox-browser
Source repository · Upstream listing
Camofox Browser Anti Detection Browser Automation
Stealth browser automation via Camoufox (Firefox fork). C++ level fingerprint spoofing — undetectable by JavaScript based bot checks. REST API wrapper using curl .
Installation
First use automatically downloads and installs the Camoufox browser (~300MB, one time). No manual setup required — just run any camofox command.
Quick Start
Core Workflow
1. Navigate : camofox open <url — opens tab and navigates
2. Snapshot : camofox snapshot — returns accessibility tree with @e1 , @e2 refs
3. Interact : Use refs to click, type, select
4. Re snapshot : After navigation or DOM changes, get fresh refs
5. Repeat : Server stays running between commands
Commands
Navigation
Page State
Interaction (use @refs from snapshot)
Search Macros
13 macros available — see [references/macros and search.md](references/macros and search.md).
Session Management
Server Control
Ref Lifecycle (Important)
Refs ( @e1 , @e2 ) are invalidated when the page changes. Always re snapshot after:
Clicking links/buttons that navigate
Form submissions
Dynamic content loading
When to Use camofox browser vs agent browser
Scenario Tool
Normal websites, no bot detection agent browser (faster)
Cloudflare / Akamai protected camofox browser
Sites that block Chromium automation camofox browser
Need anti fingerprinting camofox browser
Need iOS/mobile simulation agent browser
Need video recording agent browser
Anti Detection Capabilities
C++ level fingerprint spoofing (canvas, WebGL, AudioContext, fonts)
Firefox based (not Chromium — different detection surface)
Human like interaction timing ( humanize parameter)
WebRTC leak prevention
No navigator.webdriver flag
See [references/anti detection.md](references/anti detection.md) for details.
Environment Variables
Variable Default Description
CAMOFOX PORT 9377 Server port
CAMOFOX SESSION default Default session name
CAMOFOX HEADLESS true Headless mode
HTTPS PROXY — Proxy server
Deep Dive Documentation
Reference When to Use
[references/api reference.md](references/api reference.md) Full REST API endpoint docs
[references/anti detection.md](references/anti detection.md) Fingerprint spoofing details
[references/macros and search.md](references/macros and search.md) 13 search macros
Ready to Use Templates
Template Description
[templates/stealth scrape.sh](templates/stealth scrape.sh) Anti detection scraping workflow
[templates/multi session.sh](templates/multi session.sh) Multi session isolation
Troubleshooting
Server won't start?
Still getting blocked?
Bot detection test:
Cleanup
Always close when done: