跳转到主要内容
Gologin Agent Browser CLI 将 Gologin 浏览器配置文件变成可供 AI 智能体使用的持久化、可脚本化运行环境。会话可以在 Gologin Cloud Browser 中运行,也可以在你自己机器上的 Orbita 中运行。它提供精简的页面快照、基于引用的交互、会话记忆,以及便于在 shell 中处理的输出。 与从零开始编写 Puppeteer/Playwright 代码不同,这个 CLI 为智能体提供了现成的浏览器自动化命令集,无需样板代码,也无需编写会话管理代码。

云端或本地运行环境

CLI 有两种运行环境,命令完全相同。两者都使用 Gologin 配置文件、指纹和代理,并且由守护进程在多次 CLI 调用之间保持会话存活。 可以通过 --runtime cloud|local|auto 为每条命令选择运行环境,也可以一次性设置 GOLOGIN_AGENT_BROWSER_RUNTIME:
默认情况下(auto),配置文件、runbook 和任务相关命令在本地运行,其余命令在云端运行。打开本地会话后,后续命令也需要传入 --runtime local。有关要求和仅限本地的命令,请参阅本地运行环境。

安装

或者无需全局安装直接运行:
需要 Node.js >= 18。本地运行环境需要 Node.js 20 或更高版本。

凭据

获取令牌

  1. 在 gologin.com 注册或登录
  2. 在控制台中打开 API & MCP
  3. 打开 API 标签页
  4. 点击 新代币
  5. 复制生成的访问令牌

配置文件

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

架构

由两部分组成:
  1. gologin-agent-browser CLI:解析命令、选择运行环境、自动启动对应的守护进程,并输出精简结果
  2. 持久化本地守护进程(每种运行环境一个):持有运行中的浏览器会话,通过 Playwright connectOverCDP 连接到 Gologin Cloud Browser 或本地 Orbita,在内存中保留当前活动页面,生成快照、解析引用,并跟踪会话元数据
传输仅限本地。云端守护进程监听:
  • 位于 ${TMPDIR:-/tmp}/gologin-agent-browser.sock 的 Unix 套接字
  • 位于 127.0.0.1:${GOLOGIN_DAEMON_PORT:-44777} 的本地主机 HTTP
在云端运行环境中,如果你没有提供配置文件 ID,守护进程会通过 API 创建一个临时的 Gologin 云端配置文件。

引用的工作方式

snapshot 会输出精简的页面视图,并为可交互元素分配 @e1、@e2、@e3 这样的引用。你可以直接对它们进行操作:
引用只是尽力而为,在页面跳转或 DOM 发生较大变化后应重新生成。命令也接受 CSS 选择器来代替引用。在动态页面上,find 通常比过期的引用更可靠:它会在实时页面上定位元素,并一步完成操作。

快速开始


智能体循环示例

典型的 AI 智能体循环:

完整命令参考

诊断

会话管理

页面读取

交互

键盘与滚动

导航

标签页

高级

配置文件、代理和 Gologin API

这些命令使用你的令牌调用 Gologin API,不需要浏览器守护进程。
在任意命令后添加 --help 可输出其用法。

仅限本地运行环境

profiles、profile、profile-create、profile-update、profile-import、profile-sync、profile-delete、run、batch、jobs 和 job 用于管理本地配置文件、runbook 和任务历史。请参阅本地运行环境。

别名


使用场景与示例

检查你的网站能否通过反检测测试

登录网页应用并提取仪表板数据

填写多步骤表单

截取竞争对手页面的截图

在屏蔽抓取的网站上搜索

有些网站需要先执行 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