{"skill":{"slug":"agent-browser-cli","displayName":"Agent Browser CLI","summary":"使用 agent-browser CLI 进行浏览器自动化。用于签到、填表、截图、信息抓取等需要控制浏览器的任务。触发条件：(1) 用户要求自动化浏览器操作 (2) 需要签到、填表、点击按钮 (3) 需要抓取网页内容作为研究素材","description":"---\nname: agent-browser\ndescription: 使用 agent-browser CLI 进行浏览器自动化。用于签到、填表、截图、信息抓取等需要控制浏览器的任务。触发条件：(1) 用户要求自动化浏览器操作 (2) 需要签到、填表、点击按钮 (3) 需要抓取网页内容作为研究素材\n---\n\n# Agent Browser\n\nVercel 出品的浏览器自动化 CLI，基于 Playwright，比标准浏览器工具更快更灵活。\n\n## 快速开始\n\n```bash\nagent-browser open <url>     # 打开网页\nagent-browser snapshot       # 获取页面可访问性树\nagent-browser click @<ref>   # 点击元素（用ref引用）\nagent-browser fill @<ref> \"内容\"  # 填入内容\nagent-browser close         # 关闭浏览器\n```\n\n## 常用命令\n\n### 导航\n```bash\nagent-browser open <url>      # 打开URL（别名：goto, navigate）\nagent-browser back            # 后退\nagent-browser forward         # 前进\nagent-browser reload          # 刷新\n```\n\n### 交互\n```bash\nagent-browser click <sel>                    # 点击\nagent-browser dblclick <sel>                  # 双击\nagent-browser fill <sel> \"text\"               # 填入（清空后填）\nagent-browser type <sel> \"text\"               # 输入（追加）\nagent-browser select <sel> <value>             # 选择下拉选项\nagent-browser check <sel>                      # 勾选复选框\nagent-browser uncheck <sel>                   # 取消勾选\nagent-browser press <key>                      # 按键（Enter, Tab, Escape等）\n```\n\n### 获取信息\n```bash\nagent-browser snapshot              # 获取可访问性树（推荐）\nagent-browser get text <sel>        # 获取文本\nagent-browser get html <sel>        # 获取HTML\nagent-browser get value <sel>       # 获取输入值\nagent-browser get title             # 获取页面标题\nagent-browser get url               # 获取当前URL\nagent-browser screenshot [path]     # 截图\nagent-browser screenshot --annotate  # 带标注的截图\n```\n\n### 元素定位\n\n通过 snapshot 输出的 ref（如 @e14）直接引用：\n```bash\nagent-browser click @e14\nagent-browser fill @e13 \"hello\"\n```\n\n或使用 CSS 选择器：\n```bash\nagent-browser click \"#submit\"\nagent-browser fill \"input[name='email']\" \"test@test.com\"\n```\n\n或使用 ARIA 角色查找：\n```bash\nagent-browser find role button click --name \"Submit\"\nagent-browser find text \"Sign In\" click\nagent-browser find label \"Email\" fill \"test@test.com\"\nagent-browser find placeholder \"Search\" type \"query\"\n```\n\n## 典型工作流\n\n### 1. 签到任务\n```bash\n# 打开登录页\nagent-browser open <签到页面URL>\n\n# 获取页面结构\nagent-browser snapshot\n\n# 点击登录/签到按钮（用实际ref替换 @eXX）\nagent-browser click @eXX\n\n# 等待页面加载\nsleep 2\nagent-browser snapshot\n```\n\n### 2. 填表任务\n```bash\nagent-browser open <表单URL>\nagent-browser snapshot\n\n# 填入各字段\nagent-browser find label \"用户名\" fill \"myuser\"\nagent-browser find label \"密码\" fill \"mypassword\"\nagent-browser find role button click --name \"提交\"\n```\n\n### 3. 定时签到（配合cron）\n创建脚本 `~/.openclaw/scripts/daily-checkin.sh`：\n```bash\n#!/bin/bash\nagent-browser open <签到URL>\nsleep 2\nagent-browser find role button click --name \"签到\"\nagent-browser screenshot /tmp/checkin_$(date +%Y%m%d).png\nagent-browser close\n```\n\n## 注意事项\n\n1. **先 snapshot 再操作** - 每次页面变化后重新获取 ref\n2. **添加等待** - 页面加载需要时间，用 `sleep 2` 或等待\n3. **保持浏览器开启** - 多个操作可以在同一浏览器会话中完成\n4. **完成后关闭** - 用 `agent-browser close` 释放资源\n\n## 依赖安装\n\n如果 agent-browser 未安装：\n```bash\nnpm install -g agent-browser\nagent-browser install\n```\n","topics":["Browser","浏览器自动化"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":6320,"installsAllTime":199,"installsCurrent":35,"stars":2,"versions":1},"createdAt":1772411662105,"updatedAt":1778994362345},"latestVersion":{"version":"1.0.0","createdAt":1772411662105,"changelog":"Vercel agent-browser CLI wrapper for OpenClaw - browser automation for checkins, forms, screenshots","license":null},"metadata":null,"owner":{"handle":"joshhuang123","userId":"s17ehgt7v41r5bkr3z5qq85ea5884rh4","displayName":"Joshhuang123","image":"https://avatars.githubusercontent.com/u/209654952?v=4"},"moderation":null}