跳到正文

迁移到 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()

从 Camoufox 迁移 →

从指纹浏览器应用迁移

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)

从 Fortress 迁移 →

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

从 Browserless 迁移 →

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

从 Browserbase 迁移 →

迁移时可以删掉的内容

Clearcote 在引擎内部根据一个 fingerprint 种子设置指纹。旧方案从外部做的改动,现在都会起反作用:

  • stealth 插件和规避脚本(通过 evaluateOnNewDocument、add_init_script 对 navigator 打的补丁);
  • 手动设置的 User-Agent、视口、平台、WebGL 厂商或 GPU 字符串;
  • 使用代理时对时区和语言的覆盖:传入 geoip=True,它们就会跟随出口 IP。

给每个账号分配专属种子并一直沿用:同一个种子每次都是同一台设备。没有许可证密钥时,SDK 运行开源版构建(BSD-3,无需账号);通过 GitHub 登录获得的免费密钥可使用最新构建。参见推荐设置和安装。

更新于 2026年10月16日 · SDK 0.70.5 · 浏览器 r63

这个页面有帮助吗?