Von Browserless migrieren
Browserless stellt Ihnen eine WebSocket-Adresse bereit, mit der sich Puppeteer oder Playwright verbinden, in der eigenen Cloud oder im Docker-Image. Clearcote bietet beides ebenfalls, also ändert sich nur die Adresse, mit der sich Ihr Code verbindet. Der Seiten-Code bleibt, wie er ist.
Von der Browserless-Cloud
Eine Browserless-Adresse ist fest. Eine Clearcote-Session wird zuerst erstellt, und ihre connectUrl gilt nur für eine Verbindung. Neu ist also nur ein Create-Aufruf vor jeder Verbindung. Das SDK erledigt beides in einem Aufruf.
import puppeteer from "puppeteer-core";
async function connectUrl(options = {}) {
const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
method: "POST",
headers: { authorization: "Bearer " + process.env.CLEARCOTE_API_KEY, "content-type": "application/json" },
body: JSON.stringify(options),
});
const { connectUrl, error } = await res.json();
if (error) throw new Error(error);
return connectUrl; // single-use: create one per connection
}
const browser = await puppeteer.connect({
browserWSEndpoint: "wss://production-sfo.browserless.io?token=" + process.env.BROWSERLESS_TOKEN,
browserWSEndpoint: await connectUrl({ identity: "acct-1", country: "us" }),
defaultViewport: null,
});
const page = await browser.newPage();
await page.goto("https://example.com");
await browser.close(); // ends the sessionDen Schlüssel erhalten Sie auf der Seite API keys; das SDK liest ihn aus CLEARCOTE_API_KEY. Der Browser startet beim Verbinden, meist innerhalb weniger Sekunden; mit einem country kann es bis etwa eine halbe Minute dauern. Geben Sie connectOverCDP von Playwright daher einen timeout von zwei Minuten. Behalten Sie defaultViewport: null bei, damit Puppeteer die Fenstergröße beibehält, die die Persona dem Browser gegeben hat.
Wohin die URL-Optionen wandern
Einstellungen, die Sie in die Browserless-URL schreiben, gehören in den JSON-Body des Create-Aufrufs. Für Chromium-Startflags gibt es im gehosteten Betrieb kein Gegenstück: Die Persona und ihre Switches werden für Sie gesetzt.
| Sie möchten | Create-Body |
|---|---|
| einen Residential-Exit in einem Land | "country": "de" (auch state, city); der verwaltete Pool ist der Standard |
| einen eigenen Proxy | "proxy": { "server": "http://host:8080", "username": "…", "password": "…" } |
| dieselbe IP und dasselbe Gerät für ein Konto | "identity": "acct-1" |
| Cookies, die zwischen Sessions erhalten bleiben | "profile": { "name": "acct-1", "persist": true } |
| ein Zeitlimit für die Session | "timeoutSec", "idleTimeoutSec" |
| eine Aufzeichnung | "record": true |
| später neu verbinden | "keepAlive": true |
Alle Optionen finden Sie unter Optionen & Identitäten. Stealth ist keine eigene Route: Jeder gehostete Browser läuft mit der Persona auf Engine-Ebene, und Checkboxen, Slider und Press-and-Hold-Prüfungen werden standardmäßig behandelt (Challenges). Endpunkte wie /content, /screenshot oder /pdf gibt es nicht: Schreiben Sie diese als ein paar Zeilen Playwright, oder beschreiben Sie die Aufgabe und starten Sie einen Agent-Run, der JSON zurückgibt.
Vom Browserless-Docker-Image
clearcote serve kommt dem Open-Source-Image am nächsten: ein dauerhafter Endpunkt, ein eigener Browser pro Identität, die Einstellungen in der Verbindungs-URL.
docker run -p 3000:3000 -e TOKEN=... ghcr.io/browserless/chromium
pip install -U clearcote # or: npm install -g clearcote
clearcote serve --port 9222 --idle-timeout 300 --max-browsers 16p.chromium.connect_over_cdp("http://127.0.0.1:9222") # one shared browser
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-1&platform=windows") # a browser of its own
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-2&proxy=http://user:pass@host:8080&geoip=true")Für eine Identität pro Container stellt das Image teamflatearth/clearcote CDP auf Port 9222 bereit; siehe Deployment & Docker. In beiden Fällen gilt: Machen Sie den Port nur in vertrauenswürdigen Netzwerken erreichbar, denn ein CDP-Port bedeutet volle Kontrolle über den Browser. Mehrere Browser gleichzeitig und Proxys mit Passwort brauchen einen Lizenzschlüssel: kostenlos mit GitHub-Anmeldung für einen Browser zur selben Zeit, mit Pro für bis zu 250.
Was es kostet
Gehostete Browser werden pro GB Traffic aus einem Prepaid-Guthaben bezahlt, ohne Tarif, den Sie wählen müssten. Siehe Preise & Traffic und zur Parallelität Limits & Fehler.