从 playwright-stealth 或 Patchright 迁移
你本来就在写 Playwright,所以这是最短的一次迁移:SDK 的 launch() 返回一个 Playwright Browser。替换启动浏览器的那一行,之后的每一行都不用动。
从 playwright-stealth 迁移
from playwright.sync_api import sync_playwright
from playwright_stealth import stealth_sync
from clearcote import launch
browser = sync_playwright().start().chromium.launch(proxy={"server": "http://proxy.example:8080"})
page = browser.new_page(user_agent="Mozilla/5.0 ...", locale="de-DE", timezone_id="Europe/Berlin")
stealth_sync(page)
browser = launch(
fingerprint="acct-1", # one seed per account: the same device every run
proxy={"server": "http://proxy.example:8080"},
geoip=True, # timezone, language and WebRTC follow the exit IP
)
page = browser.new_page()
page.goto("https://example.com")
browser.close()在 playwright-stealth 2.x 中,Stealth().use_sync(sync_playwright()) 这段代码也同样删掉。launch() 会自己启动 Playwright,除了 Clearcote 的选项外,也接受 Playwright 自带的启动选项(headless、proxy、args、slow_mo),并在首次使用时把经过校验的构建下载到缓存中。
从 Patchright 迁移
from patchright.sync_api import sync_playwright
from clearcote import launch_persistent_context
context = sync_playwright().start().chromium.launch_persistent_context(
user_data_dir="profiles/acct-1", channel="chrome", headless=False, no_viewport=True,
)
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1", headless=False)
page = context.new_page()
page.goto("https://example.com")
context.close()SDK 已经关闭了 Playwright 的模拟视口和 --enable-automation 开关,所以 no_viewport 和 channel 可以去掉。如果仍想保留 Patchright 的驱动,用 serve() 启动 Clearcote,再用 connect_over_cdp(srv.cdp_url) 连接 Patchright;参见Puppeteer 及其他 CDP 客户端。
还需要删掉什么
| 你设置的 | 使用 Clearcote |
|---|---|
add_init_script 规避脚本 | 删除。引擎会原生设置这些值 |
user_agent=, viewport=, device_scale_factor= | 删除。它们来自身份画像,与屏幕、GPU 和 Client Hints 保持一致 |
locale=, timezone_id= | 配合代理使用 geoip=True,或者在 launch() 上设置 accept_language 和 timezone |
| 每次运行随机的 User-Agent | 每个账号一个 fingerprint 种子。新种子就是一台新的、一致的设备 |
| 自己写的鼠标移动辅助函数 | humanize=True:在 Playwright 自身的调用中产生拟人的移动轨迹、输入和滚动 |
browser.new_context(...) 仍然可用,但它的选项会覆盖身份画像。请不要传这些选项,或者改用 browser.new_page(),它会按原样使用身份画像打开页面。
检查切换结果
clearcote info 会输出 SDK 解析到的构建以及启动测试结果。没有许可证密钥时就是开源版构建(BSD-3,无需账号);带用户名和密码的代理需要最新构建,通过 GitHub 登录即可免费获得(clearcote login)。接下来:推荐设置和拟人化输入。对比:playwright-stealth 和 Patchright。