Browserbase と Browserless:帳票ダウンロードの切断後、ログイン・セッション・ファイルをどう引き継ぐか

Browserbase は管理されたファイル引き渡しと原因調査を重視する直列タスクに向く。Browserless は短時間の再接続、永続セッション、ログインスナップショットなど別々の経路を提供する。保存済みログインやセッション再生を実行再開と考えず、切断復旧、認証期限切れ、重複出力を検証したい。

ソース: docs.browserbase.com
2026年11月16日
12 min

運用担当者がアクセス権のある取引先ポータルから日報を出力し、スクリプトが「帳票生成」を押した直後に切断された。引き継ぐ人は、元のページへ再接続できるか、明日またログインが必要か、ファイルは本当にダウンロードできたかを知る必要がある。Browserbase と Browserless はともに遠隔ブラウザー基盤を提供するが、これらは稼働中のセッション、永続ログイン情報、業務タスク記録という別々の問題だ。

Context、クラウドダウンロード、視覚的な原因調査を一つの管理フローにまとめたいなら Browserbase を優先評価したい。既存 Puppeteer/Playwright フローがあり、短時間の再接続、実行をまたぐ状態、独立したログインスナップショットを明確に選びたいなら Browserless はより細かい経路を提供するが、API の区別が必要だ。本記事は 自社または許可されたポータルの通常の帳票ダウンロードだけを扱う。アクセス制限の回避や認証コードの自動解決は扱わず、実ログインやダウンロード試験も行っていない。

明日の再実行に何を保存するか

Browserbase の Contextsは、Chromium のユーザーデータディレクトリにある cookies、localStorage、IndexedDB などのログイン・アプリ情報を保存する。新セッションには Context ID を渡す必要がある。変更を書き戻すなら作成時に persist: true とし、セッション終了時に保存されるため、再利用前には同期を数秒待つべきだ。公式は一つのサイトの一つのログインに別々の Context を使い、同じ Context の同時使用によるログアウトを避けるよう勧める。

引き継ぎ表には Context ID と session ID を別々に記録すべきだ。前者は新しいブラウザーで情報を読み込むため、後者は一回の実行を特定するために使う。フレームワークの BrowserContext オブジェクト、永続情報、稼働ブラウザーを同一視してはいけない。Context が存在してもログインは保証されず、ポータルは cookie を失効させ、トークンを取り消し、再認証を要求できる。一度 MFA を通ったことは永久に検証不要という意味ではない。

Browserless の現行 v2 文書にある Session APIは、cookies、localStorage、キャッシュをブラウザー再起動後も保持できる。ttl が情報の寿命を制御する。デフォルトの processKeepAlive: 0 では切断後に再接続すると新プロセスが起動して空白ページが開くため、再び移動する必要がある。猶予期間内でプロセスが生存している場合のみ開いたページなどの現場を保持し、このプロセス維持機能は Puppeteer 限定だ。永続セッションには同時に一クライアントしか接続できず、複数人の共有作業台にはできない。

別の選択肢が Authenticated Profilesだ。cookies、localStorage、IndexedDB のスナップショットを保存し、セッションごとに独立したコピーを読み込むが、sessionStorage は保存しない。実行中の変更は元の profile を自動更新しない。複数の許可済みタスクでログイン開始点を再利用するのに向き、同じ帳票ページを共有するものではない。ログイン更新後のスナップショット更新担当を事前に決める必要がある。

数分後に戻るならどのブラウザーを維持するか

Browserbase の keepAliveは、切断後も同じセッションを再接続待ちにし、有料プランだけで利用できる。作業終了時には明示的に解放すべきで、そうしなければタイムアウトまで動き続け、アイドル状態のブラウザー使用量が発生する。短時間の引き継ぎを解決するが、Context のセッション間保存は代替しない。

Browserless の Standard Sessionsは、再接続エンドポイントを先に取得してから切断する必要があり、現行の専用文書はこの経路を Puppeteer に限定している。待機時間も初回起動時から計算するプランの最大セッション時間に制限され、再接続を繰り返して無限延長はできない。再接続ごとに新接続として課金され、待機中も同時実行枠を使う。Playwright のチームは永続状態の文書に沿って設計し、Puppeteer の切断動作をそのまま流用してはいけない。

勤務交代では、人がブラウザーを待つのか、ブラウザーが人を待つのかも分けたい。帳票生成待ちなら短時間セッションを残せるが、翌日扱うなら必要な情報と業務チェックポイントの保存を優先する。そうしなければ待機接続が資源を占め、後任が期限切れのアドレスを受け取るかもしれない。タスクスケジューラーは有効期限と後片付けの責任を記録すべきで、再生のスクリーンショットにその仕事を任せられない。

これは交代する二つのスクリプトの分担も決める。短いネットワーク中断なら有効なセッションへの再接続を試せるが、ブラウザーが終了済みなら業務チェックポイントを読み、帳票一覧を開き直すべきで、むやみに「生成」をもう一度押してはいけない。両製品ともブラウザー再接続だけで業務システムの厳密な一回実行を保証できない。

再生は失敗の説明を助けるが、納品物はファイル

Browserbase のダウンロード文書では、ファイルをクラウドに保存して API で取得し、名前には衝突を減らすタイムスタンプを付ける。スクリプトがクリックを記録するだけでは足りず、取得ファイルの帳票日付、サイズ、内容も確認したい。Browserless のファイル転送文書は、ダウンロードイベントを有効にしてバイト列を受け取る CDP 経路と、Playwright のネイティブ接続での Download.saveAs を示す。リスナーはダウンロードを起動する前に登録する必要がある。接続方式を選ぶ時点で、ファイルをチームのストレージへどう渡すか確認すべきだ。

Browserbase の現行セッション再生はタブ別の HLS 再生と録画ダウンロードを提供する。Browserless の Session Replayは replay=true で有効になり、DOM 変更などのイベントを記録する。WebM を返す画面録画とは異なる。どちらも日付選択の誤りや停止箇所の調査を助けるが、記録を見るだけでは消えたプロセスは復活せず、ダウンロードも自動的に再送されない。

引き継ぎではタスク番号、帳票範囲、出力状態、ファイル検証結果、セッション記録を関連付けるべきだ。再生には業務ページ情報が含まれ、ログイン情報にもアカウントへのアクセス価値がある。閲覧範囲と保持期間を制限し、トークン付き接続アドレスを一般のチケットに貼ってはいけない。

引き継ぎを検証してから展開方式を決める

同じ許可済みアカウントで連続 3 日分の日報を取得する仮の確認を行える。初日は「生成」を押した後に中断し、後任スクリプトがまずポータルの出力履歴を調べる。二日目はブラウザーを終了して永続情報を読み直し、正しいアカウントであることを確認して再移動する。三日目はログインを意図的に失効させ、無限再試行ではなくタスクを止め、アカウント所有者に認証を引き継ぐことを確認する。毎日ファイル日付、空でない内容、タスク番号を確認し、再実行では既存の出力履歴とファイル検証で重複を防ぐ。これは確認設計であり、実施済みの信頼性試験ではない。

自動化層と基盤も分ける必要がある。Stagehandは自然言語操作、抽出、プログラムによる制御 API を提供するが、Browserbase サービス全体ではなく、採用してもセッション、ファイル、再実行の責任が自動で解決されるわけではない。安定したセレクターがあるダウンロードスクリプトを、クラウドブラウザー購入のためだけに AI エージェントへ書き換える必要はない。

Browserless のセルフホスティング説明は基本 Docker イメージと Enterprise 機能を分ける。クラウド再生や BrowserQL などを無料イメージの標準機能すべてと考えてはいけない。リポジトリの LICENSEは SSPL または商用ライセンスで、クローズドソース商用アプリや継続的インテグレーションの商用ライセンス要件を明示する。自主管理の評価にはブラウザー更新、容量、保存、安全性の維持も含め、クラウド請求と一台のサーバー価格だけを比較してはいけない。

最終的に、単一アカウントの直列ダウンロードで、管理されたファイル引き渡しと原因調査を重視するなら Browserbase を先に検証できる。既存クライアントを再利用し、profile と永続セッションを分けたい、または実際にセルフホスティング能力があるチームは Browserless を先に検証できる。許可された帳票 API や定期配信がポータルにあるなら、ページ状態への依存が少ないその経路を先に評価したい。合格基準は、切断、期限切れ、再実行の後も、各ファイルの出所を説明できることだ。

内容説明:本記事は公開情報をもとに整理した、ツール選定の参考情報です。機能、料金、関連ポリシーは随時変更される場合があります。最新の公式情報をご確認ください。

元の出典:docs.browserbase.com