Skip to content

docs: add CloakBrowser stealth browser example#1892

Open
Cloak-HQ wants to merge 1 commit intounclecode:developfrom
Cloak-HQ:add-cloakbrowser-example
Open

docs: add CloakBrowser stealth browser example#1892
Cloak-HQ wants to merge 1 commit intounclecode:developfrom
Cloak-HQ:add-cloakbrowser-example

Conversation

@Cloak-HQ
Copy link
Copy Markdown

@Cloak-HQ Cloak-HQ commented Apr 1, 2026

Summary

Adds a CloakBrowser integration example to docs/examples/, alongside the existing stealth mode examples. CloakBrowser is a stealth Chromium binary with source-level C++ fingerprint patches that passes Cloudflare, reCAPTCHA, and other bot detection.

The example launches CloakBrowser locally and connects Crawl4AI via CDP. Includes three examples: basic crawling, bot detection verification (with screenshot + parsed results table), and proxy usage.

List of files changed and why

  • docs/examples/stealth_cloakbrowser.py — New example showing how to use CloakBrowser as an external stealth browser with Crawl4AI via CDP. Follows the same structure as existing stealth examples.

How Has This Been Tested?

Tested in Docker (headless Linux) with Crawl4AI 0.8.6 and CloakBrowser v0.3.19. CDP connection establishes correctly, crawler extracts markdown and takes screenshots. Bot detection site (bot.sannysoft.com) returns 57/57 tests passed.

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • I have added/updated unit tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes

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.

1 participant