Stars
Forks
Watchers
Developer links
HeadlessX
With 2,000 GitHub stars and 10 releases since its September 2025 launch, HeadlessX delivers a self-hosted browser automation platform that replaces Chromium-based scraping with Camoufox — a Firefox fork performing kernel-level fingerprint spoofing to achieve 0% detection across Cloudflare, DataDome, PerimeterX, and other anti-bot systems where Puppeteer and Playwright regularly fail. The web dashboard provides workspace-based job organization with a visual interface for configuring scrape targets, managing browser profiles, monitoring queue status, and viewing extracted results in real time. The protected REST API accepts requests with API key authentication for programmatic access, supporting HTML extraction, screenshot capture, PDF generation, and structured data parsing with configurable stealth parameters. Profile-based scraping maintains persistent browser contexts with cookie jars, localStorage, and fingerprint configurations that survive between requests — reducing cold-start latency from 25 seconds to under 2 seconds on subsequent requests. Queue-backed workflows enable batch processing of URLs with configurable concurrency, retry logic, and webhook notifications on completion. The Google AI Search integration provides AI-assisted web research workflows through dedicated endpoints. Remote MCP support exposes automation capabilities as tool endpoints for AI agent integration. Deploy via the official CLI with `headlessx init` and `headlessx start` commands, scaffolding a Docker Compose stack with Caddy reverse proxy for automatic HTTPS. Running on a dedicated VPS on RepoCloud with guaranteed CPU, RAM, and SSD, full root SSH access, and a browser serial console. MIT licensed.
Benefits
- Zero Detection Browser Automation
- Achieves 0% detection rates against Cloudflare, DataDome, and PerimeterX using Camoufox's Firefox-based kernel-level fingerprint spoofing instead of detectable Chromium automation.
- Persistent Profile-Based Scraping
- Maintains browser contexts with cookies, localStorage, and fingerprints between requests, reducing response times from 25 seconds to under 2 seconds after initial profile launch.
- Queue-Backed Batch Processing
- Processes URL batches with configurable concurrency limits, automatic retry logic, and webhook completion notifications enabling reliable large-scale parallel data extraction workflows.
- AI Agent Integration via MCP
- Exposes browser automation as remote MCP tool endpoints allowing AI agents to perform web research, data extraction, and interaction tasks through natural language commands.
Features
- Camoufox Anti-Detect Engine
- Firefox-based browser runtime with kernel-level fingerprint spoofing, human-like interaction delays, and stealth toggle for bypassing all major anti-bot detection systems.
- Web Dashboard Interface
- Visual workspace for managing scrape jobs, browser profiles, queue status, and extracted results with real-time monitoring and configuration controls.
- Protected REST API
- API key-authenticated endpoints for HTML extraction, screenshots, PDF generation, and structured data parsing with configurable stealth and profile parameters.
- CLI-First Deployment
- Official @headlessx-cli/core package with init, start, stop, logs, and doctor commands scaffolding Docker Compose stacks with Caddy reverse proxy.
- Google AI Search
- Dedicated endpoints for AI-assisted web research workflows combining stealth browsing with structured search result extraction and summarization.