yelbanyelban/camofox-browser-skills/camofox-browser/SKILL.md

camofox-browser

Skill15 starsChanged 9 months agoMITView on GitHub

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.

3 other projects use a version of this.

Adopted by

Most recently taken up by

LaansDole/my-hermes-skillstheir own version, first seen Nov 1, 2026
thatjuan/agent-skillstheir own version, first seen Oct 20, 2026
redf0x1/camofox-browsertheir own version, first seen Oct 8, 2026

Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
redf0x1/camofox-browser★ 438same name
LaansDole/my-hermes-skills★ 3same name
thatjuan/agent-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.

0
Common
Most of the 3 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Interact: Use refs to click, type, select
line 32
Distinctive:
Re-snapshot: After navigation or DOM changes, get fresh refs
line 33
Distinctive:
Always close when done:
line 178

“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free