Summary
When standard browser automation gets blocked by Cloudflare or bot detection, this is what you reach for. It's a wrapper around Camoufox, a Firefox fork with C++ level fingerprint spoofing that actually works against sites like Twitter and Amazon. The workflow is simple: open a URL, snapshot to get element refs like @e1 and @e2, then click and type using those refs. First run downloads about 300MB. The real value is in what it evades: canvas fingerprinting, WebGL tracking, and the usual JavaScript bot checks. It's slower than Playwright but that's the point. When agent-browser returns a captcha wall, switch to this.
Install to Claude Code
npx -y skills add yelban/camofox-browser-skills --skill camofox-browser --agent claude-codeInstalls into .claude/skills of the current project.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Files
SKILL.mdView on GitHub
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
camofox open https://example.com # Open URL (auto-starts server)
camofox snapshot # Get page elements with @refs
camofox click @e1 # Click element
camofox type @e2 "hello" # Type text
camofox screenshot # Take screenshot
camofox close # Close tab
Core Workflow
- Navigate:
camofox open <url>— opens tab and navigates - Snapshot:
camofox snapshot— returns accessibility tree with@e1,@e2refs - Interact: Use refs to click, type, select
- Re-snapshot: After navigation or DOM changes, get fresh refs
- Repeat: Server stays running between commands
camofox open https://example.com/login
camofox snapshot
# @e1 [input] Email @e2 [input] Password @e3 [button] Sign In
camofox type @e1 "user@example.com"
camofox type @e2 "password123"
camofox click @e3
camofox snapshot # Re-snapshot after navigation
Commands
Navigation
camofox open <url> # Create tab + navigate (aliases: goto)
camofox navigate <url> # Navigate current tab
camofox back # Go back
camofox forward # Go forward
camofox refresh # Reload page
camofox scroll down # Scroll down (also: up, left, right)
Page State
camofox snapshot # Accessibility snapshot with @refs
camofox screenshot # Screenshot to /tmp/camofox-screenshots/
camofox screenshot output.png # Screenshot to specific path
camofox tabs # List all open tabs
Interaction (use @refs from snapshot)
camofox click @e1 # Click element
camofox type @e1 "text" # Type into element
Search Macros
camofox search google "query" # Google search
camofox search youtube "query" # YouTube search
camofox search amazon "query" # Amazon search
camofox search reddit "query" # Reddit search
13 macros available — see references/macros-and-search.md.
Session Management
camofox --session work open <url> # Isolated session
camofox --session work snapshot # Use specific session
camofox close # Close current tab
camofox close-all # Close all tabs in session
Server Control
camofox start # Start server (usually auto)
camofox stop # Stop server
camofox health # Health check
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
camofox click @e3 # Navigates to new page
camofox snapshot # MUST re-snapshot
camofox click @e1 # Use new refs
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 (
humanizeparameter) - WebRTC leak prevention
- No
navigator.webdriverflag
See 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 | Full REST API endpoint docs |
| references/anti-detection.md | Fingerprint spoofing details |
| references/macros-and-search.md | 13 search macros |
Ready-to-Use Templates
| Template | Description |
|---|---|
| templates/stealth-scrape.sh | Anti-detection scraping workflow |
| templates/multi-session.sh | Multi-session isolation |
Troubleshooting
Server won't start?
camofox health # Check if running
camofox stop && camofox start # Restart
Still getting blocked?
# Enable proxy
HTTPS_PROXY=socks5://127.0.0.1:1080 camofox open <url>
Bot detection test:
camofox open https://bot.sannysoft.com/
camofox screenshot bot-test.png
Cleanup
Always close when done:
camofox close-all
camofox stop
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →First SeenJun 3, 2026
