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

bash

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
```
,
```
@e2
```
refs
Interact: Use refs to click, type, select
Re-snapshot: After navigation or DOM changes, get fresh refs
Repeat: Server stays running between commands

bash

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

bash

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

bash

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)

bash

camofox click @e1                    # Click element
camofox type @e1 "text"              # Type into element

Search Macros

bash

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

bash

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

bash

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

bash

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 (
```
humanize
```
parameter)
WebRTC leak prevention
No
```
navigator.webdriver
```
flag

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?

bash

camofox health                        # Check if running
camofox stop && camofox start         # Restart

Still getting blocked?

bash

# Enable proxy
HTTPS_PROXY=socks5://127.0.0.1:1080 camofox open <url>

Bot detection test:

bash

camofox open https://bot.sannysoft.com/
camofox screenshot bot-test.png

Cleanup

Always close when done:

bash

camofox close-all
camofox stop

camofox-browser

NPX Install

Tags

SKILL.md Content

Camofox Browser - Anti-Detection Browser Automation

Installation

Quick Start

Core Workflow

Commands

Navigation

Page State

Interaction (use @refs from snapshot)

Search Macros

Session Management

Server Control

Ref Lifecycle (Important)

When to Use camofox-browser vs agent-browser

Anti-Detection Capabilities

Environment Variables

Deep-Dive Documentation

Ready-to-Use Templates

Troubleshooting

Cleanup