Migrar do playwright-stealth ou Patchright
Você já escreve Playwright, então esta é a migração mais curta: o launch() do SDK retorna um Browser do Playwright. Substitua a linha que inicia o navegador, e todas as linhas seguintes continuam iguais.
Do 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()No playwright-stealth 2.x, o bloco Stealth().use_sync(sync_playwright()) sai do mesmo jeito. launch() inicia o próprio Playwright, aceita as opções de inicialização do Playwright (headless, proxy, args, slow_mo) junto com as do Clearcote e baixa um build verificado para o cache no primeiro uso.
Do 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()O SDK já desativa o viewport emulado do Playwright e o switch --enable-automation, então no_viewport e channel saem. Para manter o driver do Patchright mesmo assim, inicie o Clearcote com serve() e conecte o Patchright com connect_over_cdp(srv.cdp_url); veja Puppeteer e outros clientes CDP.
O que mais remover
| O que você define | Com o Clearcote |
|---|---|
evasões com add_init_script | Remova. O motor define esses valores nativamente |
user_agent=, viewport=, device_scale_factor= | Remova. Eles vêm da persona e batem com a tela, a GPU e os Client Hints |
locale=, timezone_id= | geoip=True com um proxy, ou accept_language e timezone em launch() |
| um user agent aleatório a cada execução | Um seed fingerprint por conta. Um seed novo é um dispositivo novo e coerente |
| suas próprias funções de movimento do mouse | humanize=True: trajetórias, digitação e rolagem humanas nas próprias chamadas do Playwright |
browser.new_context(...) continua funcionando, mas as opções dele sobrescrevem a persona. Deixe-as de fora ou use browser.new_page(), que abre uma página com a persona como ela é.
Confira a mudança
clearcote info mostra o build que o SDK resolve e um teste de inicialização. Sem chave de licença, esse é o build aberto (BSD-3, sem conta); um proxy com usuário e senha precisa do build mais recente, grátis com login pelo GitHub (clearcote login). A seguir: Configurações recomendadas e Entrada humanizada. Comparações: playwright-stealth e Patchright.