Pular para o conteúdo

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ê defineCom o Clearcote
evasões com add_init_scriptRemova. 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çãoUm seed fingerprint por conta. Um seed novo é um dispositivo novo e coerente
suas próprias funções de movimento do mousehumanize=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.

Atualizado em 20 de out. de 2026 · SDK 0.70.5 · navegador r63

Esta página foi útil?