Saltar al contenido

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()

Migrar desde Camoufox →

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)

Migrar desde Fortress →

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();

Migrar desde Browserless →

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()

Migrar desde Browserbase →

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 navigator con evaluateOnNewDocument o add_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=True y 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.

Actualizado el 16 oct 2026 · SDK 0.70.5 · navegador r63

¿Te resultó útil esta página?