CloakBrowser: Stealth Chromium for Unblockable Web Scraping and Automation
Summary
CloakBrowser is a powerful, open-source stealth Chromium browser engineered to bypass advanced bot detection systems. It achieves unparalleled stealth through C++ source-level fingerprint patches, making it appear as a normal browser and passing over 30 detection tests. Designed as a drop-in replacement for Playwright and Puppeteer, it simplifies web automation for AI agents, web scraping, and more.
Repository Info
Tags
Click on any tag to explore related repositories
Introduction
CloakBrowser is a cutting-edge stealth Chromium browser that consistently passes every bot detection test. Unlike other tools that rely on JavaScript injections or configuration tweaks, CloakBrowser modifies Chromium's C++ source code to patch fingerprints at the binary level. This means anti-bot systems perceive it as a genuine, unautomated browser, achieving a perfect 30/30 score in detection tests. It offers a seamless, drop-in replacement for Playwright and Puppeteer, allowing developers to unblock their automation tasks in minutes with just a few lines of code.
Installation
Getting started with CloakBrowser is straightforward, with packages available for both Python and JavaScript environments.
Python:
pip install cloakbrowser
JavaScript / Node.js:
# With Playwright
npm install cloakbrowser playwright-core
# With Puppeteer
npm install cloakbrowser puppeteer-core
Upon the first launch, the stealth Chromium binary, approximately 200MB, is automatically downloaded and cached locally.
Examples
CloakBrowser maintains the familiar Playwright and Puppeteer APIs, making integration effortless. Here are basic examples for Python and JavaScript:
Python:
from cloakbrowser import launch
browser = launch()
page = browser.new_page()
page.goto("https://example.com")
browser.close()
For human-like interactions, simply add humanize=True:
browser = launch(humanize=True)
page = browser.new_page()
page.goto("https://example.com")
page.locator("#email").fill("user@example.com") # per-character timing, thinking pauses
page.locator("button[type=submit]").click() # Bézier curve, realistic aim point
browser.close()
JavaScript (Playwright):
import { launch } from 'cloakbrowser';
const browser = await launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();
Why Use CloakBrowser
CloakBrowser stands out from other stealth solutions due to its fundamental approach to bypassing bot detection:
- Source-Level Patches: Instead of easily detectable JavaScript injections or config-level tweaks, CloakBrowser's 58+ fingerprint patches are compiled directly into the Chromium binary. This makes it significantly more robust and resistant to updates that often break other stealth tools.
- Unmatched Detection Scores: It achieves a 0.9 reCAPTCHA v3 score, passes Cloudflare Turnstile, FingerprintJS, and BrowserScan, demonstrating superior stealth capabilities compared to
playwright-stealthorundetected-chromedriver. - Seamless Integration: It's a true drop-in replacement for Playwright and Puppeteer, requiring minimal code changes to integrate into existing automation workflows.
- Human-like Behavior: The
humanize=Trueflag enables realistic mouse movements, keyboard typing, and scroll patterns, further enhancing its ability to evade behavioral detection. - Free and Open Source: CloakBrowser offers enterprise-grade stealth without subscriptions or usage limits.
Links
- GitHub Repository: https://github.com/CloakHQ/CloakBrowser
- Official Website: https://cloakbrowser.dev
- PyPI Package: https://pypi.org/project/cloakbrowser/
- npm Package: https://www.npmjs.com/package/cloakbrowser
- Bug Reports & Feature Requests: https://github.com/CloakHQ/CloakBrowser/issues
- Support CloakHQ: https://ko-fi.com/cloakhq