本文へスキップ

プランと制限

ライセンスが 1 日にダウンロード・取得できる量、制限を超えたときに起きること、制限内に収める方法をまとめています。料金と各プランの内容は料金ページをご覧ください。

要点

  • ライセンス版ビルドのダウンロード:同じビルドにつき 1 分あたり 20 回、24 時間あたり 30 回まで。キャッシュにビルドが見つかった起動は数えられません。
  • 1 日あたりの異なるペルソナ数:無料プランは 750、有料プランは 1,000,000。今日すでに使ったシードでの再起動は数えられません。
  • 制限を超えると HTTP 429 が返ります。ブラウザのキャッシュはボリュームに置き、決まったシードのプールを使い回してください。

ダウンロード制限

ライセンス版ビルドのダウンロードにはライセンスごとの回数制限があり、起動のたびにアーカイブ全体を取得する構成が 暴走しないようになっています。キャッシュにビルドがある起動は何もダウンロードせず、回数にも数えられません。 数えるのは実際のダウンロードだけです。

制限対象数えるもの
20 回のダウンロード / 分、30 回 / 24 時間すべてのライセンス、ビルドごと(バージョン + OS)同じビルドのアーカイブのダウンロード。新しいリリースでは枠がリセットされます。
10 種類のビルド / 24 時間無料ライセンス取得した異なるビルドの数。今日すでにダウンロードしたビルドは再度数えられません。
60 回のチェック / 分IP アドレスごと起動のたびに /api/v1/download/pro へ行うビルドのチェック(キャッシュの有無を問わず)。

制限を超えると、SDK は JSON 本文付きの HTTP 429 を受け取ります。code は DOWNLOAD_RATE_LIMITED(ビルドごとの枠)または DOWNLOAD_LIMIT_EXCEEDED(無料プラン)で、 制限がリセットされるまでの秒数を示す Retry-After ヘッダーが付きます。ビルドがキャッシュ済みの起動はそのまま動きます。 SDK 0.62.0 以降、新しいビルドをダウンロードできない起動は、失敗する代わりにキャッシュにある同じ Chromium バージョンの最新ビルドを起動し、Retry-After が過ぎるまでそのダウンロードを再試行しません。 正確なリビジョン(r50)に固定した起動は、引き続きそのビルドかエラーになります。

これらの制限に当たるのは、空のキャッシュを持つ新しいマシンやコンテナが一斉に多数起動するときです。起動ごとでは なくマシンごとに一度だけ各ビルドをダウンロードしましょう。約 460 MB のダウンロードがなくなり、起動も速くなります。

  • キャッシュをボリュームに置く。CLEARCOTE_CACHE を再起動後も残るディレクトリに 向けます。それを共有する起動は最初のダウンロードを待ち、それを再利用します。
  • ブラウザをイメージに焼き込む。ビルド時に clearcote install を実行すれば、どの コンテナもビルドが入った状態で起動します。アップグレード時はイメージを作り直してください。
bash
# 1. a shared, persistent cache
docker run -v clearcote-cache:/clearcote-cache -e CLEARCOTE_CACHE=/clearcote-cache …

# 2. or in your Dockerfile: download once while the image is built (the key stays out of the layers)
ENV CLEARCOTE_CACHE=/opt/clearcote-cache
RUN --mount=type=secret,id=clearcote_key \
    CLEARCOTE_LICENSE_KEY="$(cat /run/secrets/clearcote_key)" clearcote install

Need a higher limit? Tell us how you run Clearcote and we'll raise it for your licence.

Chat with us

ペルソナの上限

起動のたびに、ペルソナ(シードとオプションが表すフィンガープリント)をペルソナサービスから取得します。ライセンスごとに、1 日に取得できる異なるペルソナの数が決まっています。その日にすでに使ったペルソナの再取得はカウントされないため、決まったプロファイルの組み合わせなら何度でも再起動できます。

プラン1 日あたりの異なるペルソナ数
無料750
Pro とその他の有料プラン1,000,000

ペルソナは、1 つのシードと 1 組のフィンガープリントオプション(ブランド、プラットフォームなど)の組み合わせです。そのため、同じシードでも Chrome と Edge では 2 つと数えます。カウントは 00:00 UTC にリセットされます。上限を超えると、リセットまでの間、起動はペルソナサービスからの HTTP 429(daily persona quota reached)で失敗します。

この上限に当たるのは、起動のたびにまったく新しいランダムなシードを使う場合です。代わりに、決まったシードのプールを再利用してください。たとえば数百個の名前のリストを順番に使います。どのシードも起動するたびに同じフィンガープリントを保ち、再起動してもカウントは増えません。

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

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