跳到正文

从 undetected-chromedriver 迁移

Clearcote 通过 CDP 而不是 WebDriver 驱动,所以迁移就是从 Selenium 换到 Playwright。没有 ChromeDriver,也就没有需要打补丁、需要跟浏览器保持同步的驱动。同样的步骤也适用于 selenium-stealth。

改动

import undetected_chromedriver as uc
from selenium.webdriver.common.by import By
from clearcote import launch

options = uc.ChromeOptions()
options.add_argument("--proxy-server=http://proxy.example:8080")
driver = uc.Chrome(options=options, headless=True)
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
    humanize=True,                           # human mouse paths, typing and scrolling
)
page = browser.new_page()
driver.get("https://example.com")
driver.find_element(By.CSS_SELECTOR, "a").click()
print(driver.title)
driver.quit()
page.goto("https://example.com")
page.locator("a").first.click()
print(page.title())
browser.close()

launch() 在首次使用时下载经过验证的 Clearcote 构建,启动它并返回一个 Playwright Browser。

从 Selenium 到 Playwright:逐个调用对照

SeleniumPlaywright
driver.get(url)page.goto(url)
driver.find_element(By.CSS_SELECTOR, s)page.locator(s)
driver.find_element(By.XPATH, x)page.locator("xpath=" + x)
el.click(), el.send_keys("x")loc.click()、loc.fill("x") 或 loc.press_sequentially("x")
el.text, el.get_attribute("href")loc.inner_text(), loc.get_attribute("href")
WebDriverWait(driver, 10).until(...)通常什么都不用做:操作会自动等待元素。否则用 loc.wait_for()
driver.execute_script(js)page.evaluate(js)
driver.get_cookies(), add_cookiepage.context.cookies(), add_cookies
driver.save_screenshot(path)page.screenshot(path=path)
driver.switch_to.frame(f)page.frame_locator(s)
driver.switch_to.window(h)每个标签页都是独立的 page;context.pages 会列出它们

选项

之前使用 Clearcote
stealth(driver, vendor=..., webgl_vendor=..., renderer=..., platform=...)删除它。这些值由身份画像(persona)提供,并与 GPU、字体和 User-Agent 保持一致
用于代理登录认证的扩展在 launch() 上传入 proxy={"server", "username", "password"};需要最新构建(见下文)
--user-agent, --lang, --window-size删除它们,或使用 accept_language 和 timezone;geoip=True 会根据代理同时设置两者
user_data_dir=launch_persistent_context(user_data_dir, ...)
version_main=、驱动补丁无需打补丁:根本没有 ChromeDriver

Selenium 测试套件很大?

Clearcote 不支持 Selenium 和 WebDriver。ChromeDriver 可以通过 debugger_address 连接到用 serve() 启动的浏览器,但这样一来,驱动会把这次迁移本想去掉的 WebDriver 特征重新带回来(参见检测原理)。只在迁移期间这样用,并优先迁移重要的流程。

python
from urllib.parse import urlparse
from clearcote import serve
from selenium import webdriver

with serve(fingerprint="acct-1") as srv:          # unsupported: for the transition only
    options = webdriver.ChromeOptions()
    options.debugger_address = urlparse(srv.cdp_url).netloc
    driver = webdriver.Chrome(options=options)
    driver.get("https://example.com")
    driver.quit()

检查迁移结果

clearcote info 会打印 SDK 解析到的构建以及一次启动测试的结果。没有许可证密钥时,这就是开源版构建(BSD-3,无需账号);带用户名和密码的代理需要最新构建,用 GitHub 登录即可免费获取(clearcote login)。然后在新环境中打开 audit 页面进行对比。对比页面:undetected-chromedriver 和 selenium-stealth。

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

这个页面有帮助吗?