本文へスキップ

undetected-chromedriver からの移行

Clearcote は WebDriver ではなく CDP で操作するため、移行は 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=...)削除します。これらの値はペルソナが提供し、GPU、フォント、ユーザーエージェントと整合します
認証用のプロキシ拡張機能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 スイートがある場合

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

このページは役に立ちましたか?