Skip to content

HeadlessX v2.0.0 - 🦊 CAMOUFOX RELEASE

Choose a tag to compare

View all tags
@saifyxpro saifyxpro released this 31 Jan 12:00
· 119 commits to main since this release
v2.0.0
e286cef

[2.0.0] - 2026-01-28 🦊 CAMOUFOX RELEASE

🎉 Major Release: Complete Browser Engine Rewrite

HeadlessX V2.0 represents a complete rewrite of the browser engine, achieving 0% detection rate across all major anti-bot systems by replacing Chromium-based stealth with Camoufox (Firefox with C++ level fingerprint spoofing).

✨ Added

Browser Engine

  • Camoufox Browser Engine - Firefox with C++ level fingerprint spoofing
  • 0% Detection Rate - Passes CreepJS, Sannysoft, BrowserScan, and all major bot detection
  • WebRTC Protection - Built-in IP leak prevention
  • Binary-Level Stealth - Canvas, WebGL, and AudioContext spoofing at C++ level
  • Persistent Context Pooling - 3x faster browser launches

New Scrapers

  • Google SERP Scraper - Extract search results with zero detection
    • Organic results with position tracking
    • Featured snippets extraction
    • People Also Ask questions
    • Related searches
  • Website Scraper - Full-featured web scraping
    • Raw HTML extraction (fast)
    • JavaScript-rendered content
    • Markdown conversion for LLMs
    • Full-page screenshots (PNG/JPEG)
    • Real-time SSE streaming

API Endpoints

  • /api/website/html - Fast HTML extraction without JavaScript
  • /api/website/html-js - JavaScript rendering with wait options
  • /api/website/content - Clean markdown conversion
  • /api/website/screenshot - Screenshot capture with quality control
  • /api/website/stream - Real-time SSE stream with progress
  • /api/google-serp/search - Google SERP extraction
  • /api/google-serp/stream - Real-time SERP streaming

Documentation

  • Complete API Reference - All endpoints documented with curl examples
  • N8N Integration Guide - Workflow automation with examples
  • Zapier Integration Guide - No-code automation patterns
  • Make.com Integration Guide - Visual automation scenarios
  • Configuration Guide - Dashboard and environment settings
  • Installation Guide - Platform-specific setup (Windows, Linux, macOS)

Dashboard Features

  • Modern UI - Next.js 16 with React 19 and Turbopack
  • Live Configuration - Change settings without restart via Dashboard
  • Request Logs - Full history with screenshots and timing
  • Playground - Real-time testing interface for both scrapers
  • Profile Management - Persistent browser sessions and cookies
  • Proxy Management - Automatic rotation and validation

🚀 Improved

  • Performance - 3x faster browser initialization with context pooling
  • Stealth - From 67% detection (V1.3) to 0% detection (V2.0)
  • Reliability - Better error handling and automatic recovery
  • Documentation - Comprehensive guides with visual examples
  • Developer Experience - Simplified installation with one-command setup

🗑️ Removed

  • playwright-extra - No longer needed with Camoufox native stealth
  • puppeteer-extra-plugin-stealth - Replaced by C++ level patches
  • PDF endpoint (/api/website/pdf) - Removed for optimization
  • Generic component previews from docs - Focused on documentation clarity
  • All JavaScript-based fingerprint protection - Replaced by binary-level

🔧 Changed

  • Browser Engine - Migrated from Chromium to Firefox (Camoufox)
  • Config Management - Moved most settings from .env to Dashboard UI
  • Frontend - Upgraded to Next.js 16 with Turbopack and React 19
  • TypeScript - Upgraded to 5.9+ with stricter type checking
  • Node.js - Now requires Node.js 22+ for optimal performance

🐛 Fixed

  • Hydration mismatch in mobile navigation components
  • Invalid SVG attributes (fill-rule → fillRule) in icon components
  • Component preview build errors after library removal
  • Missing module imports after Badtz-UI refactoring
  • File system access errors in component library stubs
  • Emoji in heading IDs causing invalid CSS selectors

📦 Dependencies

Added:

  • camoufox - Stealth browser engine with Firefox
  • playwright 1.58+ - Browser automation framework

Updated:

  • next → 16.0.7 (with Turbopack)
  • react → 19.x
  • typescript → 5.9+
  • node → 22+
  • pnpm → 9+

Removed:

  • playwright-extra and all stealth plugins
  • puppeteer-extra-plugin-stealth
  • Legacy fingerprinting libraries

🚨 Breaking Changes

  1. Browser Engine: Chromium → Firefox (Camoufox)
  2. API Response Format: All responses wrapped in { success, data, error } structure
  3. PDF Endpoint Removed: /api/website/pdf no longer available
  4. Configuration: Most settings moved from .env to Dashboard UI
  5. Node.js Version: Requires Node.js 22+ (was 18+)

🔄 Migration Guide from V1.3

1. Update Dependencies

cd HeadlessX
pnpm install

2. Download Camoufox

pnpm camoufox:fetch

3. Update Environment Variables

# Remove old stealth configs
# Add new required vars
NEXT_PUBLIC_API_URL="http://localhost:3001"

4. Update API Integrations

// Old format
const html = response.html

// New format (V2.0)
const html = response.data.html

5. Remove PDF Endpoint Usage

// ❌ No longer available
POST /api/website/pdf

// ✅ Use screenshot instead
POST /api/website/screenshot

No Database Migration Required:

  • Database schema unchanged
  • Existing profiles remain compatible
  • API keys remain valid
Assets 2
Loading