メインコンテンツへスキップ
Gologin Agent Browser CLI は、Gologin のブラウザプロファイルを、AI エージェント向けの永続的でスクリプト化しやすい実行環境に変えます。セッションは Gologin Cloud Browser、またはお使いのマシン上の Orbita で実行されます。コンパクトなページスナップショット、ref ベースの操作、セッションメモリ、シェルで扱いやすい出力を提供します。 Puppeteer/Playwright のコードをゼロから書く場合と違い、この CLI はブラウザ自動化のためのコマンド群をあらかじめ用意しています。定型コードやセッション管理のコードは不要です。

クラウドランタイムとローカルランタイム

CLI には、同じコマンドで使える 2 つのランタイムがあります。どちらも Gologin のプロファイル、フィンガープリント、プロキシを使用し、デーモンが CLI の呼び出しをまたいでセッションを維持します。 ランタイムはコマンドごとに --runtime cloud|local|auto で選択できます。または GOLOGIN_AGENT_BROWSER_RUNTIME を一度設定してください。
デフォルト(auto)では、プロファイル、ランブック、ジョブのコマンドはローカルで実行され、それ以外はクラウドで実行されます。ローカルセッションを開いた後は、続くコマンドにも --runtime local を指定してください。要件とローカル専用コマンドについては、ローカルランタイムをご覧ください。

インストール

グローバルインストールなしで実行することもできます。
Node.js 18 以上が必要です。ローカルランタイムには Node.js 20 以降が必要です。

認証情報

トークンを取得する

  1. gologin.com でサインアップまたはログインします
  2. ダッシュボードで API & MCP を開きます
  3. API タブを開きます
  4. 新しいトークン をクリックします
  5. 生成されたアクセストークンをコピーします

設定ファイル

~/.gologin-agent-browser/config.json

アーキテクチャ

次の 2 つの部分で構成されています。
  1. gologin-agent-browser CLI — コマンドを解析し、ランタイムを選択し、対応するデーモンを自動起動して、コンパクトな出力を表示します
  2. 常駐ローカルデーモン(ランタイムごとに 1 つ) — 稼働中のブラウザセッションを管理し、Playwright の connectOverCDP を通じて Gologin Cloud Browser またはローカルの Orbita に接続します。アクティブなページをメモリ上に保持し、スナップショットの作成、ref の解決、セッションメタデータの追跡を行います
通信はローカルのみです。クラウドデーモンは次の場所で待ち受けます。
  • ${TMPDIR:-/tmp}/gologin-agent-browser.sock の Unix ソケット
  • 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777} のローカルホスト HTTP
クラウドランタイムでプロファイル ID を指定しない場合、デーモンは API を通じて一時的な Gologin クラウドプロファイルを作成します。

ref の仕組み

snapshot はコンパクトなページビューを出力し、操作可能な要素に @e1、@e2、@e3 のような ref を割り当てます。これらを直接指定して操作します。
ref はベストエフォートで割り当てられるため、ページ遷移や DOM の大きな変更の後は再生成してください。コマンドでは ref の代わりに CSS セレクタも使用できます。動的なページでは、古くなった ref よりも find を代替手段として使うほうが適していることが多くあります。find は実際のページ上で要素を探し、そのまま 1 ステップで操作します。

クイックスタート


エージェントループの例

一般的な AI エージェントのループは次のとおりです。

コマンドリファレンス(全一覧)

診断

セッション管理

ページの読み取り

操作

キーボードとスクロール

ナビゲーション

タブ

高度なコマンド

プロファイル、プロキシ、Gologin API

これらのコマンドは、お使いのトークンで Gologin API を呼び出すため、ブラウザデーモンは不要です。
任意のコマンドに --help を付けると、その使い方が表示されます。

ローカルランタイム専用

profiles、profile、profile-create、profile-update、profile-import、profile-sync、profile-delete、run、batch、jobs、job は、ローカルのプロファイル、ランブック、ジョブ履歴を管理します。ローカルランタイムをご覧ください。

エイリアス


ユースケースと例

サイトがアンチディテクトのテストに合格するか確認する

Web アプリにログインしてダッシュボードのデータを取得する

複数ステップのフォームに入力する

競合他社のページのスクリーンショットを撮る

スクレイピングをブロックするサイトで検索する

サイトによっては、結果を表示する前に JavaScript の実行、ログイン、または操作が必要です。そのような場合は、ブラウザを使って検索します。

セッション状態を保存して復元する

Cookie とストレージをエクスポートして、別のセッションで再利用できます。

並列セッション

独立したクラウドタスクには、明示的な --session ID を使用します。後片付けには close --all または sessions --prune --older-than-ms を使います。

プロキシのルール

  • 事前設定済みのプロファイル: プロキシは Gologin のダッシュボードまたは API でプロファイルに設定します(例: proxy add-gologin <profileId> --country us)
  • 一時的なクラウドプロファイル: プロキシなし、または --proxy-host と --proxy-port で指定した独自のプロキシ(--proxy-mode http|socks4|socks5、--proxy-user、--proxy-pass も併用できます)
  • クラウドランタイムでは、open は --proxy-country を受け付けません。特定の国の Gologin プロキシのトラフィックを使うには、プロファイルに Gologin プロキシを追加し、--profile を指定してそのプロファイルを開いてください
  • ローカルランタイムでは、open、profile-create、profile-update が --proxy-country を受け付けます

関連情報

npm パッケージ

gologin-agent-browser-cli

ソースコード

GologinLabs/agent-browser