camofox-browser

Headless browser automation server wrapping Camoufox (Firefox fork with C++-level fingerprint spoofing) behind a REST API designed for AI agents. Default port 9377. Source: https://github.com/jo-inc/camofox-browser

What It Is

A Node.js/Express server (server.js) that exposes a Camoufox browser engine as HTTP endpoints. Agents create tabs, fetch token-efficient accessibility snapshots with stable element refs (e1, e2, …), and interact by ref rather than by CSS selector or raw coordinates. Cookies, proxies, search macros, YouTube transcript extraction, and session persistence are built in. Plugins extend the server with new routes, lifecycle hooks, and Prometheus metrics.

Architecture

Browser Instance (Camoufox)
└── User Session (BrowserContext)   — isolated cookies/storage per userId
    ├── Tab Group (sessionKey)      — groups tabs by conversation/task
    │   ├── Tab (google.com)
    │   └── Tab (github.com)
    └── Tab Group
        └── Tab