用途:在本地开发场景中,打开一个已用 Aircall staging 凭据认证的 agent-browser 实例,用于浏览 http://localhost:<PORT> 上的应用。
主要能力:获取 staging 认证令牌、通过 SSO 回调完成登录、对页面做交互快照、点击/填写元素、截图,并支持隔离会话与有头/无头模式。
使用方式:用户需提供 PORT(如 3000、5173)和 TARGET_PATH(如 /playground)。先运行 agent-browser --help 加载 CLI 参考;再按运行时获取令牌:Claude Code 调用 mcp__aircall-personal-tools__aircall_staging_auth_token,OpenCode 调用 AircallStagingAuthToken,返回含 accessToken 与 refreshToken 的 JSON。随后打开 SSO 回调:agent-browser --session aircall-local open "http://localhost:<PORT>/sso/callback?token=<ACCESS_TOKEN>&refresh_token=<REFRESH_TOKEN>&redirect=<TARGET_PATH>"。应用读取参数并本地存储后跳转到目标路径。之后用 agent-browser --session aircall-local snapshot -i 获取交互元素引用,再用 click @e1、fill @e2 "some text"、screenshot /tmp/screenshot.png 等操作,页面变化后需重新快照。
会话与模式:--session aircall-local 使用隔离上下文;agent-browser --session aircall-local close 关闭;agent-browser sessions 列出活动会话;默认无头,加 --headed 可显示窗口。
限制与排错:令牌过期需重新获取;页面不加载需确认本地服务端口并查看快照或截图;元素找不到需重新快照,可用 snapshot -i -c 获取更紧凑输出。SSO 路由为 /sso/callback,查询参数为 token、refresh_token、redirect,认证端点为 https://id.aircall-staging.com/auth/v1/users/session。其他平台或收费信息暂未提供。