メインコンテンツへスキップ
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 からの移行 をご覧ください。
Agent Browser CLI には、同じコマンドで使える 2 つのランタイムがあります。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 を設定してください。

インストール

このパッケージには 2 つのコマンドが含まれます。
  • gologin-agent-browser:local を指定しない限り、クラウドでブラウザセッションを実行します。
  • gologin-local-agent-browser:ローカルランタイムでコマンドを実行する互換用のエイリアスです。

ローカルランタイムを選択する

コマンドに --runtime local を付けるか、シェル全体のランタイムを一度に設定します。
--local や、先頭に local を付ける方法でも指定できます。gologin-agent-browser local open https://example.com --profile your_profile_id
snapshot、click、close などのセッションコマンドは、local を指定しない限りクラウドランタイムに送られます。ローカルセッションを開いたあとは、続くすべてのコマンドに --runtime local を付けるか、GOLOGIN_AGENT_BROWSER_RUNTIME=local を設定してください。
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 ファイルです。
1 つのプロファイルで実行することも、多数のプロファイルで並列実行することもできます。
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