Overview

camofox-browser is a cutting-edge, stealth headless browser server designed specifically for AI agents. It provides a robust solution for bypassing sophisticated bot detection mechanisms, including Cloudflare and other anti-scraping technologies. Seamlessly acting as a drop-in replacement for Puppeteer and Playwright, it leverages the power of Camoufox, a Firefox fork patched at the C++ level for unparalleled fingerprint spoofing. This ensures that AI agents can navigate the web undetected, mimicking human browsing behavior with exceptional accuracy.

Key Features

• Advanced Anti-Detection: Camoufox's C++ level patching directly spoofs crucial browser fingerprints (hardware concurrency, WebGL, AudioContext, WebRTC, screen geometry) before JavaScript can even detect them. This makes it incredibly difficult for detection systems to flag bot traffic.
• Drop-in Replacement: Designed to seamlessly integrate with existing AI agent workflows, offering a familiar API for developers accustomed to Puppeteer or Playwright.
• Token-Efficient Snapshots: Generates lightweight accessibility snapshots, approximately 90% smaller than raw HTML, significantly reducing data transfer and processing overhead for agents.
• Stable Element References: Provides stable e1, e2, e3 identifiers for DOM elements, ensuring reliable and consistent interaction with web pages.
• Resource-Lightweight: With lazy browser launches and idle shutdowns, it maintains minimal memory usage (~40MB when idle), making it ideal for resource-constrained environments like Raspberry Pis or low-cost VPS.
• Session Isolation & Persistence: Manages separate cookies and localStorage for each user, with optional persistence to ensure authenticated states are maintained across browser restarts.
• Enhanced Functionality: Includes features like cookie import, file uploads, proxy integration with GeoIP, structured logging, and YouTube transcript extraction.
• Search Macros: Offers pre-built macros for common sites like Google, YouTube, and Amazon, simplifying agent interactions.
• Interactive Debugging: Supports VNC interactive login via noVNC for visual debugging and session state export.
• OpenAPI Specification: Provides auto-generated OpenAPI 3.0 documentation for easy integration and exploration.

Typical Use Cases

• Web Scraping & Data Extraction: Enables AI agents to gather data from websites that employ aggressive anti-bot measures, such as e-commerce sites, social media platforms, and financial services.
• Automated Testing: Facilitates the creation of more realistic and resilient end-to-end tests for web applications by simulating human-like browser interactions.
• Market Research & Analysis: Allows for the collection of real-time market data and competitor analysis from complex web interfaces without being detected or blocked.
• AI Agent Navigation: Empowers AI agents to browse, interact with, and understand the dynamic content of the modern web, expanding their capabilities beyond static data sources.
• Content Moderation & Verification: Assists in automated content review and verification processes on platforms that require sophisticated web interaction.