CloakBrowser: Stealth Chromium That Passes Every Bot Detection Test — 25,000 Stars for Scraping — A Practical Guide 2026
CloakBrowser (25,077 GitHub stars) is a stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 30/30 tests passed. Includes setup tutorial, anti-detection breakdown, and benchmarks.
- ⭐ 27882
- Updated 2026-06-08
Puppeteer: 94,300 GitHub Stars • Obscura: Rust Headless Browser for AI Agents — 14,000 Stars
┌──────────────────────────────────────────────────────┐
│ CloakBrowser Anti-Detection │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Canvas │ │ WebGL │ │ Audio │ │
│ │ Fingerprint │ │ Fingerprint │ │ Fingerprint │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │
│ ┌──────▼────────────────▼─────────────────▼──────┐ │
│ │ Source-Level Patches │ │
│ │ • navigator.webdriver = false │ │
│ │ • chrome runtime spoofing │ │
│ │ • TLS fingerprint randomization │ │
│ │ • WebRTC leak prevention │ │
│ │ • Headless detection bypass │ │
│ │ • Geolocation spoofing │ │
│ └───────────────────────┬───────────────────────┘ │
│ │ 30/30 tests passed │
│ ┌───────────────────────▼───────────────────────┐ │
│ │ Anti-detection browser │ │
│ └───────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────┘
CloakBrowser: drop-in Playwright replacement that passes every bot test
Introduction #
If you’re scraping websites in 2026, you’re probably fighting Cloudflare, Datadome, PerimeterX, and dozens of other bot detection systems. Traditional headless browsers get blocked within minutes. CloakBrowser (25,077 GitHub stars) is a stealth Chromium that patches itself at the source level — not with hacks or workarounds, but with proper fingerprint spoofing — and passes 30/30 anti-bot detection tests. Drop-in replacement for Playwright, works with Python and Node.js, and takes 5 minutes to integrate. Built for scrapers, testers, and automation engineers who need to pass detection, not just bypass it.
What Is CloakBrowser? #
CloakBrowser is a stealth Chromium browser engine patched at the source level to pass every known bot detection test. Unlike extensions or runtime hacks that leave detectable traces, CloakBrowser modifies Chromium’s source code to eliminate fingerprint inconsistencies — the same way a real Chrome browser would have them.
Key capabilities:
- Source-level patches — Modify Chromium at build time, not runtime hacks
- 30/30 detection tests passed — Passes major bot detection systems (Cloudflare, Datadome, PerimeterX, etc.)
- Drop-in Playwright replacement — Replace
playwright.chromium.launch()with one line - TLS fingerprint randomization — Rotate TLS fingerprints like real browsers
- WebRTC leak prevention — Prevent IP leak through WebRTC
- Headless detection bypass — Hide all headless browser signatures
- Resource usage — Lighter than Puppeteer, compatible with Playwright
Built as a fork of Chromium with ~200 source-level patches applied. Supports Python and Node.js APIs.
How CloakBrowser Works #
Stage 1: Installation #
# Install CloakBrowser for Python
pip install cloakbrowser
Stage 2: Python Integration #
# Install CloakBrowser for Node.js
npm install cloakbrowser
CloakBrowser drops into existing Playwright scripts as a direct replacement for the Chromium browser executable. Replace playwright.chromium.launch() with the CloakBrowser executable path.
Stage 3: Test Stealth #
# Verify stealth configuration with Docker
docker run --rm cloakhq/cloakbrowser cloaktest
The cloaktest command runs a comprehensive suite of 30 bot detection tests, verifying that your CloakBrowser build passes all anti-detection checks.
Installation & Setup #
Quick Start (Python) #
# Install CloakBrowser
pip install cloakbrowser
# Test installation
docker run --rm cloakhq/cloakbrowser cloaktest
Node.js Setup #
# Install CloakBrowser
npm install cloakbrowser
# Test installation
docker run --rm cloakhq/cloakbrowser cloaktest
Proxy Integration #
CloakBrowser works with any proxy configuration. Configure proxies through the Playwright browser launch options:
- HTTP proxies — Basic username/password authentication
- HTTPS proxies — Encrypted proxy connections
- SOCKS5 proxies — For advanced routing scenarios
- Residential proxy pools — Rotate through residential IP ranges
- Datacenter proxies — Low-cost bulk scraping
Source-Level Patching #
CloakBrowser applies patches at Chromium build time — not runtime hacks. The patches modify navigator.webdriver, chrome.runtime, WebGL renderer, TLS fingerprint, headless detection, user agent, timezone, language, plugin enumeration, and font enumeration at the C++ source level.
Benchmarks / Real-World Use Cases #
Anti-Bot Detection Test Results #
| Detection System | Standard Chromium | CloakBrowser | |
💬 Discussion