Zum Inhalt springen

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 setzenMit Clearcote
Evasions per add_init_scriptEntfernen. 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 LaufEin fingerprint-Seed pro Account. Ein neuer Seed ist ein neues, kohärentes Gerät
eigene Helfer für Mausbewegungenhumanize=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.

Aktualisiert am 20. Okt. 2026 · SDK 0.70.5 · Browser r63

War diese Seite hilfreich?