Saltar al contenido

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 profile

Instala 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 pluginCon Clearcote
page.emulateTimezone(), --langgeoip: true con un proxy, o timezone y acceptLanguage
page.setViewport()Elimínalo
snippets de evasión con evaluateOnNewDocumentElimínalos. Los parches de navigator o WebGL hechos desde un script son justo lo que buscan las páginas
userDataDiruserDataDir en serve() (por defecto: un perfil temporal que se elimina al cerrar)
otros plugins de puppeteer-extra, como un bloqueador de anunciosConsé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.

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();

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.

Actualizado el 20 oct 2026 · SDK 0.70.5 · navegador r63

¿Te resultó útil esta página?