Migrer depuis puppeteer-extra-plugin-stealth
Gardez Puppeteer, retirez le plugin. Clearcote démarre le navigateur avec l’empreinte déjà définie dans le moteur, et Puppeteer s’y connecte. Le code de vos pages reste identique.
Le changement
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 profileInstallez avec npm install clearcote puppeteer-core. serve() télécharge un build vérifié à la première utilisation et le démarre avec un endpoint CDP sur loopback. Gardez defaultViewport: null : sans cette option, Puppeteer redimensionne chaque page en 800×600, ce qui ne correspond plus à la fenêtre que la persona a donnée au navigateur.
Tout le reste
| Avec le plugin | Avec Clearcote |
|---|---|
page.emulateTimezone(), --lang | geoip: true avec un proxy, ou timezone et acceptLanguage |
page.setViewport() | À supprimer |
snippets d’évasion via evaluateOnNewDocument | À supprimer. Les patchs de navigator ou de WebGL appliqués par un script sont précisément ce que les pages recherchent |
userDataDir | userDataDir sur serve() (par défaut : un profil temporaire, supprimé à la fermeture) |
les autres plugins puppeteer-extra, comme un bloqueur de publicités | À conserver : puppeteer-extra enveloppe connect() comme il enveloppe launch(). Seul le plugin stealth disparaît |
Ou passer à Playwright
Le launch() du SDK renvoie directement un Browser Playwright et ajoute souris, clavier et défilement humanisés (humanize: true), dont un client connecté via CDP ne bénéficie pas. page.goto, page.evaluate et page.screenshot restent identiques ; page.$(sel) devient page.locator(sel), et Playwright attend les éléments de lui-même.
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();Vérifier le changement
npx clearcote info affiche le build que le SDK résout et un test de lancement. Sans clé de licence, c’est le build ouvert (BSD-3, sans compte) ; un proxy avec nom d’utilisateur et mot de passe nécessite le dernier build, gratuit avec une connexion GitHub (npx clearcote login). Ouvrez ensuite l’audit avec l’ancienne configuration et avec la nouvelle. Comparatif : Clearcote vs puppeteer-extra-plugin-stealth.