Migrar desde undetected-chromedriver
Clearcote se controla por CDP, no por WebDriver, así que el cambio es de Selenium a Playwright. Sin ChromeDriver no hay ningún driver que parchear ni que mantener al día con el navegador. Los mismos pasos sirven para selenium-stealth.
El cambio
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() descarga un build verificado de Clearcote la primera vez que lo usas, lo inicia y devuelve un Browser de Playwright.
De Selenium a Playwright, llamada por llamada
| Selenium | Playwright |
|---|---|
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") o loc.press_sequentially("x") |
el.text, el.get_attribute("href") | loc.inner_text(), loc.get_attribute("href") |
WebDriverWait(driver, 10).until(...) | Normalmente nada: las acciones esperan al elemento. Si no, loc.wait_for() |
driver.execute_script(js) | page.evaluate(js) |
driver.get_cookies(), add_cookie | page.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 pestaña es su propia page; context.pages las lista |
Opciones
| Antes | Con Clearcote |
|---|---|
stealth(driver, vendor=..., webgl_vendor=..., renderer=..., platform=...) | Quítalo. La persona aporta estos valores, y son coherentes con la GPU, las fuentes y el user agent |
| una extensión de proxy para autenticarse | proxy={"server", "username", "password"} en launch(); requiere el build más reciente (ver abajo) |
--user-agent, --lang, --window-size | Quítalos, o usa accept_language y timezone; geoip=True fija ambos a partir del proxy |
user_data_dir= | launch_persistent_context(user_data_dir, ...) |
version_main=, parcheo del driver | Nada que parchear: no hay ChromeDriver |
¿Una suite grande de Selenium?
Selenium y WebDriver no están soportados. ChromeDriver puede conectarse mediante debugger_address a un navegador iniciado con serve(), pero entonces el driver trae de vuelta la superficie de WebDriver que este cambio pretende eliminar (consulta Cómo funciona la detección). Úsalo solo mientras migras, y migra primero los flujos importantes.
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()Comprueba el cambio
clearcote info muestra el build que resuelve el SDK y una prueba de arranque. Sin clave de licencia, es el build abierto (BSD-3, sin cuenta); un proxy con usuario y contraseña requiere el build más reciente, gratis iniciando sesión con GitHub (clearcote login). Después abre la auditoría con la nueva configuración y compara. Comparativas: undetected-chromedriver y selenium-stealth.