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 16p.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 単位のトラフィックで課金され、選ぶプランはありません。料金 & トラフィックを、同時実行数については制限 & エラーを参照してください。