Wechsel zu Clearcote
Clearcote ist ein echtes Chromium, das CDP spricht. Bestehender Code zieht deshalb meist um, indem Sie nur die Zeilen ändern, die den Browser starten oder finden. Der Code danach bleibt gleich.
Von Playwright
launch() gibt denselben Playwright-Browser zurück, es ändert sich also nur der Launch-Aufruf. Bei playwright-stealth oder Patchright fällt zusätzlich das Plugin weg.
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()Migration von playwright-stealth oder Patchright →
Von puppeteer-extra-plugin-stealth
Behalten Sie Puppeteer und entfernen Sie das Plugin. serve() startet Clearcote mit einem CDP-Endpunkt, und Puppeteer verbindet sich damit.
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();Migration von puppeteer-extra-plugin-stealth →
Von undetected-chromedriver
Das ist der einzige Wechsel, der mehr als eine Zeile umfasst: Clearcote wird über CDP gesteuert, nicht über WebDriver, also zieht das Skript zu Playwright um. Für die meisten Selenium-Aufrufe gibt es ein einzeiliges Gegenstück. Dasselbe gilt für 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")Migration von undetected-chromedriver →
Von Camoufox
Beide liefern Ihnen ein Playwright-Objekt aus einer gepatchten Engine, also wird aus Camoufox(...) launch(...), meist mit denselben Optionsnamen, nur auf 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()Von einer Anti-Detect-Browser-App
Multilogin, GoLogin, AdsPower, Dolphin Anty, Kameleo: Aus einem Profil werden ein Seed für das Gerät und ein Ordner für die Cookies. Es gibt keine Desktop-App, die weiterlaufen muss, und keine lokale API, die Sie zuerst aufrufen müssen.
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()Migration von einer Anti-Detect-Browser-App →
Von Fortress (BSD-Releases)
Ihr Client verbindet sich weiterhin mit einem CDP-Endpunkt; es ändert sich nur, was den Endpunkt startet. In Docker tauschen Sie das Image gegen teamflatearth/clearcote und behalten den Port.
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)Von Browserless
Ihr Code verbindet sich weiterhin mit einer WebSocket-Adresse. Eine Clearcote-Session liefert Ihnen eine pro Verbindung, oder das SDK erstellt die Session und verbindet sich in einem einzigen Aufruf.
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();Von Browserbase
Dasselbe Muster: Session erstellen, mit ihrer Adresse verbinden. Aus sessions.create() wird POST /api/v1/browsers, oder launch(cloud=True) erledigt beides.
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()Was Sie dabei entfernen können
Clearcote setzt den Fingerprint in der Engine, aus einem einzigen fingerprint-Seed. Alles, was Ihr altes Setup von außen verändert hat, arbeitet jetzt dagegen:
- Stealth-Plugins und Evasion-Skripte (Patches von
navigatorperevaluateOnNewDocumentoderadd_init_script); - von Hand gesetzte User-Agents, Viewports, Plattformen, WebGL-Vendor- oder GPU-Strings;
- Overrides für Zeitzone und Sprache, wenn Sie einen Proxy nutzen: Übergeben Sie
geoip=True, dann folgen beide der Exit-IP.
Geben Sie jedem Account einen eigenen Seed und behalten Sie ihn: Derselbe Seed ist jedes Mal dasselbe Gerät. Ohne Lizenzschlüssel startet das SDK den offenen Build (BSD-3, kein Konto); ein kostenloser Schlüssel per GitHub-Anmeldung bekommt den neuesten Build. Siehe Empfohlene Einstellungen und Installation.