Chuyển đến nội dung

Chuyển sang Clearcote

Clearcote là một Chromium thật, giao tiếp qua CDP, nên code hiện có thường chuyển sang được chỉ bằng cách sửa những dòng khởi động hoặc tìm trình duyệt. Phần code sau đó giữ nguyên.

Từ Playwright

launch() trả về đúng đối tượng Browser của Playwright, nên chỉ lệnh gọi khởi chạy thay đổi. Nếu dùng playwright-stealth hoặc Patchright, bạn bỏ luôn plugin.

from playwright.sync_api import sync_playwright
browser = sync_playwright().start().chromium.launch()
from clearcote import launch
browser = launch(fingerprint="acct-1")
page = browser.new_page()

Chuyển từ playwright-stealth hoặc Patchright →

Từ puppeteer-extra-plugin-stealth

Giữ Puppeteer và bỏ plugin. serve() khởi động Clearcote với một CDP endpoint, và Puppeteer kết nối tới đó.

import puppeteer from "puppeteer-extra";
import StealthPlugin from "puppeteer-extra-plugin-stealth";
puppeteer.use(StealthPlugin());
const browser = await puppeteer.launch();
import puppeteer from "puppeteer-core";
import { serve } from "clearcote";
const srv = await serve({ fingerprint: "acct-1" });
const browser = await puppeteer.connect({ browserURL: srv.cdpUrl, defaultViewport: null });
const page = await browser.newPage();

Chuyển từ puppeteer-extra-plugin-stealth →

Từ undetected-chromedriver

Đây là lần chuyển duy nhất cần sửa nhiều hơn một dòng: Clearcote được điều khiển qua CDP chứ không qua WebDriver, nên script chuyển sang Playwright. Hầu hết lệnh gọi Selenium đều có cách viết tương ứng chỉ trong một dòng. selenium-stealth cũng vậy.

import undetected_chromedriver as uc
driver = uc.Chrome(headless=True)
driver.get("https://example.com")
from clearcote import launch
browser = launch(fingerprint="acct-1")
page = browser.new_page()
page.goto("https://example.com")

Chuyển từ undetected-chromedriver →

Từ Camoufox

Cả hai đều trao cho bạn một đối tượng Playwright từ một engine đã được vá, nên Camoufox(...) trở thành launch(...), phần lớn với cùng tên tùy chọn, chỉ là chạy trên Chromium.

from camoufox.sync_api import Camoufox
with Camoufox(os="windows", humanize=True) as browser:
    page = browser.new_page()
from clearcote import launch
browser = launch(platform="windows", humanize=True, fingerprint="acct-1")
page = browser.new_page()

Chuyển từ Camoufox →

Từ ứng dụng trình duyệt antidetect

Multilogin, GoLogin, AdsPower, Dolphin Anty, Kameleo: mỗi profile trở thành một seed cho thiết bị và một thư mục cho cookie. Không còn ứng dụng desktop phải để chạy, cũng không còn API cục bộ phải gọi trước.

ws = start_profile("k1abc23")          # the app's local API hands out a CDP address
browser = sync_playwright().start().chromium.connect_over_cdp(ws)
page = browser.contexts[0].new_page()
from clearcote import launch_persistent_context
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1")
page = context.new_page()

Chuyển từ ứng dụng trình duyệt antidetect →

Từ Fortress (bản phát hành BSD)

Client của bạn vẫn kết nối tới một CDP endpoint; chỉ phần khởi động endpoint thay đổi. Trong Docker, đổi image sang teamflatearth/clearcote và giữ nguyên cổng.

with Fortress() as f:
    browser = p.chromium.connect_over_cdp(f.cdp_url)
with serve(fingerprint="acct-1", port=9222) as srv:
    browser = p.chromium.connect_over_cdp(srv.cdp_url)

Chuyển từ Fortress →

Từ Browserless

Code của bạn vẫn kết nối tới một địa chỉ WebSocket. Phiên Clearcote cấp cho bạn một địa chỉ cho mỗi kết nối, hoặc SDK tạo phiên và kết nối chỉ trong một lệnh gọi.

import { chromium } from "playwright-core";
const browser = await chromium.connectOverCDP("wss://production-sfo.browserless.io?token=" + TOKEN);
import { launch } from "clearcote";
const browser = await launch({ cloud: true, identity: "acct-1", country: "us" });
const page = await browser.contexts()[0].newPage();

Chuyển từ Browserless →

Từ Browserbase

Cùng một cách làm: tạo phiên, rồi kết nối tới địa chỉ của nó. sessions.create() trở thành POST /api/v1/browsers, hoặc launch(cloud=True) làm cả hai việc.

session = Browserbase(api_key=BROWSERBASE_API_KEY).sessions.create()
browser = sync_playwright().start().chromium.connect_over_cdp(session.connect_url)
from clearcote import launch
browser = launch(cloud=True, identity="acct-1", country="us")
page = browser.contexts[0].new_page()

Chuyển từ Browserbase →

Những gì nên xóa khi chuyển

Clearcote đặt dấu vân tay trình duyệt ngay bên trong engine, từ một seed fingerprint duy nhất. Mọi thứ mà thiết lập cũ của bạn thay đổi từ bên ngoài giờ sẽ phản tác dụng:

  • stealth plugin và script evasion (các bản vá navigator bằng evaluateOnNewDocument, add_init_script);
  • user agent, viewport, nền tảng, WebGL vendor hoặc chuỗi GPU đặt thủ công;
  • ghi đè múi giờ và ngôn ngữ khi dùng proxy: truyền geoip=True và chúng sẽ theo IP đầu ra.

Hãy cấp cho mỗi tài khoản một seed riêng và giữ nguyên nó: cùng một seed là cùng một thiết bị mọi lúc. Không có khóa giấy phép, SDK chạy bản build mở (BSD-3, không cần tài khoản); khóa miễn phí nhận được khi đăng nhập bằng GitHub sẽ dùng bản build mới nhất. Xem Cấu hình khuyến nghị và Cài đặt.

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

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