playwright-stealth または Patchright からの移行
すでに Playwright で書いているなら、これが最も短い移行です。SDK の launch() は Playwright の Browser を返します。ブラウザを起動する行を置き換えれば、それ以降の行はすべてそのまま使えます。
playwright-stealth から
from playwright.sync_api import sync_playwright
from playwright_stealth import stealth_sync
from clearcote import launch
browser = sync_playwright().start().chromium.launch(proxy={"server": "http://proxy.example:8080"})
page = browser.new_page(user_agent="Mozilla/5.0 ...", locale="de-DE", timezone_id="Europe/Berlin")
stealth_sync(page)
browser = launch(
fingerprint="acct-1", # one seed per account: the same device every run
proxy={"server": "http://proxy.example:8080"},
geoip=True, # timezone, language and WebRTC follow the exit IP
)
page = browser.new_page()
page.goto("https://example.com")
browser.close()playwright-stealth 2.x の Stealth().use_sync(sync_playwright()) ブロックも同じように削除します。launch() は Playwright 自体を起動し、Clearcote のオプションに加えて Playwright 本来の起動オプション(headless、proxy、args、slow_mo)も受け付けます。初回利用時には検証済みのビルドをキャッシュにダウンロードします。
Patchright から
from patchright.sync_api import sync_playwright
from clearcote import launch_persistent_context
context = sync_playwright().start().chromium.launch_persistent_context(
user_data_dir="profiles/acct-1", channel="chrome", headless=False, no_viewport=True,
)
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1", headless=False)
page = context.new_page()
page.goto("https://example.com")
context.close()SDK は Playwright のエミュレートされたビューポートと --enable-automation スイッチを最初から無効にしているため、no_viewport と channel は不要です。それでも Patchright のドライバーを使い続けたい場合は、serve() で Clearcote を起動し、connect_over_cdp(srv.cdp_url) で Patchright を接続してください。詳しくはPuppeteer などの CDP クライアントを参照してください。
ほかに削除するもの
| 設定していたもの | Clearcote の場合 |
|---|---|
add_init_script による evasion | 削除します。これらの値はエンジンがネイティブに設定します |
user_agent=, viewport=, device_scale_factor= | 削除します。これらはペルソナから決まり、画面、GPU、Client Hints と整合します |
locale=, timezone_id= | プロキシと併せて geoip=True、または launch() の accept_language と timezone |
| 実行ごとのランダムな User-Agent | アカウントごとに 1 つの fingerprint シード。新しいシードは、整合性のある新しいデバイスになります |
| 自作のマウス移動ヘルパー | humanize=True:Playwright 自体の呼び出しで、人間らしい軌跡、タイピング、スクロールになります |
browser.new_context(...) も引き続き使えますが、そのオプションはペルソナを上書きします。オプションを省くか、ペルソナをそのまま使ってページを開く browser.new_page() を使ってください。
切り替えの確認
clearcote info を実行すると、SDK が解決するビルドと起動テストの結果が表示されます。ライセンスキーがなければオープンビルド(BSD-3、アカウント不要)です。ユーザー名とパスワード付きのプロキシには最新ビルドが必要で、GitHub でサインインすれば無料で使えます(clearcote login)。次に読むページ:推奨設定、人間らしい入力。比較ページ:playwright-stealth、Patchright。