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.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party 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-stealth or undetected-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=True flag 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.