Migration von playwright-stealth oder Patchright
Sie schreiben bereits Playwright, daher ist das der kürzeste Wechsel: launch() aus dem SDK gibt einen Playwright-Browser zurück. Ersetzen Sie die Zeile, die den Browser startet; jede Zeile danach bleibt.
Von 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()Unter playwright-stealth 2.x fällt der Block Stealth().use_sync(sync_playwright()) genauso weg. launch() startet Playwright selbst, nimmt neben den Clearcote-Optionen auch die Launch-Optionen von Playwright an (headless, proxy, args, slow_mo) und lädt beim ersten Aufruf einen verifizierten Build in seinen Cache.
Von 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()Das SDK schaltet den emulierten Viewport von Playwright und den Schalter --enable-automation bereits ab, daher fallen no_viewport und channel weg. Wenn Sie den Treiber von Patchright trotzdem behalten möchten, starten Sie Clearcote mit serve() und verbinden Patchright mit connect_over_cdp(srv.cdp_url); siehe Puppeteer und andere CDP-Clients.
Was Sie sonst entfernen
| Sie setzen | Mit Clearcote |
|---|---|
Evasions per add_init_script | Entfernen. Die Engine setzt diese Werte nativ |
user_agent=, viewport=, device_scale_factor= | Entfernen. Sie kommen aus der Persona und passen zu Bildschirm, GPU und Client Hints |
locale=, timezone_id= | geoip=True mit einem Proxy, oder accept_language und timezone bei launch() |
| ein zufälliger User-Agent pro Lauf | Ein fingerprint-Seed pro Account. Ein neuer Seed ist ein neues, kohärentes Gerät |
| eigene Helfer für Mausbewegungen | humanize=True: menschliche Bewegungspfade, Tippen und Scrollen in den Aufrufen von Playwright selbst |
browser.new_context(...) funktioniert weiterhin, aber seine Optionen überschreiben die Persona. Lassen Sie sie weg oder nutzen Sie browser.new_page(), das eine Seite mit der unveränderten Persona öffnet.
Den Wechsel prüfen
clearcote info zeigt den Build, den das SDK auflöst, und einen Starttest. Ohne Lizenzschlüssel ist das der offene Build (BSD-3, kein Konto); ein Proxy mit Benutzername und Passwort braucht den neuesten Build, kostenlos per GitHub-Anmeldung (clearcote login). Weiter: Empfohlene Einstellungen und Menschenähnliche Eingaben. Vergleiche: playwright-stealth und Patchright.