本文へスキップ

クラウドのクイックスタート

当社のサーバー上で Clearcote ブラウザを起動し、Playwright から操作します。必要なのは API キー、SDK、そして引数 1 つだけです。

無料GitHub を連携すると €5 分の通信量が無料。カード登録は不要です。

1 回限り、GitHub アカウント 1 つにつき 1 回です。GitHub アカウントは作成から 30 日以上経っている必要があります。

€5 を受け取る

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 を使った詳しい手順は「ホスト型ブラウザ」にあります。

次のステップ

2026年11月22日 更新 · SDK 0.70.4 · ブラウザー r63

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