Migration von puppeteer-extra-plugin-stealth
Behalten Sie Puppeteer, entfernen Sie das Plugin. Clearcote startet den Browser mit einem Fingerprint, der bereits in der Engine gesetzt ist, und Puppeteer verbindet sich damit. Ihr Seiten-Code bleibt gleich.
Die Änderung
import puppeteer from "puppeteer-extra";
import StealthPlugin from "puppeteer-extra-plugin-stealth";
import puppeteer from "puppeteer-core";
import { serve } from "clearcote";
puppeteer.use(StealthPlugin());
const browser = await puppeteer.launch({ args: ["--proxy-server=http://proxy.example:8080"] });
const srv = await serve({
fingerprint: "acct-1", // one seed per account: the same device every run
proxy: { server: "http://proxy.example:8080", username: "user", password: "pass" },
geoip: true, // timezone, language and WebRTC follow the exit IP
});
const browser = await puppeteer.connect({ browserURL: srv.cdpUrl, defaultViewport: null });
const page = await browser.newPage();
await page.authenticate({ username: "user", password: "pass" });
await page.setUserAgent("Mozilla/5.0 ...");
await page.goto("https://example.com");
await browser.close();
await browser.disconnect();
await srv.close(); // stops the browser and removes its temporary profileInstallieren Sie mit npm install clearcote puppeteer-core. serve() lädt beim ersten Aufruf einen verifizierten Build herunter und startet ihn mit einem CDP-Endpunkt auf Loopback. Behalten Sie defaultViewport: null bei: Ohne diese Einstellung skaliert Puppeteer jede Seite auf 800×600, was nicht mehr zu dem Fenster passt, das die Persona dem Browser gegeben hat.
Alles Weitere
| Mit dem Plugin | Mit Clearcote |
|---|---|
page.emulateTimezone(), --lang | geoip: true mit einem Proxy, oder timezone und acceptLanguage |
page.setViewport() | Entfernen |
Evasion-Snippets per evaluateOnNewDocument | Entfernen. Patches von navigator oder WebGL per Skript sind genau das, wonach Seiten suchen |
userDataDir | userDataDir bei serve() (Standard: ein temporäres Profil, das beim Schließen entfernt wird) |
andere puppeteer-extra-Plugins, etwa ein Werbeblocker | Behalten: puppeteer-extra umhüllt connect() genauso wie launch(). Nur das Stealth-Plugin fällt weg |
Oder zu Playwright wechseln
launch() aus dem SDK gibt direkt einen Playwright-Browser zurück und ergänzt menschenähnliche Maus-, Tastatur- und Scroll-Eingaben (humanize: true), die ein über CDP verbundener Client nicht bekommt. page.goto, page.evaluate und page.screenshot bleiben gleich; aus page.$(sel) wird page.locator(sel), und Playwright wartet von selbst auf Elemente.
import { launch } from "clearcote";
const browser = await launch({ fingerprint: "acct-1", humanize: true });
const page = await browser.newPage();
await page.goto("https://example.com");
await page.locator("text=More information").click(); // moves and clicks like a person
await browser.close();Den Wechsel prüfen
npx clearcote info zeigt den Build, den das SDK auflöst, und einen Starttest. Ohne Lizenzschlüssel ist das der offene Build (BSD-3, kein Konto); ein Proxy mit Benutzername und Passwort braucht den neuesten Build, kostenlos per GitHub-Anmeldung (npx clearcote login). Öffnen Sie dann das Audit im alten und im neuen Setup. Vergleich: Clearcote vs puppeteer-extra-plugin-stealth.