Camofox — Stealth Headless Browser for AI Agent Automation

Introduction

Camofox is a stealth headless browser built specifically for AI agent pipelines that need reliable web access. It patches browser fingerprints and bypasses common anti-bot systems like Cloudflare Turnstile, making it a drop-in replacement for standard Puppeteer or Playwright when sites block automated browsers.

What Camofox Does

• Launches a fingerprint-patched browser that passes bot detection checks
• Provides a Puppeteer-compatible API for minimal migration effort
• Bypasses Cloudflare, DataDome, and similar anti-scraping services
• Manages browser profiles and cookies across sessions
• Supports concurrent pages with independent fingerprint contexts

Architecture Overview

Camofox wraps a modified Firefox build with custom patches to WebGL, Canvas, AudioContext, and navigator properties. It randomizes fingerprint vectors per session while maintaining internal consistency. The Node.js API layer speaks the same protocol as Puppeteer, so existing scripts work with a single import change.

Self-Hosting & Configuration

• Install via npm; browser binary downloads automatically
• Configure proxy settings via launch options for IP rotation
• Persist sessions with user data directories for cookie management
• Set custom viewport, timezone, and locale per browser context
• Docker image available for containerized deployments

Key Features

• Passes major bot detection services without manual CAPTCHA solving
• Puppeteer-compatible API minimizes migration effort
• Per-context fingerprint randomization prevents correlation
• Built-in retry logic for transient network failures
• Headful mode available for debugging automation scripts

Comparison with Similar Tools

• Puppeteer/Playwright — detected by most anti-bot services vs undetected by default
• undetected-chromedriver — Python-only and Chrome-based vs Node.js with Firefox stealth
• Browserless — cloud-hosted vs self-hosted with no per-request fees
• Selenium — legacy WebDriver protocol vs modern CDP with stealth patches
• Browser Use — AI-driven navigation vs programmatic control with stealth focus

FAQ

Q: Is this legal to use? A: Camofox is a browser automation tool. Legality depends on your use case and the target site's terms of service.

Q: Does it work with Playwright scripts? A: It provides a Puppeteer-compatible API. Playwright scripts need minor adapter changes.

Q: How does it handle CAPTCHAs? A: It avoids triggering CAPTCHAs through fingerprint stealth rather than solving them.

Q: Can I run multiple concurrent sessions? A: Yes, each browser context gets an independent fingerprint and can run in parallel.

Sources

• https://github.com/jo-inc/camofox-browser
• https://github.com/jo-inc/camofox-browser#readme