Migrar para o Clearcote
O Clearcote é um Chromium de verdade que fala CDP, então o código existente costuma migrar trocando só as linhas que iniciam ou localizam o navegador. O código depois delas continua igual.
Do Playwright
launch() retorna o mesmo Browser do Playwright, então só a chamada de inicialização muda. Com playwright-stealth ou Patchright, o plugin também sai.
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 do playwright-stealth ou Patchright →
Do puppeteer-extra-plugin-stealth
Mantenha o Puppeteer e remova o plugin. serve() inicia o Clearcote com um endpoint CDP, e o Puppeteer se conecta a ele.
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 do puppeteer-extra-plugin-stealth →
Do undetected-chromedriver
Esta é a única migração que vai além de uma linha: o Clearcote é controlado via CDP, não via WebDriver, então o script passa para o Playwright. A maioria das chamadas do Selenium tem um equivalente de uma linha. O mesmo vale para o 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 do undetected-chromedriver →
Do Camoufox
Os dois entregam um objeto do Playwright vindo de um motor com patches, então Camoufox(...) vira launch(...), quase sempre com os mesmos nomes de opções, só que no 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()De um app de navegador antidetect
Multilogin, GoLogin, AdsPower, Dolphin Anty, Kameleo: um perfil vira um seed para o dispositivo e uma pasta para os cookies. Não há app de desktop para manter aberto nem API local para chamar antes.
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 de um app de navegador antidetect →
Do Fortress (versões BSD)
O seu cliente continua se conectando a um endpoint CDP; só muda o que inicia o endpoint. No Docker, troque a imagem por teamflatearth/clearcote e mantenha a porta.
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)Do Browserless
O seu código continua se conectando a um endereço WebSocket. Uma sessão do Clearcote fornece um por conexão, ou o SDK cria a sessão e se conecta em uma única chamada.
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();Do Browserbase
Mesmo formato: crie uma sessão e conecte-se ao endereço dela. sessions.create() vira POST /api/v1/browsers, ou launch(cloud=True) faz as duas coisas.
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()O que apagar pelo caminho
O Clearcote define o fingerprint dentro do motor, a partir de um único seed fingerprint. Tudo o que a sua configuração antiga alterava de fora agora trabalha contra ela:
- plugins stealth e scripts de evasão (patches de
navigatorviaevaluateOnNewDocumentouadd_init_script); - user agent, viewport, plataforma, vendor de WebGL ou string de GPU definidos à mão;
- ajustes de fuso horário e idioma quando você usa um proxy: passe
geoip=Truee eles seguem o IP de saída.
Dê a cada conta o seu próprio seed e mantenha-o: o mesmo seed é o mesmo dispositivo todas as vezes. Sem chave de licença, o SDK roda o build aberto (BSD-3, sem conta); uma chave gratuita obtida com login pelo GitHub dá acesso ao build mais recente. Veja Configurações recomendadas e Instalação.