クラウドのクイックスタート
当社のサーバー上で Clearcote ブラウザを起動し、Playwright から操作します。必要なのは API キー、SDK、そして引数 1 つだけです。
無料GitHub を連携すると €5 分の通信量が無料。カード登録は不要です。
1 回限り、GitHub アカウント 1 つにつき 1 回です。GitHub アカウントは作成から 30 日以上経っている必要があります。
1. API キーを取得する
「API keys」ページで作成します。キーは cc_live_ で始まります。他人に知られないようにしてください。キーを持っている人なら誰でも、あなたの残高を使えてしまいます。環境変数に設定します。
export CLEARCOTE_API_KEY=cc_live_...セッションの料金はプリペイド残高から支払われます。トラフィック 1 GB あたり €1.00 で、住宅用プロキシ込みです。残高はダッシュボードの「Hosted browsers」タブでチャージできます。詳しくは「料金とトラフィック」をご覧ください。
2. clearcote パッケージを追加する
クラウドモードには SDK 0.34.0 以降が必要です。
bash
npm i clearcote # Node 20+
pip install clearcote # Python 3.8+3. クラウドで起動する
cloud=True(Python)または cloud: true(Node)を渡します。戻り値は通常の Playwright の Browser で、当社のサーバー上のブラウザに接続されています。
from clearcote import launch
browser = launch(cloud=True, fingerprint="acct-1", country="de")
page = browser.contexts[0].new_page()
page.goto("https://example.com")
print(page.title())
browser.close() # ends the cloud sessionこのタブはあなたのマシンで実行します。
fingerprintはデバイスを選びます。同じシードからは毎回同じデバイスが得られます。countryは住宅用 IP の出口の国を選びます。- ページは
browser.contexts[0]で開いてください。このコンテキストがセッションのプロファイルと Cookie を保持しています。 browser.close()でセッションが終了します。料金は使用したトラフィック分のみで、時間には課金されません。CLEARCOTE_CLOUD=1を設定すると、コードを変更せずにcloud=Trueと同じ動作になります。
SDK を使わない場合
どの CDP クライアントでも使えます。POST /api/v1/browsers は 1 回限り有効な connectUrl を返し、Playwright の connectOverCDP や Puppeteer の connect でそこに接続します。curl、Node、Python を使った詳しい手順は「ホスト型ブラウザ」にあります。
次のステップ
- ローカルとクラウド:ローカルでの起動と比べて、何が同じで何が違うか。
- オプション & アイデンティティ:アカウントごとに 1 つのアイデンティティ、プロファイル、固定したリリース。
- 出口 IP:ローテーション、固定(sticky)、地域指定の住宅用 IP。
- ライブビュー & セッション:セッションを見る、操作を引き継ぐ、再接続する。
- エージェントの実行:タスクを普通の言葉で送り、JSON で結果を受け取る。