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 profilenpm install clearcote puppeteer-core でインストールします。serve() は初回利用時に検証済みのビルドをダウンロードし、ループバック上の CDP エンドポイント付きで起動します。defaultViewport: null は残してください。これがないと Puppeteer はすべてのページを 800×600 にリサイズし、ペルソナがブラウザに与えたウィンドウと合わなくなります。
その他の対応
| プラグイン使用時 | Clearcote の場合 |
|---|---|
page.emulateTimezone(), --lang | プロキシと併せて geoip: true、または timezone と acceptLanguage |
page.setViewport() | 削除します |
evaluateOnNewDocument による evasion スニペット | 削除します。スクリプトによる navigator や WebGL のパッチこそ、ページが探しているものです |
userDataDir | serve() の userDataDir(デフォルトは一時プロファイルで、終了時に削除されます) |
広告ブロッカーなど、ほかの puppeteer-extra プラグイン | 残してかまいません。puppeteer-extra は launch() と同じように connect() もラップします。外すのは stealth プラグインだけです |
Playwright に移行する方法
SDK の launch() は Playwright の Browser を直接返し、さらに人間らしいマウス操作、キー入力、スクロール(humanize: true)を加えます。これは CDP で接続したクライアントでは使えません。page.goto、page.evaluate、page.screenshot はそのまま使えます。page.$(sel) は page.locator(sel) になり、要素の待機は Playwright が自動で行います。
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。