本文へスキップ

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 から

1 行の変更では済まない唯一のケースです。Clearcote は WebDriver ではなく CDP で操作するため、スクリプトは Playwright に移します。Selenium の呼び出しの多くには、1 行で書ける対応する書き方があります。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 のいずれでも、プロファイルはデバイス用のシードと 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 のセッションは接続ごとにアドレスを 1 つ発行します。SDK にセッションの作成と接続を 1 回の呼び出しで任せることもできます。

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 は 1 つの fingerprint シードから、エンジン内部でフィンガープリントを設定します。旧環境が外側から変更していた次のようなものは、いまでは逆効果になります。

  • ステルスプラグインや evasion スクリプト(evaluateOnNewDocument や add_init_script による navigator のパッチ)
  • 手動で設定した User-Agent、ビューポート、プラットフォーム、WebGL ベンダー、GPU 文字列
  • プロキシ使用時のタイムゾーンや言語の上書き。geoip=True を渡せば、出口 IP に合わせて設定されます。

アカウントごとに専用のシードを割り当て、変えずに使い続けてください。同じシードなら毎回同じデバイスになります。ライセンスキーがなければ SDK はオープンビルド(BSD-3、アカウント不要)を実行し、GitHub でサインインして得られる無料キーがあれば最新ビルドを使えます。詳しくは推奨設定とインストールを参照してください。

2026年10月16日 更新 · SDK 0.70.5 · ブラウザー r63

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