CloakHQ/CloakBrowser

CloakBrowser – Playwright / Puppeteer 用ステルス Chromium

何であるか

• C++ ソースレベルで 87 のパッチを適用したカスタムビルド Chromium バイナリ。目的は、リモートのボット検出サービスに対して、通常のヘッドレスでない Chrome とまったく同じように見えるようにすること。
• バイナリは、Python、JavaScript/Node、.NET の薄いラッパーで包まれており、Playwright（および Puppeteer）と同じ API を公開しています。import { launch } from 'cloakbrowser'（または from cloakbrowser import launch）をそのまま挿入することで、既存の自動化コードを変更せずに利用可能。

AIエージェント / 自動化において重要な理由

• LangChain、Crawl4AI などの現代的な AI エージェントは、動的ページを取得するためにブラウザに依存しています。しかし、これらのエージェントは reCAPTCHA、Cloudflare Turnstile、FingerprintJS などにブロックされることがよくあります。CloakBrowser は、チャレンジが発生する前にそれを防ぐことで、別途 CAPTCHA 解決サービスを用意する必要をなくします。
• ステルス機能がバイナリに組み込まれているため、Chrome のアップデートに対しても耐性があり、JavaScript ベースの「ステルスプラグイン」を繰り返し適用する必要がありません。

主な機能（README に記載）

機能	詳細
ソースレベルのステルス	canvas、WebGL、音声、フォント、GPU、画面サイズ、WebRTC、ネットワークタイミング、自動化フラグ、CDP 入力動作など、87 の C++ パッチ
ヒューマン化フラグ	humanize=True で、マウス移動、入力、スクロールが現実的なベジェ曲線とタイミングに従います
高スコアの reCAPTCHA v3	最新ビルドで 0.9（人間レベル）と報告
Cloudflare Turnstile、FingerprintJS、BrowserScan を通過	30 以上の検出サイトでテスト済み
正しいバイナリの自動ダウンロード	pip install cloakbrowser / npm install cloakbrowser で適切な Chromium ビルド（無料または Pro）を取得し、ローカルにキャッシュ
プロキシ & ジオIP対応	HTTP または SOCKS5 プロキシをサポート；geoip=True でタイムゾーン/ロケールを同期し、WebRTC ICE キャンディデートをプロキシのエグジットIPに偽装
クロス言語ラッパー	Python、Node（Playwright および Puppeteer）、.NET（NuGet パッケージ）
Docker 対応	docker run --rm cloakhq/cloakbrowser cloaktest で簡易検証が可能；コンテナ内でヘッドレスで動作
永続的プロファイル & 拡張機能	launch_persistent_context() でクッキー/LocalStorage を保持；extension_paths で Chrome 拡張機能をロード可能
CloakBrowser Manager（GUI）	別途オープンソースの GUI（MIT ライセンス）で、無制限の分離プロファイルを作成可能。各プロファイルには独自のフィンガープリント、プロキシ、CDP エンドポイントが設定可能

通常の使用例（Python）

from cloakbrowser import launch

browser = launch(
    proxy="http://user:pass@residential-proxy:8080",
    geoip=True,
    headless=False,
    humanize=True,
)
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()

通常の使用例（Node – Playwright）

import { launch } from 'cloakbrowser';

const browser = await launch({
  proxy: 'http://user:pass@residential-proxy:8080',
  geoip: true,
  headless: false,
  humanize: true,
});
const page = await browser.newPage();
await page.goto('https://example.com');
await browser.close();

インストール

• Python: pip install cloakbrowser
• Node: npm install cloakbrowser playwright-core（Puppeteer 用は ... puppeteer-core）
• .NET: dotnet add package CloakBrowser
• 最初の実行時に適切な Chromium バイナリ（約 200 MiB）を自動ダウンロードし、Ed25519 署名で検証されます。

ライセンス & 料金

• リポジトリは MIT ライセンス；バイナリは別途ライセンスで配布。
• GitHub サインインで取得可能な無料キーは、最新ビルドで 1 つの同時実行セッションを提供。
• CloakBrowser Pro は無制限の同時実行セッション、優先更新、サポートを提供。キーは CLOAKBROWSER_LICENSE_KEY 環境変数または license_key 引数で設定。

内部の仕組み

1. バイナリビルド – チームは Chromium をフォークし、87 のパッチを適用、各プラットフォーム用にビルド、アーカイブを署名、ホスティング。
2. ラッパー – Python/JS/.NET パッケージは、バイナリをダウンロードし、Playwright/Puppeteer を介して起動し、いくつかの起動引数（例：--fingerprint-webrtc-ip=auto）を注入。
3. 検証 – ダウンロードは公開された Ed25519 チェックサムと照合され、改ざんを防止。

必要となる場面

• ヘッドレスブラウザを厳しく検出するサイトのスクレイピング。
• 人間の介入なしでブラウジングが必要だが、目立たずにいる必要がある AI エージェントの実行。
• 実際のユーザーとまったく同じようにページをレンダリングする必要がある QA やモニタリングパイプライン。
• 今現在、脆弱な「ステルスプラグイン」に依存している任意の自動化。

制限事項

• CloakBrowser は、すでに表示された CAPTCHA を解決するものではありません。表示されないようにするだけです。
• 最高の成功率を得るためには、自前でリジデンシャルプロキシを用意する必要があります。
• 無料版は 1 つの同時実行セッションに制限されています。大規模なスケーリングには Pro ライセンスが必要です。

---

上記のすべての情報は、プロジェクトの README から直接引用；追加機能は推測されていません。