迁移到 Clearcote
Clearcote 是一个支持 CDP 的真正 Chromium,因此现有代码通常只需修改启动或查找浏览器的那几行即可迁移,之后的代码保持不变。
从 Playwright 迁移
launch() 返回的是同一个 Playwright Browser,所以只需改动启动调用。如果用的是 playwright-stealth 或 Patchright,插件也一并去掉。
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()从 playwright-stealth 或 Patchright 迁移 →
从 puppeteer-extra-plugin-stealth 迁移
保留 Puppeteer,去掉插件。serve() 会启动带 CDP 端点的 Clearcote,Puppeteer 再连接到这个端点。
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();从 puppeteer-extra-plugin-stealth 迁移 →
从 undetected-chromedriver 迁移
这是唯一一处不止改一行的迁移:Clearcote 通过 CDP 而不是 WebDriver 驱动,所以脚本要改用 Playwright。大多数 Selenium 调用都有一行就能写出的对应写法。selenium-stealth 也是如此。
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")从 undetected-chromedriver 迁移 →
从 Camoufox 迁移
两者都从打过补丁的引擎交给你一个 Playwright 对象,所以 Camoufox(...) 变成 launch(...),选项名大多相同,只是换成了 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()从指纹浏览器应用迁移
Multilogin、GoLogin、AdsPower、Dolphin Anty、Kameleo:一个配置文件变成一个设备种子 (seed) 加一个存放 Cookie 的文件夹。不再需要一直运行的桌面应用,也不需要先调用本地 API。
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()从 Fortress 迁移(BSD 版本)
你的客户端照旧连接 CDP 端点,变的只是启动端点的那部分。在 Docker 中,把镜像换成 teamflatearth/clearcote,端口保持不变。
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)从 Browserless 迁移
你的代码照旧连接一个 WebSocket 地址。Clearcote 会话为每个连接提供一个地址;也可以让 SDK 在一次调用中创建会话并完成连接。
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();从 Browserbase 迁移
结构相同:创建会话,再连接到它的地址。sessions.create() 变成 POST /api/v1/browsers,或者用 launch(cloud=True) 一步完成两件事。
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()迁移时可以删掉的内容
Clearcote 在引擎内部根据一个 fingerprint 种子设置指纹。旧方案从外部做的改动,现在都会起反作用:
- stealth 插件和规避脚本(通过
evaluateOnNewDocument、add_init_script对navigator打的补丁); - 手动设置的 User-Agent、视口、平台、WebGL 厂商或 GPU 字符串;
- 使用代理时对时区和语言的覆盖:传入
geoip=True,它们就会跟随出口 IP。
给每个账号分配专属种子并一直沿用:同一个种子每次都是同一台设备。没有许可证密钥时,SDK 运行开源版构建(BSD-3,无需账号);通过 GitHub 登录获得的免费密钥可使用最新构建。参见推荐设置和安装。