The World's Most Advanced Anti-Detection Scraping Full Stack Web App

---

🎯 0% Detection Rate on all major anti-bot systems

Powered by Camoufox — Firefox with C++ level fingerprint spoofing

📖 Documentation • 🚀 Quick Start • 🐛 Report Bug • ✨ Request Feature

---

🆕 What's New in V2.0

🦊 Camoufox Engine	🛡️ 0% Detection	⚡ 3x Faster
Firefox with binary-level stealth patches	Passes CreepJS, Sannysoft, & all major tests	Optimized context pooling

V2.0 Changelog

+ 🦊 NEW: Camoufox browser engine (replaces Chromium + stealth plugins)
+ 🛡️ NEW: 0% headless detection rate (was 67%+)
+ 🔒 NEW: Built-in WebRTC leak protection
+ 🎭 NEW: C++ level Canvas/WebGL/AudioContext fingerprint spoofing
+ ⚡ IMPROVED: Faster browser launches with persistent contexts
+ 🧹 REMOVED: playwright-extra (no longer needed)
+ 🧹 REMOVED: puppeteer-extra-plugin-stealth (no longer needed)

---

📊 Detection Benchmark Comparison

Tool	Headless Detection	Stealth Score	Engine
🦊 HeadlessX V2.0 (Camoufox)	✅ 0%	✅ 0%	Firefox (C++ patched)
HeadlessX V1 (Playwright Extra)	❌ 67%	⚠️ 50%	Chromium (JS patches)
Puppeteer Stealth	❌ 33%	❌ 80%	Chromium (JS patches)
Vanilla Playwright	❌ 100%	❌ 100%	Chromium
Vanilla Selenium	❌ 100%	❌ 100%	Chrome

Lower scores = better (0% = undetectable)

---

🤖 Scrapers

Google SERP	🌐 Website Scraping
Extract search results with zero detection	Scrape any website with full JS rendering
✅ Live	✅ Live

Coming Soon

Amazon	LinkedIn	Twitter	Instagram
Product & Reviews	Job Listings & Profiles	Tweets & Trends	Posts & Stories

---

🖥️ UI Screenshots

Google SERP Scraper

Website Scraper

---

📸 Proof of Undetectability

BrowserScan (100% Passed)

Pixelscan (Human Detection)	Profile Tested with Proxy

---

📋 Table of Contents

• 🆕 What's New in V2.0
  • V2.0 Changelog
• 📊 Detection Benchmark Comparison
• 🤖 Scrapers
  • Coming Soon
• 📸 Proof of Undetectability
  • BrowserScan (100% Passed)
• 📋 Table of Contents
• ⚡ Quick Start
  • 1️⃣ Install Dependencies
  • 2️⃣ Setup Database
  • 3️⃣ Start the System
  • 3️⃣ Access the Dashboard
• 🔥 Key Features
  • 🦊 Camoufox Stealth Engine (V2.0)
  • 🖥️ Modern Dashboard
• 🌐 API Endpoints
  • Core Scraping APIs
  • Example Request
  • Example Response
• Configuration
  • Environment Variables
  • Dashboard Settings
• 🛠️ Manual Setup
  • Backend
  • Frontend
• 🤝 Contributing
• 📝 License
• 🌟 Star History
  • Built with ❤️ using cutting-edge technologies

---

⚡ Quick Start

Prerequisites: Node.js 18+, pnpm 9+

1️⃣ Install Dependencies

cd HeadlessX

# 1. Install Node.js dependencies
pnpm install

# 2. Install Model Dependencies & Download Models (YOLO/Recaptcha)
# Windows:
install.bat

# Linux/macOS:
chmod +x install.sh
./install.sh

2️⃣ Setup Database

# Push schema to database
pnpm db:push

# Or run migrations
pnpm db:migrate

3️⃣ Start the System

# Start both frontend and backend
pnpm dev

Or start individually:

Windows	Linux / macOS
scripts\start.bat	chmod +x scripts/start.sh ./scripts/start.sh

3️⃣ Access the Dashboard

🔗 Backend API	http://localhost:3001
🖥️ Dashboard	http://localhost:3000

---

🔥 Key Features

🦊 Camoufox Stealth Engine (V2.0) Feature Description 🔒 Binary-Level Patches Firefox modified at C++ level 🎭 Fingerprint Spoofing Canvas, WebGL, AudioContext 🌐 WebRTC Protection No IP leaks in headless mode 🖱️ Human Behavior Natural mouse movements & scrolling 📱 Device Emulation Realistic viewport & user agents 🚫 Zero Detection Passes all anti-bot tests

🖥️ Modern Dashboard Feature Description ⚛️ Next.js 16 React 19 with Turbopack 🎨 HeroUI Beautiful dark/light mode UI ⚙️ Live Config Change settings without restart 📊 Request Logs Full history with screenshots 🧪 Playground Test scraping in real-time 🔑 API Keys Secure key management

---

🌐 API Endpoints

Website Scraping APIs

Endpoint	Method	Description
/api/website/html	POST	Get raw HTML (fast)
/api/website/html-js	POST	Get HTML with JS rendering
/api/website/content	POST	Get Markdown content
/api/website/screenshot	POST	Capture full-page Screenshot
/api/website/stream	POST	Real-time SSE Stream

Google SERP APIs

Endpoint	Method	Description
/api/google-serp/search	POST	Extract Google search results
/api/google-serp/stream	GET	Real-time SSE Stream

Example Request

curl -X POST http://localhost:3001/api/website/html \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{"url": "https://example.com", "stealth": true}'

Example Response

{
  "success": true,
  "data": {
    "url": "https://example.com",
    "title": "Example Domain",
    "html": "<!DOCTYPE html>...",
    "statusCode": 200
  }
}

---

Configuration

Environment Variables

⚠️ Note: Most configuration (Browsers, Stealth, Proxy, Timeouts) is managed directly via the Dashboard Settings.

Only the following core variables are required in .env:

Variable	Default	Description
PORT	3001	Backend API port
DATABASE_URL	-	Supabase Connection String
NEXT_PUBLIC_API_URL	http://localhost:3001	Frontend API URL

Dashboard Settings

Configure these live at /settings:

General Configuration

• Headless Mode: Run browser without UI (faster execution)
• Browser Timeout: Max execution time per job (default: 60000ms)
• Max Concurrent Jobs: Concurrent scraping jobs (recommended: 3-8)

Browser Engine (Camoufox)

• Block WebRTC: Prevent IP leaks via WebRTC
• Camoufox GeoIP: Spoof location based on IP
• Enable Cache: Cache resources for speed

Proxies

• Manage proxy configurations and rotation settings

---

🛠️ Manual Setup

Backend

cd backend
pnpm install
npx camoufox-js fetch    # Download stealth Firefox
pnpm dev                 # Start dev server

Frontend

cd frontend
pnpm install
pnpm dev

---

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🌟 Star History

If you find HeadlessX useful, please consider giving it a star! ⭐

---

Built with ❤️ using cutting-edge technologies

🦊 HeadlessX V2.0 — Undetectable by Design

© 2026 HeadlessX. All rights reserved.