Pular para o conteúdo

Migrando do undetected-chromedriver

O Clearcote é controlado via CDP, não via WebDriver, então a migração é do Selenium para o Playwright. Sem ChromeDriver, não há driver para aplicar patches nem para manter em sincronia com o navegador. Os mesmos passos valem para o selenium-stealth.

A mudança

import undetected_chromedriver as uc
from selenium.webdriver.common.by import By
from clearcote import launch

options = uc.ChromeOptions()
options.add_argument("--proxy-server=http://proxy.example:8080")
driver = uc.Chrome(options=options, headless=True)
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
    humanize=True,                           # human mouse paths, typing and scrolling
)
page = browser.new_page()
driver.get("https://example.com")
driver.find_element(By.CSS_SELECTOR, "a").click()
print(driver.title)
driver.quit()
page.goto("https://example.com")
page.locator("a").first.click()
print(page.title())
browser.close()

launch() baixa um build verificado do Clearcote no primeiro uso, inicia esse build e retorna um Browser do Playwright.

Do Selenium ao Playwright, chamada por chamada

SeleniumPlaywright
driver.get(url)page.goto(url)
driver.find_element(By.CSS_SELECTOR, s)page.locator(s)
driver.find_element(By.XPATH, x)page.locator("xpath=" + x)
el.click(), el.send_keys("x")loc.click(), loc.fill("x") ou loc.press_sequentially("x")
el.text, el.get_attribute("href")loc.inner_text(), loc.get_attribute("href")
WebDriverWait(driver, 10).until(...)Normalmente nada: as ações esperam pelo elemento. Caso contrário, loc.wait_for()
driver.execute_script(js)page.evaluate(js)
driver.get_cookies(), add_cookiepage.context.cookies(), add_cookies
driver.save_screenshot(path)page.screenshot(path=path)
driver.switch_to.frame(f)page.frame_locator(s)
driver.switch_to.window(h)Cada aba é sua própria page; context.pages lista todas

Opções

AntesCom o Clearcote
stealth(driver, vendor=..., webgl_vendor=..., renderer=..., platform=...)Remova. A persona fornece esses valores, e eles são coerentes com a GPU, as fontes e o user agent
uma extensão de proxy para autenticaçãoproxy={"server", "username", "password"} em launch(); exige o build mais recente (veja abaixo)
--user-agent, --lang, --window-sizeRemova, ou use accept_language e timezone; geoip=True define os dois a partir do proxy
user_data_dir=launch_persistent_context(user_data_dir, ...)
version_main=, patch do driverNão há o que corrigir: não existe ChromeDriver

Uma suíte grande de Selenium?

Selenium e WebDriver não são suportados. O ChromeDriver pode se conectar via debugger_address a um navegador iniciado com serve(), mas aí o driver traz de volta a superfície do WebDriver que esta migração pretende remover (veja Como a detecção funciona). Use isso só durante a migração e migre primeiro os fluxos importantes.

python
from urllib.parse import urlparse
from clearcote import serve
from selenium import webdriver

with serve(fingerprint="acct-1") as srv:          # unsupported: for the transition only
    options = webdriver.ChromeOptions()
    options.debugger_address = urlparse(srv.cdp_url).netloc
    driver = webdriver.Chrome(options=options)
    driver.get("https://example.com")
    driver.quit()

Confira a migração

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 exige o build mais recente, grátis com login do GitHub (clearcote login). Depois abra a auditoria na nova configuração e compare. Comparações: undetected-chromedriver e selenium-stealth.

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

Esta página foi útil?