Migrar desde playwright-stealth o Patchright
Ya escribes Playwright, así que este es el cambio más corto: el launch() del SDK devuelve un Browser de Playwright. Reemplaza la línea que lanza el navegador y todas las líneas siguientes se quedan como están.
Desde 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()En playwright-stealth 2.x, el bloque Stealth().use_sync(sync_playwright()) se elimina de la misma forma. launch() inicia Playwright por sí mismo, acepta las opciones de lanzamiento propias de Playwright (headless, proxy, args, slow_mo) junto a las de Clearcote y descarga un build verificado en su caché la primera vez que se usa.
Desde 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()El SDK ya desactiva el viewport emulado de Playwright y el switch --enable-automation, así que no_viewport y channel sobran. Si aun así quieres conservar el driver de Patchright, inicia Clearcote con serve() y conecta Patchright con connect_over_cdp(srv.cdp_url); consulta Puppeteer y otros clientes CDP.
Qué más eliminar
| Lo que configuras | Con Clearcote |
|---|---|
evasiones con add_init_script | Elimínalas. El motor define estos valores de forma nativa |
user_agent=, viewport=, device_scale_factor= | Elimínalos. Vienen de la persona y concuerdan con la pantalla, la GPU y los Client Hints |
locale=, timezone_id= | geoip=True con un proxy, o accept_language y timezone en launch() |
| un user agent aleatorio en cada ejecución | Un seed fingerprint por cuenta. Un seed nuevo es un dispositivo nuevo y coherente |
| tus propias funciones de movimiento del mouse | humanize=True: trayectorias, escritura y scroll humanos en las propias llamadas de Playwright |
browser.new_context(...) sigue funcionando, pero sus opciones sobrescriben la persona. Omítelas o usa browser.new_page(), que abre una página con la persona tal cual.
Comprueba el cambio
clearcote info muestra el build que resuelve el SDK y una prueba de lanzamiento. Sin clave de licencia, ese es el build abierto (BSD-3, sin cuenta); un proxy con usuario y contraseña necesita el build más reciente, gratis al iniciar sesión con GitHub (clearcote login). Siguiente: Ajustes recomendados y Entrada humanizada. Comparativas: playwright-stealth y Patchright.