## Camofox Browser

Anti-detection browser server for AI agents, powered by Camoufox. Stealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.

Standing on the mighty shoulders of Camoufox - a Firefox fork with fingerprint spoofing at the C++ level.

## Why

AI agents need to browse the real web. Playwright gets blocked. Headless Chrome gets fingerprinted. Stealth plugins become the fingerprint.

Camoufox patches Firefox at the C++ implementation level - navigator.hardwareConcurrency, WebGL renderers, AudioContext, screen geometry, WebRTC - all spoofed before JavaScript ever sees them. No shims, no wrappers, no tells.

This project wraps that engine in a REST API built for agents: accessibility snapshots instead of bloated HTML, stable element refs for clicking, and search macros for common sites.

## Try the beta free

```bash

git clone https://github.com/jo-inc/camofox-browser && cd camofox-browser

npm install && npm start

# -> http://localhost:9377

```

## Features

- **C++ Anti-Detection** - bypasses Google, Cloudflare, and most bot detection

- **Element Refs** - stable `e1`, `e2`, `e3` identifiers for reliable interaction

- **Token-Efficient** - accessibility snapshots are ~90% smaller than raw HTML

- **Runs on Anything** - lazy browser launch + idle shutdown keeps memory at ~40MB when idle. Designed to share a box with the rest of your stack -- Raspberry Pi, $5 VPS, shared infra.

- **Session Isolation** - separate cookies/storage per user

- **Cookie Import** - inject Netscape-format cookie files for authenticated browsing

- **File Upload** - attach files from a configured upload directory without a native OS dialog

- **Proxy + GeoIP** - route traffic through residential proxies with automatic locale/timezone

- **Structured Logging** - JSON log lines with request IDs for production observability

- **YouTube Transcripts** - extract captions from any YouTube video via yt-dlp, no API key needed

- **Search Macros** - `@google_search`, `@youtube_search`, `@amazon_search`, `@reddit_subreddit`, and 10 more

- **Snapshot Screenshots** - include a base64 PNG screenshot alongside the accessibility snapshot

- **Large Page Handling** - automatic snapshot truncation with offset-based pagination

- **Download Capture** - capture browser downloads and fetch them via API