アンチディテクトブラウザアプリからの移行
Multilogin、GoLogin、AdsPower、Dolphin Anty、Kameleo のプロファイルをコードから自動化しているチーム向けのガイドです。Clearcote では、スクリプト自身がブラウザを起動します。デスクトップアプリを動かし続ける必要も、最初にローカル API を呼び出す必要もありません。
変更点
import requests
from playwright.sync_api import sync_playwright
from clearcote import launch_persistent_context
ws = requests.get("http://local.adspower.net:50325/api/v1/browser/start",
params={"user_id": "k1abc23"}).json()["data"]["ws"]["puppeteer"]
browser = sync_playwright().start().chromium.connect_over_cdp(ws)
page = browser.contexts[0].new_page()
context = launch_persistent_context(
"profiles/acct-1", # cookies and storage live here
fingerprint="acct-1", # the device: same seed, same device
platform="windows",
proxy={"server": "http://proxy.example:8080", "username": "user", "password": "pass"},
geoip=True, # timezone, language and WebRTC follow the exit IP
)
page = context.new_page()
page.goto("https://example.com")ここでは AdsPower の起動呼び出しを示しています。呼び出し方はアプリごとに異なりますが(Multilogin X:GET https://launcher.mlx.yt:45001/api/v2/profile/f/<folder>/p/<id>/start)、どの場合も呼び出しそのものが不要になります。アプリが渡していたような CDP アドレスを前提とするツールが他にある場合は、serve(fingerprint="acct-1", user_data_dir="profiles/acct-1") で同じブラウザを起動すると、srv.cdp_url にエンドポイントが用意されます。デプロイ & Docker を参照してください。
プロファイルはシードとフォルダになる
| アプリのプロファイルでは | Clearcote では |
|---|---|
| フィンガープリント(OS、画面、GPU、フォント、canvas) | fingerprint シードと platform。同じシードからは毎回同じデバイスが得られます |
| Cookie、ストレージ、ログイン状態 | プロファイルフォルダ:launch_persistent_context("profiles/acct-1", ...) |
| プロキシとその所在地 | proxy= と geoip=True |
| ローカル API に渡すプロファイル ID | 任意の名前。シードとフォルダ名の両方に使えば、対応関係が一目でわかります |
Cookie を引き継ぐ
古いプロファイルをアプリの API から最後にもう一度起動し、ストレージを保存して、Cookie を新しいフォルダに読み込みます:
import json
from playwright.sync_api import sync_playwright
from clearcote import launch_persistent_context
# 1. from the running app profile (ws = the address its start call returned)
with sync_playwright() as p:
old = p.chromium.connect_over_cdp(ws)
old.contexts[0].storage_state(path="acct-1.json")
# 2. into the Clearcote profile, once
context = launch_persistent_context("profiles/acct-1", fingerprint="acct-1")
context.add_cookies(json.load(open("acct-1.json"))["cookies"])
context.close()ホスト型ブラウザの場合は、clearcote cloud profile sync acct-1 --from-cdp <address> --domain example.com で、実行中のプロファイルからクラウドプロファイルへ Cookie を直接コピーできます。プロファイル & シークレットを参照してください。
フィンガープリントは引き継がれません。新しいシードは新しいデバイスなので、サイトから見ると、ノート PC を買い替えたときのようにデバイスが一度だけ変わります。以降はそのシードを使い続け、新しいデバイスに敏感に反応するアカウントは少しずつ移行してください。
日々の運用で変わること
- サーバーで動きます。GUI セッションも、アプリへのログインも、ローカル API のポートも不要です。Linux、Windows、Docker イメージでヘッドレス実行できます。
- プロファイル単位の料金はありません。シードとプロファイルフォルダは無料で、ライセンスは同時に実行するブラウザの数で数えます。料金を参照してください。
- 中身を読めるエンジン。オープンビルドは BSD-3 で、含まれるパッチはすべて公開されています。
- やはりウィンドウが必要ですか?Profile Manager アプリなら、アイデンティティを通常のブラウザウィンドウとして開き、手作業で操作できます。
切り替えを確認する
clearcote info は、SDK が解決するビルドと起動テストの結果を表示します。ユーザー名とパスワード付きのプロキシには最新ビルドが必要で、GitHub でサインインすれば無料で使えます(clearcote login)。次へ:プロファイル & 永続化。比較:Multilogin、GoLogin、AdsPower、Dolphin Anty、Kameleo。
比較したどのフォークと比べても 2 倍以上のパッチ数。
Chromium にコンパイルされたパッチの数を、アプローチ別に示します。スクリプトベースのツールはエンジンをまったく変更しません。
ステルスプラグイン
例:puppeteer-extra-plugin-stealth
パッチ済みドライバー
例:undetected-chromedriver、nodriver
他の Chromium フォーク
無料ビルドと有料ビルド
Clearcote Pro
r63、Chromium 158
公開されているパッチ数(2026年10月 時点)。範囲は他のフォークの無料ビルドと有料ビルドを含みます。Clearcote の数値は Pro ビルドのものです。
オープンビルドのパッチは公開されています
無料のオープンビルドは BSD-3 で、ソースから再現でき、アカウントも不要です。Pro ビルドは、その上に非公開のパッチを加えています。
GitHub で開くエンジンのリリース 63 回、Chromium メジャーバージョン 9 世代
すべてのパッチを新しい Chromium ごとに移植しています。最新ビルドは新しいメジャーバージョンに公開当日に対応します。
リリースを見る