Migrar desde puppeteer-extra-plugin-stealth
Conserva Puppeteer y quita el plugin. Clearcote inicia el navegador con la huella digital ya definida en el motor, y Puppeteer se conecta a él. El código de tus páginas sigue igual.
El cambio
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 profileInstala con npm install clearcote puppeteer-core. serve() descarga un build verificado la primera vez que se usa y lo inicia con un endpoint CDP en loopback. Mantén defaultViewport: null: sin él, Puppeteer redimensiona cada página a 800×600, lo que ya no coincide con la ventana que la persona le dio al navegador.
Todo lo demás
| Con el plugin | Con Clearcote |
|---|---|
page.emulateTimezone(), --lang | geoip: true con un proxy, o timezone y acceptLanguage |
page.setViewport() | Elimínalo |
snippets de evasión con evaluateOnNewDocument | Elimínalos. Los parches de navigator o WebGL hechos desde un script son justo lo que buscan las páginas |
userDataDir | userDataDir en serve() (por defecto: un perfil temporal que se elimina al cerrar) |
otros plugins de puppeteer-extra, como un bloqueador de anuncios | Consérvalos: puppeteer-extra envuelve connect() igual que envuelve launch(). Solo se va el plugin stealth |
O pasa a Playwright
El launch() del SDK devuelve directamente un Browser de Playwright y añade mouse, teclado y scroll humanizados (humanize: true), algo que un cliente conectado por CDP no obtiene. page.goto, page.evaluate y page.screenshot siguen igual; page.$(sel) pasa a ser page.locator(sel), y Playwright espera a los elementos por sí solo.
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();Comprueba el cambio
npx clearcote info muestra el build que resuelve el SDK y una prueba de lanzamiento. Sin clave de licencia, ese es el build abierto (BSD-3, sin cuenta); un proxy con usuario y contraseña necesita el build más reciente, gratis al iniciar sesión con GitHub (npx clearcote login). Después abre la auditoría con la configuración anterior y con la nueva. Comparación: Clearcote vs puppeteer-extra-plugin-stealth.