Pular para o conteúdo

Migrar do puppeteer-extra-plugin-stealth

Mantenha o Puppeteer e remova o plugin. O Clearcote inicia o navegador com o fingerprint já definido no motor, e o Puppeteer se conecta a ele. O código das suas páginas continua igual.

A mudança

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

Instale com npm install clearcote puppeteer-core. serve() baixa um build verificado no primeiro uso e o inicia com um endpoint CDP em loopback. Mantenha defaultViewport: null: sem isso, o Puppeteer redimensiona cada página para 800×600, o que deixa de bater com a janela que a persona deu ao navegador.

Todo o resto

Com o pluginCom o Clearcote
page.emulateTimezone(), --langgeoip: true com um proxy, ou timezone e acceptLanguage
page.setViewport()Remova
snippets de evasão com evaluateOnNewDocumentRemova. Patches de navigator ou WebGL feitos por script são exatamente o que as páginas procuram
userDataDiruserDataDir em serve() (padrão: um perfil temporário, removido ao fechar)
outros plugins do puppeteer-extra, como um bloqueador de anúnciosMantenha: o puppeteer-extra envolve connect() do mesmo jeito que envolve launch(). Só o plugin stealth sai

Ou migre para o Playwright

O launch() do SDK retorna diretamente um Browser do Playwright e adiciona mouse, teclado e rolagem humanizados (humanize: true), algo que um cliente conectado via CDP não tem. page.goto, page.evaluate e page.screenshot continuam iguais; page.$(sel) vira page.locator(sel), e o Playwright espera os elementos por conta própria.

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

Confira a mudança

npx clearcote info mostra o build que o SDK resolve e um teste de inicialização. Sem chave de licença, esse é o build aberto (BSD-3, sem conta); um proxy com usuário e senha precisa do build mais recente, grátis com login pelo GitHub (npx clearcote login). Depois, abra a auditoria na configuração antiga e na nova. Comparação: Clearcote vs puppeteer-extra-plugin-stealth.

Atualizado em 20 de out. de 2026 · SDK 0.70.5 · navegador r63

Esta página foi útil?