从 puppeteer-extra-plugin-stealth 迁移
保留 Puppeteer,去掉插件。Clearcote 启动浏览器时,指纹已在引擎中设置好,Puppeteer 直接连接上去。你的页面代码保持不变。
改动
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用 npm install clearcote puppeteer-core 安装。serve() 首次使用时会下载经过校验的构建,并在本机回环地址上带 CDP 端点启动它。请保留 defaultViewport: null:没有它,Puppeteer 会把每个页面调整为 800×600,与身份画像 (persona) 给浏览器设定的窗口不再一致。
其他改动
| 使用插件时 | 使用 Clearcote |
|---|---|
page.emulateTimezone(), --lang | 配合代理使用 geoip: true,或者 timezone 和 acceptLanguage |
page.setViewport() | 删除 |
evaluateOnNewDocument 规避代码片段 | 删除。用脚本修改 navigator 或 WebGL,恰恰是页面要找的痕迹 |
userDataDir | serve() 的 userDataDir(默认是临时配置文件,关闭时删除) |
其他 puppeteer-extra 插件,例如广告拦截器 | 保留:puppeteer-extra 包装 connect() 的方式与包装 launch() 相同。只去掉 stealth 插件 |
或者改用 Playwright
SDK 的 launch() 直接返回 Playwright Browser,并提供拟人化的鼠标、键盘和滚动(humanize: true),而通过 CDP 连接的客户端没有这项功能。page.goto、page.evaluate 和 page.screenshot 保持不变;page.$(sel) 改为 page.locator(sel),Playwright 会自动等待元素。
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();检查切换结果
npx clearcote info 会输出 SDK 解析到的构建以及启动测试结果。没有许可证密钥时就是开源版构建(BSD-3,无需账号);带用户名和密码的代理需要最新构建,通过 GitHub 登录即可免费获得(npx clearcote login)。然后分别在旧环境和新环境中打开 audit 页面。对比:Clearcote vs puppeteer-extra-plugin-stealth。