Cambiar a Clearcote
Clearcote es un Chromium real que habla CDP, así que el código existente suele migrarse cambiando solo las líneas que inician o localizan el navegador. El código que viene después sigue igual.
Desde Playwright
launch() devuelve el mismo Browser de Playwright, así que solo cambia la llamada de lanzamiento. Con playwright-stealth o Patchright, también sobra el plugin.
from playwright.sync_api import sync_playwright
browser = sync_playwright().start().chromium.launch()
from clearcote import launch
browser = launch(fingerprint="acct-1")
page = browser.new_page()Migrar desde playwright-stealth o Patchright →
Desde puppeteer-extra-plugin-stealth
Conserva Puppeteer y quita el plugin. serve() inicia Clearcote con un endpoint CDP, y Puppeteer se conecta a él.
import puppeteer from "puppeteer-extra";
import StealthPlugin from "puppeteer-extra-plugin-stealth";
puppeteer.use(StealthPlugin());
const browser = await puppeteer.launch();
import puppeteer from "puppeteer-core";
import { serve } from "clearcote";
const srv = await serve({ fingerprint: "acct-1" });
const browser = await puppeteer.connect({ browserURL: srv.cdpUrl, defaultViewport: null });
const page = await browser.newPage();Migrar desde puppeteer-extra-plugin-stealth →
Desde undetected-chromedriver
Es el único cambio que ocupa más de una línea: Clearcote se controla por CDP, no por WebDriver, así que el script pasa a Playwright. La mayoría de las llamadas de Selenium tienen un equivalente de una línea. Lo mismo vale para selenium-stealth.
import undetected_chromedriver as uc
driver = uc.Chrome(headless=True)
driver.get("https://example.com")
from clearcote import launch
browser = launch(fingerprint="acct-1")
page = browser.new_page()
page.goto("https://example.com")Migrar desde undetected-chromedriver →
Desde Camoufox
Ambos te entregan un objeto de Playwright desde un motor parcheado, así que Camoufox(...) pasa a ser launch(...), casi siempre con los mismos nombres de opciones, pero sobre Chromium.
from camoufox.sync_api import Camoufox
with Camoufox(os="windows", humanize=True) as browser:
page = browser.new_page()
from clearcote import launch
browser = launch(platform="windows", humanize=True, fingerprint="acct-1")
page = browser.new_page()Desde una app de navegador antidetect
Multilogin, GoLogin, AdsPower, Dolphin Anty, Kameleo: un perfil se convierte en un seed para el dispositivo y una carpeta para las cookies. No hay ninguna app de escritorio que mantener abierta ni ninguna API local a la que llamar primero.
ws = start_profile("k1abc23") # the app's local API hands out a CDP address
browser = sync_playwright().start().chromium.connect_over_cdp(ws)
page = browser.contexts[0].new_page()
from clearcote import launch_persistent_context
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1")
page = context.new_page()Migrar desde una app de navegador antidetect →
Desde Fortress (versiones BSD)
Tu cliente sigue conectándose a un endpoint CDP; solo cambia lo que inicia ese endpoint. En Docker, cambia la imagen por teamflatearth/clearcote y conserva el puerto.
with Fortress() as f:
browser = p.chromium.connect_over_cdp(f.cdp_url)
with serve(fingerprint="acct-1", port=9222) as srv:
browser = p.chromium.connect_over_cdp(srv.cdp_url)Desde Browserless
Tu código sigue conectándose a una dirección WebSocket. Una sesión de Clearcote te da una por conexión, o el SDK crea la sesión y se conecta en una sola llamada.
import { chromium } from "playwright-core";
const browser = await chromium.connectOverCDP("wss://production-sfo.browserless.io?token=" + TOKEN);
import { launch } from "clearcote";
const browser = await launch({ cloud: true, identity: "acct-1", country: "us" });
const page = await browser.contexts()[0].newPage();Desde Browserbase
La misma forma: crea una sesión y conéctate a su dirección. sessions.create() pasa a ser POST /api/v1/browsers, o launch(cloud=True) hace ambas cosas.
session = Browserbase(api_key=BROWSERBASE_API_KEY).sessions.create()
browser = sync_playwright().start().chromium.connect_over_cdp(session.connect_url)
from clearcote import launch
browser = launch(cloud=True, identity="acct-1", country="us")
page = browser.contexts[0].new_page()Qué eliminar por el camino
Clearcote define la huella digital dentro del motor, a partir de un único seed fingerprint. Todo lo que tu configuración anterior cambiaba desde fuera ahora juega en su contra:
- plugins stealth y scripts de evasión (parches de
navigatorconevaluateOnNewDocumentoadd_init_script); - un user agent, viewport, plataforma, vendor de WebGL o cadena de GPU fijados a mano;
- los cambios de zona horaria e idioma cuando usas un proxy: pasa
geoip=Truey seguirán a la IP de salida.
Dale a cada cuenta su propio seed y consérvalo: el mismo seed es el mismo dispositivo cada vez. Sin clave de licencia, el SDK ejecuta el build abierto (BSD-3, sin cuenta); una clave gratuita obtenida al iniciar sesión con GitHub da acceso al build más reciente. Consulta Ajustes recomendados e Instalación.