Aller au contenu

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éfinissezAvec 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écutionUn seed fingerprint par compte. Un nouveau seed, c’est un nouvel appareil cohérent
vos propres helpers de mouvement de sourishumanize=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.

Mis à jour le 20 oct. 2026 · SDK 0.70.5 · navigateur r63

Cette page vous a-t-elle été utile ?