クラウドランタイムとローカルランタイム
CLI には、同じコマンドで使える 2 つのランタイムがあります。どちらも Gologin のプロファイル、フィンガープリント、プロキシを使用し、デーモンが CLI の呼び出しをまたいでセッションを維持します。
ランタイムはコマンドごとに
--runtime cloud|local|auto で選択できます。または GOLOGIN_AGENT_BROWSER_RUNTIME を一度設定してください。
auto)では、プロファイル、ランブック、ジョブのコマンドはローカルで実行され、それ以外はクラウドで実行されます。ローカルセッションを開いた後は、続くコマンドにも --runtime local を指定してください。要件とローカル専用コマンドについては、ローカルランタイムをご覧ください。
インストール
認証情報
トークンを取得する
- gologin.com でサインアップまたはログインします
- ダッシュボードで API & MCP を開きます
- API タブを開きます
- 新しいトークン をクリックします
- 生成されたアクセストークンをコピーします
設定ファイル
~/.gologin-agent-browser/config.json
アーキテクチャ
次の 2 つの部分で構成されています。gologin-agent-browserCLI — コマンドを解析し、ランタイムを選択し、対応するデーモンを自動起動して、コンパクトな出力を表示します- 常駐ローカルデーモン(ランタイムごとに 1 つ) — 稼働中のブラウザセッションを管理し、Playwright の
connectOverCDPを通じて Gologin Cloud Browser またはローカルの Orbita に接続します。アクティブなページをメモリ上に保持し、スナップショットの作成、ref の解決、セッションメタデータの追跡を行います
${TMPDIR:-/tmp}/gologin-agent-browser.sockの Unix ソケット127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777}のローカルホスト HTTP
ref の仕組み
snapshot はコンパクトなページビューを出力し、操作可能な要素に @e1、@e2、@e3 のような ref を割り当てます。これらを直接指定して操作します。
find を代替手段として使うほうが適していることが多くあります。find は実際のページ上で要素を探し、そのまま 1 ステップで操作します。
クイックスタート
エージェントループの例
一般的な AI エージェントのループは次のとおりです。コマンドリファレンス(全一覧)
診断
セッション管理
ページの読み取り
操作
キーボードとスクロール
ナビゲーション
タブ
Cookie とストレージ
高度なコマンド
プロファイル、プロキシ、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を受け付けます
関連情報
- Gologin Web Access CLI — 統合 CLI(スクレイピング + ブラウザ)
- ローカルランタイム — この CLI でローカルの Orbita プロファイルを実行します
- Cloud Browser はじめに — Puppeteer/Playwright の例
- AI Skills — Claude Code 向けのすぐに使えるスキル
npm パッケージ
gologin-agent-browser-cli
ソースコード
GologinLabs/agent-browser