Skip to content

docs: add CloakBrowser stealth browser example#1794

Open
Cloak-HQ wants to merge 1 commit intoapify:masterfrom
CloakHQ:add-cloakbrowser-example
Open

docs: add CloakBrowser stealth browser example#1794
Cloak-HQ wants to merge 1 commit intoapify:masterfrom
CloakHQ:add-cloakbrowser-example

Conversation

@Cloak-HQ
Copy link
Copy Markdown

Description

Add CloakBrowser integration example, following the same pattern as the existing Camoufox example.

CloakBrowser is a patched Chromium binary with source-level fingerprint modifications that passes Cloudflare Turnstile, reCAPTCHA v3 (0.9 score), and common bot detection checks where stock Chromium and playwright-stealth get blocked.

The integration uses a custom PlaywrightBrowserPlugin that swaps the default Chromium for CloakBrowser's binary. Same plugin pattern as Camoufox — override new_browser(), return a PlaywrightBrowserController.

Files

  • docs/examples/code_examples/playwright_crawler_with_cloakbrowser.py — example code
  • docs/examples/playwright_crawler_with_cloakbrowser.mdx — docs page

Testing

Tested on Linux x64 with Crawlee 1.5.0. The plugin launches CloakBrowser's binary, all stealth checks pass (webdriver=false, spoofed GPU/platform/plugins/hardwareConcurrency). Zero failed requests.

Checklist

  • CI passed

@Durafen Durafen force-pushed the add-cloakbrowser-example branch 4 times, most recently from 3368a71 to 54e0187 Compare March 16, 2026 18:36
@vdusek
Copy link
Copy Markdown
Collaborator

vdusek commented Mar 19, 2026

Hi @Cloak-HQ, thanks for your PR. We will discuss it with the team and let you know.

@vdusek
Copy link
Copy Markdown
Collaborator

vdusek commented Mar 29, 2026

We believe this would better fit in the Avoid getting blocked guide, under the Camoufox 🙂.

@Cloak-HQ Cloak-HQ force-pushed the add-cloakbrowser-example branch from 54e0187 to 24277fe Compare March 30, 2026 23:14
@Cloak-HQ
Copy link
Copy Markdown
Author

Thanks for the feedback! Moved the example into the "Avoid getting blocked" guide as a new section after Camoufox. Also added context on how CloakBrowser differs from the other options on the page (source-level C++ patches vs runtime JS overrides, Chromium-based vs Firefox).

Let us know if the placement and wording work for you, or if you'd like any changes.

Add CloakBrowser as a stealth browser option in the "Avoid getting
blocked" guide, alongside Camoufox. Includes integration example
using BrowserPool with a custom PlaywrightBrowserPlugin.
@Cloak-HQ Cloak-HQ force-pushed the add-cloakbrowser-example branch from 24277fe to f10cdd5 Compare March 30, 2026 23:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants