Chuyển đến nội dung

Chuyển từ puppeteer-extra-plugin-stealth sang Clearcote

Giữ Puppeteer, bỏ plugin. Clearcote khởi động trình duyệt với dấu vân tay đã được đặt sẵn trong engine, và Puppeteer kết nối tới đó. Code thao tác trang của bạn giữ nguyên.

Thay đổi

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

Cài đặt bằng npm install clearcote puppeteer-core. serve() tải về một bản build đã xác minh trong lần dùng đầu tiên và khởi động nó với một CDP endpoint trên loopback. Hãy giữ defaultViewport: null: nếu thiếu, Puppeteer sẽ đổi kích thước mọi trang về 800×600, không còn khớp với cửa sổ mà persona đã cấp cho trình duyệt.

Những thứ còn lại

Với pluginVới Clearcote
page.emulateTimezone(), --langgeoip: true kèm proxy, hoặc timezone và acceptLanguage
page.setViewport()Xóa đi
đoạn mã evasion qua evaluateOnNewDocumentXóa đi. Các bản vá navigator hay WebGL từ script chính là thứ các trang tìm kiếm
userDataDiruserDataDir trên serve() (mặc định: một profile tạm, bị xóa khi đóng)
các plugin puppeteer-extra khác, chẳng hạn trình chặn quảng cáoGiữ lại: puppeteer-extra bọc connect() giống như bọc launch(). Chỉ bỏ plugin stealth

Hoặc chuyển sang Playwright

launch() của SDK trả về trực tiếp một Browser của Playwright, đồng thời thêm thao tác chuột, bàn phím và cuộn giống người (humanize: true), thứ mà client kết nối qua CDP không có. page.goto, page.evaluate và page.screenshot giữ nguyên; page.$(sel) trở thành page.locator(sel), và Playwright tự chờ các phần tử.

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

Kiểm tra sau khi chuyển

npx clearcote info in ra bản build mà SDK xác định và một bài kiểm tra khởi chạy. Không có khóa giấy phép thì đó là bản build mở (BSD-3, không cần tài khoản); proxy có tên người dùng và mật khẩu cần bản build mới nhất, miễn phí khi đăng nhập bằng GitHub (npx clearcote login). Sau đó mở audit trên cả thiết lập cũ lẫn mới. So sánh: Clearcote vs puppeteer-extra-plugin-stealth.

Cập nhật 20 thg 10, 2026 · SDK 0.70.5 · trình duyệt r63

Trang này có hữu ích không?