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 profileInstale 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 plugin | Com o Clearcote |
|---|---|
page.emulateTimezone(), --lang | geoip: true com um proxy, ou timezone e acceptLanguage |
page.setViewport() | Remova |
snippets de evasão com evaluateOnNewDocument | Remova. Patches de navigator ou WebGL feitos por script são exatamente o que as páginas procuram |
userDataDir | userDataDir em serve() (padrão: um perfil temporário, removido ao fechar) |
outros plugins do puppeteer-extra, como um bloqueador de anúncios | Mantenha: 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.
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.