Camoufox からの移行
Camoufox と Clearcote は同じ仕組みで動きます。どちらもエンジンにパッチを当て、Playwright のオブジェクトを返します。移行作業の大半は、Firefox から Chromium への名前の置き換えです。
変更点
from camoufox.sync_api import Camoufox
from clearcote import launch
with Camoufox(
browser = launch(
headless=True,
os="windows",
platform="windows",
fingerprint="acct-1", # new: one seed per account, the same device every run
geoip=True,
proxy={"server": "http://proxy.example:8080", "username": "user", "password": "pass"},
humanize=True,
) as browser:
page = browser.new_page()
page.goto("https://example.com")
)
page = browser.new_page()
page.goto("https://example.com")
browser.close()オプションごとの対応
| Camoufox | Clearcote |
|---|---|
headless="virtual" | headless=True(デフォルト):ヘッドレスでも実寸の画面が使われます |
システムのリストを渡す os= | platform="windows"、"macos"、"linux" のいずれか。アカウントごとにひとつ選びます |
| 起動のたびに新しいフィンガープリント | fingerprint="<seed>":同じシードなら同じデバイス、新しいシードなら無関係な別のデバイスになります |
locale="de-DE" | accept_language="de-DE,de"、または geoip に設定させます |
persistent_context=True, user_data_dir=... | launch_persistent_context(user_data_dir, ...) |
addons=[path](Firefox アドオン) | extensions=[path]:展開済みの Chrome 拡張機能 |
block_images=True | Playwright の page.route(下記参照) |
config={...}, firefox_user_prefs | 相当するものはありません。フィンガープリントの値はシード、または取得したデバイスプロファイルから得られます |
python
# instead of block_images=True
page.route("**/*", lambda route: route.abort() if route.request.resource_type == "image" else route.continue_())Firefox から Chromium へ
- Playwright のコードはそのまま動きます。ロケーター、
evaluate、ルート、待機は、どちらのエンジンでも同じ API です。 - Chromium 専用の機能が使えます:
page.pdf()、CDP セッション、そしてどのツールからでもserve()で接続できる CDP エンドポイントです。 - プロファイルは引き継げません。Chromium は Firefox のプロファイルを開けません。Camoufox で
context.storage_state(path="state.json")を使って Cookie を保存し、context.add_cookies(state["cookies"])で読み込んでください。サイトからは一度だけ新しいデバイスとして見えます。 - Python だけではありません。同じ
launch()が Node と .NET の SDK にもあり、Docker イメージも用意されています。
切り替えを確認する
clearcote info は、SDK が解決するビルドと起動テストの結果を表示します。ライセンスキーがない場合はオープンビルド(BSD-3)です。ユーザー名とパスワード付きのプロキシには最新ビルドが必要で、GitHub でサインインすれば無料で使えます。次へ:推奨設定。比較:Clearcote vs Camoufox。
どこまで深いか
比較したどのフォークと比べても 2 倍以上のパッチ数。
Chromium にコンパイルされたパッチの数を、アプローチ別に示します。スクリプトベースのツールはエンジンをまったく変更しません。
ステルスプラグイン
例:puppeteer-extra-plugin-stealth
0
パッチ済みドライバー
例:undetected-chromedriver、nodriver
0
他の Chromium フォーク
無料ビルドと有料ビルド
35–87
Clearcote Pro
r63、Chromium 158
266
公開されているパッチ数(2026年10月 時点)。範囲は他のフォークの無料ビルドと有料ビルドを含みます。Clearcote の数値は Pro ビルドのものです。
読む
オープンビルドのパッチは公開されています
無料のオープンビルドは BSD-3 で、ソースから再現でき、アカウントも不要です。Pro ビルドは、その上に非公開のパッチを加えています。
GitHub で開くリリースを追う
エンジンのリリース 63 回、Chromium メジャーバージョン 9 世代
すべてのパッチを新しい Chromium ごとに移植しています。最新ビルドは新しいメジャーバージョンに公開当日に対応します。
リリースを見る