Chuyển từ Browserless
Browserless cung cấp cho bạn một địa chỉ WebSocket để kết nối Puppeteer hoặc Playwright, trên cloud của họ hoặc trong Docker image của họ. Clearcote cũng làm được cả hai, nên thứ thay đổi chỉ là địa chỉ mà code của bạn kết nối tới. Code thao tác trang giữ nguyên.
Từ Browserless cloud
Địa chỉ Browserless là cố định. Một phiên Clearcote được tạo trước, và connectUrl của nó chỉ dùng được một lần, nên bước mới duy nhất là một lệnh gọi tạo phiên trước mỗi lần kết nối. SDK làm cả hai việc trong một lệnh gọi.
import puppeteer from "puppeteer-core";
async function connectUrl(options = {}) {
const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
method: "POST",
headers: { authorization: "Bearer " + process.env.CLEARCOTE_API_KEY, "content-type": "application/json" },
body: JSON.stringify(options),
});
const { connectUrl, error } = await res.json();
if (error) throw new Error(error);
return connectUrl; // single-use: create one per connection
}
const browser = await puppeteer.connect({
browserWSEndpoint: "wss://production-sfo.browserless.io?token=" + process.env.BROWSERLESS_TOKEN,
browserWSEndpoint: await connectUrl({ identity: "acct-1", country: "us" }),
defaultViewport: null,
});
const page = await browser.newPage();
await page.goto("https://example.com");
await browser.close(); // ends the sessionLấy key trên trang “API keys”; SDK đọc key từ CLEARCOTE_API_KEY. Trình duyệt khởi động khi bạn kết nối, thường trong vài giây; khi có country, việc này có thể mất tới khoảng nửa phút, vì vậy hãy cho connectOverCDP của Playwright một timeout hai phút. Giữ defaultViewport: null để Puppeteer giữ nguyên kích thước cửa sổ mà persona đã đặt cho trình duyệt.
Các tùy chọn trong URL đi đâu
Các thiết lập bạn đặt trong URL Browserless sẽ chuyển vào body JSON của lệnh gọi tạo phiên. Các flag khởi chạy Chromium không có tương đương ở bản hosted: persona và các switch của nó đã được thiết lập sẵn cho bạn.
| Bạn muốn | Body khi tạo phiên |
|---|---|
| một exit IP dân cư ở một quốc gia | "country": "de" (cả state, city); mặc định là pool được quản lý |
| proxy của riêng bạn | "proxy": { "server": "http://host:8080", "username": "…", "password": "…" } |
| cùng IP và thiết bị cho một tài khoản | "identity": "acct-1" |
| giữ cookie giữa các phiên | "profile": { "name": "acct-1", "persist": true } |
| giới hạn thời gian phiên | "timeoutSec", "idleTimeoutSec" |
| bản ghi hình | "record": true |
| kết nối lại sau | "keepAlive": true |
Mọi tùy chọn nằm trong Tùy chọn & danh tính. Stealth không phải là một route riêng: mọi trình duyệt được lưu trữ sẵn (hosted) đều chạy persona ở cấp engine, còn checkbox, slider và các bước xác minh nhấn giữ được xử lý mặc định (Thử thách). Không có endpoint /content, /screenshot hay /pdf: hãy viết chúng bằng vài dòng Playwright, hoặc mô tả tác vụ và bắt đầu một lượt chạy agent, kết quả trả về là JSON.
Từ Docker image của Browserless
clearcote serve là lựa chọn gần nhất với image mã nguồn mở: một endpoint chạy thường trực, một trình duyệt riêng cho mỗi danh tính, thiết lập nằm trong URL kết nối.
docker run -p 3000:3000 -e TOKEN=... ghcr.io/browserless/chromium
pip install -U clearcote # or: npm install -g clearcote
clearcote serve --port 9222 --idle-timeout 300 --max-browsers 16p.chromium.connect_over_cdp("http://127.0.0.1:9222") # one shared browser
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-1&platform=windows") # a browser of its own
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-2&proxy=http://user:pass@host:8080&geoip=true")Nếu mỗi container dùng một danh tính, image teamflatearth/clearcote cung cấp CDP trên cổng 9222; xem Triển khai & Docker. Dù theo cách nào, chỉ mở cổng trên mạng bạn tin tưởng: có cổng CDP là có toàn quyền điều khiển trình duyệt. Chạy nhiều trình duyệt cùng lúc và dùng proxy có mật khẩu cần khóa giấy phép: miễn phí khi đăng nhập bằng GitHub cho một trình duyệt mỗi lúc, và Pro cho tối đa 250.
Chi phí
Trình duyệt hosted được tính phí theo GB lưu lượng từ số dư trả trước, không cần chọn gói. Xem Bảng giá & lưu lượng, và Giới hạn & lỗi về số phiên đồng thời.