Zum Inhalt springen

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 session

Den 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öchtenCreate-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 16
python
p.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.

Aktualisiert am 16. Okt. 2026 · SDK 0.70.5 · Browser r63

War diese Seite hilfreich?