Saltar al contenido

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 configurasCon Clearcote
evasiones con add_init_scriptElimí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ónUn seed fingerprint por cuenta. Un seed nuevo es un dispositivo nuevo y coherente
tus propias funciones de movimiento del mousehumanize=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.

Actualizado el 20 oct 2026 · SDK 0.70.5 · navegador r63

¿Te resultó útil esta página?