インストール

SDK をインストールして検証済みのブラウザを取得させるか、ビルドを自分でダウンロードして検証します。

Clearcote は現在も活発に開発中です。ビルドは Windows x64 版と Linux x64 版を提供しており、SDK は OS に合ったほうをダウンロードします。macOS はロードマップに載っています。それまでの間、macOS ユーザーは Docker イメージを使えます。最小構成の Linux ホストでは、ブラウザのランタイムライブラリ（libnss3 libgbm1 libasound2 libatk1.0-0 libatk-bridge2.0-0 libcups2 libxkbcommon0 libpango-1.0-0 …）をインストールしてください。不足しているものは clearcote info で一覧表示できます。自分でバイナリを root として起動する場合（コンテナではよくあるケース）は --no-sandbox を渡してください。SDK と clearcote serve はこれを自動で処理します。

新登場最新ビルドは、ブラウザ 1 つなら GitHub で無料。カード登録は不要です。

無料で入手

SDK をインストールする（推奨）

bash

npm i clearcote                # Node 20+
pip install clearcote          # Python 3.8+
dotnet add package Clearcote   # .NET 8

最初の launch() で OS に合ったブラウザがダウンロードされ、SHA-256 を確認したうえでキャッシュされます。playwright install を実行する必要はありません。各 SDK は自前の Playwright ドライバーを同梱し、ブラウザも自分で取得します。どのビルドが使われるかは、ライセンスキーを設定しているかどうかで決まります。

	ビルド	取得元
キーなし	オープンビルド — Chromium 149.0.7827.114（v0.1.0-pre.22）。BSD-3 ライセンスで、公開ソースから再現できます。	GitHub Releases（SDK のバージョンで固定）
キーあり	ライセンスビルド — Chromium 153.0.8010.36-r28。GitHub で無料（同時に 1 ブラウザまで）、または Pro。	clearcotelabs.com（起動のたびに現行のビルド）

ライセンスキーを設定する

SDK は次の順にキーを探します。まず起動オプションの licenseKey / license_key / LicenseKey、次に環境変数 CLEARCOTE_LICENSE_KEY、その次に clearcote login が書き込むファイル ~/.clearcote/license.key です。このファイルは .NET を含むすべての SDK が読み込みます。無料のキーは、ダッシュボードの「Licenses」から取得できます。

bash

clearcote login cc_lic_...              # checks the key, saves it to ~/.clearcote/license.key
export CLEARCOTE_LICENSE_KEY=cc_lic_...  # or per process / per container

clearcote コマンド

Python と Node のパッケージは clearcote コマンドをインストールします（npm でローカルにインストールした場合は npx clearcote … として実行します）。.NET のパッケージには含まれていません。

bash

clearcote install              # download + verify the browser now (CI, Docker builds)
clearcote info                 # SDK, key, cached builds, seats in use, a launch test, missing libraries
clearcote info --proxy <url>   # the exit IP, timezone and language a launch through this proxy would get
clearcote update               # fetch a newer build if one exists (newest open build, or current licensed)
clearcote clear-cache          # delete cached builds — old ones are kept until you do
clearcote login [key]          # clearcote logout removes the saved key
clearcote serve                # a standing CDP endpoint — see Deployment

clearcote install --version 153 や --channel preview で特定のビルドを選べます。詳しくはビルドの選び方を参照してください。次は Playwright または Puppeteer に組み込みます。

手動インストール（オープンビルド）

バイナリを直接使いたい場合は、GitHub Releases にオープンビルドがあります。ライセンスビルドはそこでは公開していません。ライセンスビルドは SDK、clearcote serve、Docker イメージのいずれかを通じて動作し、SDK が用意する実行トークンがなければ起動しません。

1. ダウンロード

最新の v0.1.0-pre.* リリースをダウンロードしてください。現在の最新は v0.1.0-pre.22（Chromium 149.0.7827.114）です。各リリースには次のファイルが含まれます。

clearcote-<version>-windows-x64.zip — Windows 版ビルド（Chromium + ランタイム + VC++ DLL）
clearcote-<version>-linux-x64.tar.xz — Linux 版ビルド
.sha256 ファイルと SHA256SUMS.txt — チェックサム
.asc ファイル + clearcote-signing-key.asc — GPG の分離署名と公開鍵

2. 検証する（推奨）

オープンビルドは、私たちを信頼しなくても済むように作られています。展開する前に、ダウンロードしたものがビルド・署名されたものと完全に一致することを確認してください。手順は検証のページにあります。

3. 展開する

Windows 版のアーカイブはそれだけで完結しています。VC++ 2015–2022 のランタイム DLL を同梱しているため、クリーンな Windows 10/11 マシンでそのまま動作します。Linux 版のアーカイブには、上に挙げたランタイムライブラリが必要です。

Expand-Archive clearcote-149.0.7827.114-windows-x64.zip -DestinationPath C:\clearcote

# you now have:
#   C:\clearcote\chrome.exe
#   C:\clearcote\chrome.dll  + runtime, locales, ICU, ANGLE, VC++ DLLs

4. スモークテスト

シードを指定して起動し、フィンガープリントテストのページを開きます。

C:\clearcote\chrome.exe --fingerprint=seed-123 --fingerprint-platform=windows https://abrahamjuliot.github.io/creepjs/

--fingerprint のシードが同じなら、起動するたびに同じアイデンティティになります。新しいシードなら新しいアイデンティティです。シードから導出した値ではなく実機から取得した値を返したい場合は、取得済みのプロファイルをインポートします（フィンガープリントフラグを参照）。そのあと Playwright または Puppeteer に組み込みます。

Docker で実行する

公式イメージは Clearcote を CDP エンドポイントとして実行します。イメージを pull し、Playwright、Puppeteer、browser-use などのクライアントを Chrome DevTools Protocol 経由でそこへ向けるだけで、コードの変更は要りません。

bash

docker run -d --rm -p 127.0.0.1:9222:9222 -e CC_FINGERPRINT=user-7423 teamflatearth/clearcote   # CDP on http://localhost:9222

python

from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://localhost:9222")   # your code, unchanged
    page = browser.new_page(); page.goto("https://example.com")

ペルソナは環境変数で設定します。CC_PLATFORM（windows/linux/macos/android）、CC_FINGERPRINT（シード）、CC_BRAND（Edge など）、CC_ACCEPT_LANGUAGE、CC_TIMEZONE、CC_TLS_PROFILE です。CC_FINGERPRINT はアイデンティティごとに設定してください。設定しないと、すべてのコンテナが同じデフォルトのシードを共有します。イメージに入っているのはオープンビルドです。最新のライセンスビルドを使うには -e CLEARCOTE_LICENSE_KEY=cc_lic_… -v clearcote-cache:/opt/xdg-cache を追加します。ビルドはボリュームに一度だけダウンロードされます。ブラウザは仮想ディスプレイ上で headed モードで動作し（純粋なヘッドレスにするには CC_HEADLESS=1）、イメージは linux/amd64 です。Dockerfile は監査可能なので、自分で再ビルドしてみてください。CDP エンドポイントはブラウザを完全に制御できるため、信頼できるネットワークにだけ公開してください（-p 127.0.0.1:9222:9222 ならホスト内に限定されます）。詳しくはデプロイを参照してください。

動作要件

Windows 10 / 11 x64、または上記のランタイムライブラリを入れた Linux x64（glibc）。
Windows では VC++ 再頒布可能パッケージを別途入れる必要はありません。アーカイブに同梱されています。
SDK：Node 20+、Python 3.8+、または .NET 8。それぞれ専用の Playwright ドライバー（playwright-core、playwright、Microsoft.Playwright）を取り込みます。
オープンビルドのバイナリを直接使う場合：既存の Playwright または Puppeteer のインストール（Clearcote が置き換えるのはブラウザで、ドライバーではありません）。