Name: camofox-browser
Author: yelban

Imported from yelban/camofox-browser-skills (camofox-browser/SKILL.md) via skills.sh. Install upstream with npx skills add yelban/camofox-browser-skills --skill camofox-browser. Copyright stays with the author.

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, @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

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 (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?

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

Install camofox-browser and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "yelban-camofox-browser-skills-camofox-browser", "kind": "skill", "name": "camofox-browser", "description": "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 protected sites (X/Twitter, Amazon, Product Hunt), or when agent-browser/playwright fails with bot detection errors.", "publisher": "yelban", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "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 protected sites (X/Twitter, Amazon, Product Hunt), or when agent-browser/playwright fails with bot detection errors." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/yelban/camofox-browser-skills", "path": "camofox-browser/SKILL.md", "ref": "HEAD", "url": "https://www.skills.sh/yelban/camofox-browser-skills/camofox-browser", "key": "yelban/camofox-browser-skills/camofox-browser/SKILL.md" }, "allowed_tools": [ "Bash(camofox-browser:*)" ] }, "instructions": "# Camofox Browser - Anti-Detection Browser Automation\n\nStealth browser automation via Camoufox (Firefox fork). C++ level fingerprint spoofing — undetectable by JavaScript-based bot checks. REST API wrapper using `curl`.\n\n## Installation\n\nFirst use automatically downloads and installs the Camoufox browser (~300MB, one-time). No manual setup required — just run any `camofox` command.\n\n## Quick Start\n\n```bash\ncamofox open https://example.com # Open URL (auto-starts server)\ncamofox snapshot # Get page elements with @refs\ncamofox click @e1 #", "cost": { "context_tokens": 1401 } }

camofox-browser

About