Aller au contenu

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 profile

Installez 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 pluginAvec Clearcote
page.emulateTimezone(), --langgeoip: 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
userDataDiruserDataDir 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.

javascript
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.

Mis à jour le 20 oct. 2026 · SDK 0.70.5 · navigateur r63

Cette page vous a-t-elle été utile ?