Agent Browser Cli.Bak — 代理 Browser 命令行工具.Bak

代理 Browser

Vercel 出品的浏览器自动化 命令行工具，基于 Playwright，比标准浏览器工具更快更灵活。

快速开始 代理-browser open # 打开网页 代理-browser snapshot # 获取页面可访问性树 代理-browser 命令行工具ck @ # 点击元素（用ref引用） 代理-browser fill @ "内容" # 填入内容 代理-browser close # 关闭浏览器

常用命令 导航 代理-browser open # 打开URL（别名：goto, navigate） 代理-browser back # 后退 代理-browser forward # 前进 代理-browser reload # 刷新

交互 代理-browser 命令行工具ck # 点击 代理-browser dbl命令行工具ck # 双击 代理-browser fill "text" # 填入（清空后填） 代理-browser type "text" # 输入（追加） 代理-browser select # 选择下拉选项 代理-browser 检查 # 勾选复选框 代理-browser un检查 # 取消勾选 代理-browser press # 按键（Enter, Tab, Escape等）

获取信息 代理-browser snapshot # 获取可访问性树（推荐） 代理-browser 获取 text # 获取文本 代理-browser 获取 html # 获取HTML 代理-browser 获取 value # 获取输入值 代理-browser 获取 title # 获取页面标题 代理-browser 获取 url # 获取当前URL 代理-browser screenshot [path] # 截图 代理-browser screenshot --annotate # 带标注的截图

元素定位

通过 snapshot 输出的 ref（如 @e14）直接引用：

代理-browser 命令行工具ck @e14 代理-browser fill @e13 "hello"

或使用 CSS 选择器：

代理-browser 命令行工具ck "#submit" 代理-browser fill "输入[name='emAIl']" "test@test.com"

或使用 ARIA 角色查找：

代理-browser find 角色 button 命令行工具ck --name "Submit" 代理-browser find text "签名 In" 命令行工具ck 代理-browser find label "EmAIl" fill "test@test.com" 代理-browser find placeholder "搜索" type "查询"

典型工作流

• 签到任务

# 获取页面结构 代理-browser snapshot

# 点击登录/签到按钮（用实际ref替换 @eXX） 代理-browser 命令行工具ck @eXX

# 等待页面加载 sleep 2 代理-browser snapshot

• 填表任务

# 填入各字段 代理-browser find label "用户名" fill "myuser" 代理-browser find label "密码" fill "mypassword" 代理-browser find 角色 button 命令行工具ck --name "提交"

• 定时签到（配合cron）

创建脚本 ~/.OpenClaw/scripts/dAIly-检查in.sh：

#!/bin/bash 代理-browser open <签到URL> sleep 2 代理-browser find 角色 button 命令行工具ck --name "签到" 代理-browser screenshot /tmp/检查in_$(date +%Y%m%d).png 代理-browser close

注意事项 先 snapshot 再操作 - 每次页面变化后重新获取 ref 添加等待 - 页面加载需要时间，用 sleep 2 或等待 保持浏览器开启 - 多个操作可以在同一浏览器会话中完成 完成后关闭 - 用 代理-browser close 释放资源 依赖安装

如果 代理-browser 未安装：

npm 安装 -g 代理-browser 代理-browser 安装