Local Agent Browser CLI は Agent Browser CLI に統合されました。npm パッケージ
gologin-local-agent-browser-cli は非推奨です。gologin-agent-browser-cli をインストールし、--runtime local を使用してください。gologin-local-agent-browser を呼び出している既存のスクリプトは引き続き動作します。詳しくは Local Agent Browser CLI からの移行 をご覧ください。cloud ランタイムは、Gologin の Cloud Browser でセッションを実行します。local ランタイムは、Gologin のブラウザである Orbita をお使いのマシン上で実行します。このページでは、ローカルランタイムについて説明します。スナップショット、ref、その他のコマンドは、Agent Browser CLI のページで説明している内容と同じように動作します。
local と cloud の使い分け
要件
- Node.js 20 以降。ローカルランタイムは Gologin Node.js SDK 経由で Orbita を起動するため、Node.js 20 が必要です。
GOLOGIN_TOKENに設定した Gologin API トークン。トークンを取得するをご覧ください。- すべてのセッションに必要なプロファイル ID。cloud ランタイムと異なり、ローカルランタイムでは一時プロファイルは作成されません。
- Orbita。まだインストールされていない場合は、初回起動時に Gologin SDK が
~/.gologin/browserにダウンロードします。Orbita が別の場所にある場合は、GOLOGIN_EXECUTABLE_PATHを設定してください。
インストール
gologin-agent-browser:local を指定しない限り、クラウドでブラウザセッションを実行します。gologin-local-agent-browser:ローカルランタイムでコマンドを実行する互換用のエイリアスです。
ローカルランタイムを選択する
コマンドに--runtime local を付けるか、シェル全体のランタイムを一度に設定します。
--local や、先頭に local を付ける方法でも指定できます。gologin-agent-browser local open https://example.com --profile your_profile_id
api、browser、proxy などの Gologin API コマンドは、ランタイムに関係なく常に API を直接呼び出します。
環境変数
ローカルランタイムは、設定、プロファイル一覧、ジョブ履歴を
~/.gologin-local-agent-browser/ に保存します。これは以前の CLI が使っていたフォルダと同じです。
クイックスタート
--visible(または --headed)と --headless(または --background)で、1 回の open に対するウィンドウモードを選択できます。open-visible と open-background は、それぞれのショートカットです。
ブラウザコマンド
セッションコマンドは cloud ランタイムと同じです。snapshot、click、type、fill、find、wait、press、scroll、tabs、cookies、storage-export、eval、screenshot、pdf、upload などがあります。コマンドリファレンスをご覧ください。back、forward、reload は、現時点では cloud ランタイムでのみ使用できます。
find は、表示中のページ上の要素を探し、そのまま操作まで 1 ステップで行います。動的なページで ref が古くなってしまう場合に使用してください。
プロファイルコマンド
以下のコマンドは、--runtime local を付けなくてもローカルランタイムで実行されます。
profile-create と profile-update では、用途別のテンプレートとプロキシを指定できます。--proxy-country us で Gologin のプロキシを追加し、--proxy-host と --proxy-port で独自のプロキシを設定します。
ランブックとバッチジョブ
ランブックは、CLI のステップを並べた JSON ファイルです。targets.json には対象のプロファイルを記述します。
jobs と job <jobId> で確認できます。--status には running、ok、partial、failed を指定できます。
Local Agent Browser CLI からの移行
gologin-local-agent-browserを呼び出しているスクリプトは、引き続き動作します。このコマンドは現在、gologin-agent-browser-cliに含まれています。~/.gologin-local-agent-browser/内のプロファイル、設定、ジョブ履歴は、そのまま残ります。- AI エージェントを使う場合は、Agent Browser スキルをインストールしてください。両方のランタイムに対応しており、別ものだった Local Agent Browser スキルは非推奨です。
関連情報
- Agent Browser CLI — コマンドの完全なリファレンスと cloud ランタイム
- Gologin Web Access CLI — スクレイピングとブラウザのコマンドを 1 つの CLI で
- AI Skills — Claude Code やその他のエージェント向けスキル
- Node.js SDK — 独自のコードからプロファイルを実行
npm パッケージ
gologin-agent-browser-cli
ソースコード
GologinLabs/agent-browser