Migrer depuis playwright-stealth ou Patchright
Vous écrivez déjà du Playwright, c’est donc la migration la plus courte : le launch() du SDK renvoie un Browser Playwright. Remplacez la ligne qui lance le navigateur, et toutes les lignes suivantes restent en place.
Depuis 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()Avec playwright-stealth 2.x, le bloc Stealth().use_sync(sync_playwright()) disparaît de la même façon. launch() démarre Playwright lui-même, accepte les options de lancement propres à Playwright (headless, proxy, args, slow_mo) à côté de celles de Clearcote, et télécharge un build vérifié dans son cache à la première utilisation.
Depuis 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()Le SDK désactive déjà le viewport émulé de Playwright et le switch --enable-automation, donc no_viewport et channel disparaissent. Pour garder malgré tout le driver de Patchright, démarrez Clearcote avec serve() et connectez Patchright avec connect_over_cdp(srv.cdp_url) ; voir Puppeteer et autres clients CDP.
Ce qu’il reste à supprimer
| Vous définissez | Avec Clearcote |
|---|---|
évasions via add_init_script | À supprimer. Le moteur définit ces valeurs nativement |
user_agent=, viewport=, device_scale_factor= | À supprimer. Ces valeurs viennent de la persona et concordent avec l’écran, le GPU et les Client Hints |
locale=, timezone_id= | geoip=True avec un proxy, ou accept_language et timezone sur launch() |
| un user agent aléatoire à chaque exécution | Un seed fingerprint par compte. Un nouveau seed, c’est un nouvel appareil cohérent |
| vos propres helpers de mouvement de souris | humanize=True : trajectoires, frappe et défilement humains dans les appels mêmes de Playwright |
browser.new_context(...) fonctionne toujours, mais ses options écrasent la persona. Omettez-les, ou utilisez browser.new_page(), qui ouvre une page avec la persona telle quelle.
Vérifier le changement
clearcote info affiche le build que le SDK résout et un test de lancement. Sans clé de licence, c’est le build ouvert (BSD-3, sans compte) ; un proxy avec nom d’utilisateur et mot de passe nécessite le dernier build, gratuit avec une connexion GitHub (clearcote login). Ensuite : Réglages recommandés et Entrées humanisées. Comparatifs : playwright-stealth et Patchright.