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 profileCà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 plugin | Với Clearcote |
|---|---|
page.emulateTimezone(), --lang | geoip: true kèm proxy, hoặc timezone và acceptLanguage |
page.setViewport() | Xóa đi |
đoạn mã evasion qua evaluateOnNewDocument | Xóa đi. Các bản vá navigator hay WebGL từ script chính là thứ các trang tìm kiếm |
userDataDir | userDataDir 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áo | Giữ 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ử.
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.