# 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 protected sites (X/Twitter, Amazon, Product Hunt), or when agent-browser/playwright fails with bot detectio…

- **Type:** Skill
- **Install:** `agentstack add skill-yelban-camofox-browser-skills-camofox-browser`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yelban](https://agentstack.voostack.com/s/yelban)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yelban](https://github.com/yelban)
- **Source:** https://github.com/yelban/camofox-browser-skills/tree/main/camofox-browser

## Install

```sh
agentstack add skill-yelban-camofox-browser-skills-camofox-browser
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

1. **Navigate**: `camofox open ` — 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

```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                    # Create tab + navigate (aliases: goto)
camofox navigate                # 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](references/macros-and-search.md).

### Session Management
```bash
camofox --session work open     # 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](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?**
```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 
```

**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
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yelban](https://github.com/yelban)
- **Source:** [yelban/camofox-browser-skills](https://github.com/yelban/camofox-browser-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yelban-camofox-browser-skills-camofox-browser
- Seller: https://agentstack.voostack.com/s/yelban
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.