本文へスキップ

Browserless からの移行

Browserless は、Puppeteer や Playwright の接続先となる WebSocket アドレスを、自社クラウドまたは Docker イメージで提供します。Clearcote もその両方に対応しているため、変わるのはコードの接続先アドレスだけです。ページを操作するコードはそのまま使えます。

Browserless クラウドから

Browserless のアドレスは固定です。Clearcote では先にセッションを作成し、その connectUrl は 1 回だけ使います。そのため新しく増える手順は、接続のたびに行う作成呼び出しだけです。SDK はこの 2 つを 1 回の呼び出しで行います。

import puppeteer from "puppeteer-core";

async function connectUrl(options = {}) {
  const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
    method: "POST",
    headers: { authorization: "Bearer " + process.env.CLEARCOTE_API_KEY, "content-type": "application/json" },
    body: JSON.stringify(options),
  });
  const { connectUrl, error } = await res.json();
  if (error) throw new Error(error);
  return connectUrl;                      // single-use: create one per connection
}

const browser = await puppeteer.connect({
  browserWSEndpoint: "wss://production-sfo.browserless.io?token=" + process.env.BROWSERLESS_TOKEN,
  browserWSEndpoint: await connectUrl({ identity: "acct-1", country: "us" }),
  defaultViewport: null,
});
const page = await browser.newPage();
await page.goto("https://example.com");
await browser.close();                    // ends the session

キーは「API keys」ページで取得します。SDK は CLEARCOTE_API_KEY からキーを読み込みます。ブラウザは接続した時点で起動し、通常は数秒で立ち上がります。country を指定すると 30 秒ほどかかることがあるため、Playwright の connectOverCDP には 2 分の timeout を指定してください。defaultViewport: null はそのままにしておくと、Puppeteer はペルソナがブラウザに与えたウィンドウサイズを維持します。

URL オプションの移し先

Browserless の URL に書いていた設定は、作成呼び出しの JSON ボディに入れます。Chromium の起動フラグにはホスト型での対応物がありません。ペルソナとそのスイッチは自動で設定されます。

やりたいこと作成ボディ
特定の国の住宅用 IP から出る"country": "de" (state、city も指定可)。デフォルトはマネージドプール
自前のプロキシ"proxy": { "server": "http://host:8080", "username": "…", "password": "…" }
アカウントごとに同じ IP とデバイス"identity": "acct-1"
セッション間で Cookie を保持"profile": { "name": "acct-1", "persist": true }
セッションの制限時間"timeoutSec", "idleTimeoutSec"
録画"record": true
後で再接続する"keepAlive": true

すべてのオプションはオプション & アイデンティティにあります。ステルスは別のルートではありません。すべてのホスト型ブラウザがエンジンレベルのペルソナで動作し、チェックボックス、スライダー、長押し型の認証はデフォルトで処理されます(チャレンジ)。/content、/screenshot、/pdf のエンドポイントはありません。数行の Playwright で書くか、タスクを説明して、JSON を返すエージェントの実行を開始してください。

Browserless の Docker イメージから

オープンソース版イメージに最も近いのは clearcote serve です。常駐するエンドポイントが 1 つあり、アイデンティティごとに別のブラウザが動き、設定は接続 URL に書きます。

docker run -p 3000:3000 -e TOKEN=... ghcr.io/browserless/chromium
pip install -U clearcote          # or: npm install -g clearcote
clearcote serve --port 9222 --idle-timeout 300 --max-browsers 16
python
p.chromium.connect_over_cdp("http://127.0.0.1:9222")                                     # one shared browser
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-1&platform=windows")  # a browser of its own
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-2&proxy=http://user:pass@host:8080&geoip=true")

コンテナごとに 1 つのアイデンティティを使う場合は、teamflatearth/clearcote イメージがポート 9222 で CDP を提供します。デプロイ & Dockerを参照してください。いずれの場合も、ポートは信頼できるネットワーク内に留めてください。CDP ポートを握られることは、ブラウザを完全に操作されることを意味します。複数ブラウザの同時実行とパスワード付きプロキシにはライセンスキーが必要です。GitHub でサインインすれば同時に 1 ブラウザまで無料、Pro なら最大 250 まで使えます。

料金

ホスト型ブラウザはプリペイド残高から GB 単位のトラフィックで課金され、選ぶプランはありません。料金 & トラフィックを、同時実行数については制限 & エラーを参照してください。

2026年10月16日 更新 · SDK 0.70.5 · ブラウザー r63

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