agent-browser-automation by aradotso/trending-skills
npx skills add https://github.com/aradotso/trending-skills --skill agent-browser-automationSkill by ara.so — Daily 2026 Skills collection.
agent-browser 是一个用 Rust 构建的无头浏览器自动化 CLI,专为 AI 智能体设计。它通过 Chrome DevTools 协议 (CDP) 封装 Chrome,并提供了一个快速、符合人体工程学的命令行界面,用于导航、交互、无障碍快照、截图、网络拦截等——无需 Node.js 或 Playwright 运行时。
npm install -g agent-browser
agent-browser install # 下载 Chrome for Testing(仅首次需要)
brew install agent-browser
agent-browser install
cargo install agent-browser
agent-browser install
npm install agent-browser
# 添加到 package.json 的 scripts 中或通过 npx 调用
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
agent-browser install --with-deps
agent-browser open https://example.com
agent-browser snapshot # 带 @refs 的无障碍树(最适合 AI)
agent-browser click @e2 # 通过快照中的引用点击
agent-browser fill @e3 "hello@example.com" # 通过引用填充
agent-browser get text @e1 # 获取文本内容
agent-browser screenshot page.png
agent-browser close
agent-browser open <url> # 导航(别名:goto, navigate)
agent-browser get url # 获取当前 URL
agent-browser get title # 获取页面标题
agent-browser close # 关闭浏览器(别名:quit, exit)
agent-browser snapshot # 返回带有 @ref ID 的无障碍树
agent-browser snapshot -i # 交互式 / 紧凑模式
快照输出包含可以直接使用的 @eN 引用:
@e1 [button] "Submit"
@e2 [textbox] "Email" value=""
@e3 [link] "Sign in"
然后对它们进行操作:
agent-browser fill @e2 "user@example.com"
agent-browser click @e1
agent-browser click <sel> # 点击元素
agent-browser dblclick <sel> # 双击
agent-browser fill <sel> <text> # 清空并填充输入框
agent-browser type <sel> <text> # 向元素内输入文本
agent-browser press <key> # 按下按键(Enter, Tab, Control+a)
agent-browser keyboard type <text> # 在当前焦点处输入(真实按键)
agent-browser keyboard inserttext <text> # 插入文本(不触发按键事件)
agent-browser hover <sel> # 悬停元素
agent-browser select <sel> <value> # 选择下拉选项
agent-browser check <sel> # 勾选复选框
agent-browser uncheck <sel> # 取消勾选复选框
agent-browser scroll down 500 # 滚动(up/down/left/right,可选像素值)
agent-browser scroll down --selector "#feed" # 在元素内滚动
agent-browser scrollintoview <sel> # 将元素滚动到视图中
agent-browser drag <src> <target> # 拖放
agent-browser upload <sel> /path/file.pdf # 上传文件
agent-browser screenshot # 保存到临时目录,打印路径
agent-browser screenshot page.png # 保存到指定路径
agent-browser screenshot --full page.png # 全页面截图
agent-browser screenshot --annotate # 叠加带编号的元素标签
agent-browser screenshot --screenshot-dir ./shots # 自定义输出目录
agent-browser screenshot --screenshot-format jpeg --screenshot-quality 80
agent-browser pdf output.pdf # 将页面保存为 PDF
agent-browser get text <sel> # 文本内容
agent-browser get html <sel> # innerHTML
agent-browser get value <sel> # 输入框的值
agent-browser get attr <sel> <attr> # 属性值
agent-browser get count <sel> # 匹配元素的数量
agent-browser get box <sel> # 边界框
agent-browser get styles <sel> # 计算后的样式
agent-browser get cdp-url # CDP WebSocket URL
agent-browser is visible <sel>
agent-browser is enabled <sel>
agent-browser is checked <sel>
agent-browser find role button click --name "Submit"
agent-browser find text "Sign In" click
agent-browser find label "Email" fill "test@example.com"
agent-browser find placeholder "Search..." fill "rust"
agent-browser find testid "login-btn" click
agent-browser find first ".item" click
agent-browser find nth 2 "a" text
agent-browser find role textbox fill "hello" --name "Username"
操作: click, fill, type, hover, focus, check, uncheck, text
agent-browser wait "#modal" # 等待元素可见
agent-browser wait 2000 # 等待 N 毫秒
agent-browser wait --text "Welcome back" # 等待文本出现
agent-browser wait --url "**/dashboard" # 等待 URL 模式匹配
agent-browser wait --load networkidle # 等待加载状态
agent-browser wait --fn "window.appReady === true" # 等待 JS 条件满足
agent-browser wait "#spinner" --state hidden # 等待元素消失
加载状态: load, domcontentloaded, networkidle
agent-browser eval "document.title"
agent-browser eval "JSON.stringify(window.__STATE__)"
agent-browser eval -b "BASE64_ENCODED_JS"
echo "return document.body.innerHTML" | agent-browser eval --stdin
echo '[
["open", "https://example.com"],
["snapshot", "-i"],
["fill", "@e2", "user@example.com"],
["click", "@e1"],
["screenshot", "result.png"]
]' | agent-browser batch --json
# 首次失败即停止
agent-browser batch --bail < commands.json
agent-browser tab # 列出标签页
agent-browser tab new https://... # 新标签页打开 URL
agent-browser tab 2 # 切换到第 2 个标签页
agent-browser tab close # 关闭当前标签页
agent-browser frame "#my-iframe" # 切换到 iframe 内
agent-browser frame main # 返回到主框架
agent-browser cookies
agent-browser cookies set session_id "abc123"
agent-browser cookies clear
agent-browser storage local
agent-browser storage local set theme dark
agent-browser storage local clear
agent-browser storage session set cart '{"items":[]}'
agent-browser network route "**/api/users" --body '{"users":[]}' # 模拟响应
agent-browser network route "**/ads/**" --abort # 阻断请求
agent-browser network unroute # 移除所有路由
agent-browser network requests --filter api # 查看请求
agent-browser network har start
agent-browser network har stop recording.har
agent-browser set viewport 1280 800
agent-browser set viewport 375 812 2 # 带设备像素比(视网膜屏)
agent-browser set device "iPhone 14"
agent-browser set geo 37.7749 -122.4194
agent-browser set offline on
agent-browser set headers '{"X-Custom":"value"}'
agent-browser set credentials admin secret
agent-browser set media dark
agent-browser state save ./auth.json # 保存 cookies + localStorage
agent-browser state load ./auth.json # 恢复认证状态
agent-browser state list # 列出已保存的状态
agent-browser state show auth.json # 已保存状态的摘要
agent-browser dialog accept # 接受 alert/confirm/prompt
agent-browser dialog accept "My input" # 接受 prompt 并输入文本
agent-browser dialog dismiss
agent-browser clipboard read
agent-browser clipboard write "Hello, World!"
agent-browser clipboard copy # Ctrl+C 复制当前选中内容
agent-browser clipboard paste # Ctrl+V 粘贴
agent-browser diff snapshot # 与上一次快照对比
agent-browser diff snapshot --baseline before.txt # 与保存的文件对比
agent-browser diff snapshot --selector "#main" --compact
agent-browser diff screenshot --baseline before.png
agent-browser diff screenshot --baseline b.png -o diff.png
agent-browser diff url https://v1.example.com https://v2.example.com
agent-browser diff url https://v1.example.com https://v2.example.com --screenshot
agent-browser diff url https://v1.example.com https://v2.example.com --selector "#content"
agent-browser trace start trace.zip
agent-browser trace stop
agent-browser profiler start
agent-browser profiler stop profile.json
agent-browser console # 查看控制台消息
agent-browser errors # 查看未捕获的 JS 异常
agent-browser highlight "#button" # 视觉高亮元素
agent-browser inspect # 打开 Chrome DevTools
agent-browser connect 9222 # 通过 CDP 端口连接到已运行的浏览器
#!/bin/bash
agent-browser open https://app.example.com/login
agent-browser fill "#email" "$LOGIN_EMAIL"
agent-browser fill "#password" "$LOGIN_PASSWORD"
agent-browser click "[type=submit]"
agent-browser wait --url "**/dashboard"
agent-browser state save ./session.json
#!/bin/bash
agent-browser open https://app.example.com
agent-browser state load ./session.json
# 获取快照,解析 @refs,执行操作
SNAPSHOT=$(agent-browser snapshot)
echo "$SNAPSHOT"
# 智能体确定 @e5 是搜索框
agent-browser fill @e5 "quarterly report"
agent-browser press Enter
agent-browser wait --load networkidle
agent-browser snapshot
agent-browser screenshot results.png
cat > commands.json << 'EOF'
[
["open", "https://news.ycombinator.com"],
["wait", "--load", "networkidle"],
["get", "title"],
["snapshot"],
["screenshot", "hn.png"]
]
EOF
agent-browser batch --json < commands.json
agent-browser open https://api-heavy-app.example.com
agent-browser network route "**/api/slow-endpoint" --body '{"data":"mocked"}'
agent-browser snapshot
agent-browser network unroute
agent-browser open https://example.com
agent-browser wait --load networkidle
agent-browser screenshot --full --annotate annotated.png
# 启动 Chrome 并启用远程调试
google-chrome --remote-debugging-port=9222 &
agent-browser connect 9222
agent-browser open https://example.com
agent-browser snapshot
agent-browser set device "iPhone 14"
agent-browser open https://example.com
agent-browser screenshot mobile.png
agent-browser open https://example.com
agent-browser network har start
agent-browser click "#load-data"
agent-browser wait --load networkidle
agent-browser network har stop session.har
| 格式 | 示例 | 说明 |
|---|---|---|
@ref | @e1, @e12 | 来自 snapshot 输出 — AI 首选 |
| CSS | #id, .class, [attr=val] | 标准 CSS 选择器 |
| 文本 | "Sign In" | 精确文本匹配 |
| XPath | //button[@type='submit'] | 完整 XPath |
agent-browser install # 下载 Chrome for Testing
agent-browser install --with-deps # Linux:同时安装系统库
agent-browser wait "#my-element" # 先等待元素可见
agent-browser wait --load networkidle # 等待页面稳定
agent-browser wait --fn "!!document.querySelector('#app')"
# 替代脆弱的 CSS:
agent-browser click ".btn.btn-primary.submit-form"
# 使用快照引用:
agent-browser snapshot # 找到 @e7 = [button] "Submit"
agent-browser click @e7
agent-browser screenshot debug.png # 视觉检查
agent-browser snapshot # 无障碍树
agent-browser console # JS 控制台输出
agent-browser errors # 未捕获的异常
agent-browser eval "document.readyState"
agent-browser state save ./auth.json # 成功登录后
agent-browser state load ./auth.json # 下次会话开始时
# 在触发对话框的操作之前设置处理程序
agent-browser dialog accept
agent-browser click "#delete-button"
# 慢:每个命令一个进程
agent-browser open https://example.com
agent-browser fill "#q" "search"
agent-browser click "#submit"
# 快:单个进程,多个命令
echo '[["open","https://example.com"],["fill","#q","search"],["click","#submit"]]' \
| agent-browser batch --json
每周安装量
321
代码仓库
GitHub Stars
10
首次出现
7 天前
安全审计
已安装于
opencode320
gemini-cli320
github-copilot320
amp320
cline320
codex320
Skill by ara.so — Daily 2026 Skills collection.
agent-browser is a headless browser automation CLI built in Rust, designed for AI agents. It wraps Chrome via the Chrome DevTools Protocol (CDP) and exposes a fast, ergonomic command-line interface for navigation, interaction, accessibility snapshots, screenshots, network interception, and more — with no Node.js or Playwright runtime required.
npm install -g agent-browser
agent-browser install # Download Chrome for Testing (first time only)
brew install agent-browser
agent-browser install
cargo install agent-browser
agent-browser install
npm install agent-browser
# Add to package.json scripts or invoke via npx
agent-browser install --with-deps
agent-browser open https://example.com
agent-browser snapshot # Accessibility tree with @refs (best for AI)
agent-browser click @e2 # Click by ref from snapshot
agent-browser fill @e3 "hello@example.com" # Fill by ref
agent-browser get text @e1 # Get text content
agent-browser screenshot page.png
agent-browser close
agent-browser open <url> # Navigate (aliases: goto, navigate)
agent-browser get url # Get current URL
agent-browser get title # Get page title
agent-browser close # Close browser (aliases: quit, exit)
agent-browser snapshot # Returns accessibility tree with @ref IDs
agent-browser snapshot -i # Interactive / compact mode
Snapshot output includes @eN refs you can use directly:
@e1 [button] "Submit"
@e2 [textbox] "Email" value=""
@e3 [link] "Sign in"
Then act on them:
agent-browser fill @e2 "user@example.com"
agent-browser click @e1
agent-browser click <sel> # Click element
agent-browser dblclick <sel> # Double-click
agent-browser fill <sel> <text> # Clear and fill input
agent-browser type <sel> <text> # Type into element
agent-browser press <key> # Press key (Enter, Tab, Control+a)
agent-browser keyboard type <text> # Type at current focus (real keystrokes)
agent-browser keyboard inserttext <text> # Insert text without key events
agent-browser hover <sel> # Hover element
agent-browser select <sel> <value> # Select dropdown option
agent-browser check <sel> # Check checkbox
agent-browser uncheck <sel> # Uncheck checkbox
agent-browser scroll down 500 # Scroll (up/down/left/right, optional px)
agent-browser scroll down --selector "#feed" # Scroll within element
agent-browser scrollintoview <sel> # Scroll element into view
agent-browser drag <src> <target> # Drag and drop
agent-browser upload <sel> /path/file.pdf # Upload file
agent-browser screenshot # Save to temp dir, print path
agent-browser screenshot page.png # Save to path
agent-browser screenshot --full page.png # Full-page screenshot
agent-browser screenshot --annotate # Numbered element labels overlay
agent-browser screenshot --screenshot-dir ./shots # Custom output directory
agent-browser screenshot --screenshot-format jpeg --screenshot-quality 80
agent-browser pdf output.pdf # Save page as PDF
agent-browser get text <sel> # Text content
agent-browser get html <sel> # innerHTML
agent-browser get value <sel> # Input value
agent-browser get attr <sel> <attr> # Attribute value
agent-browser get count <sel> # Count matching elements
agent-browser get box <sel> # Bounding box
agent-browser get styles <sel> # Computed styles
agent-browser get cdp-url # CDP WebSocket URL
agent-browser is visible <sel>
agent-browser is enabled <sel>
agent-browser is checked <sel>
agent-browser find role button click --name "Submit"
agent-browser find text "Sign In" click
agent-browser find label "Email" fill "test@example.com"
agent-browser find placeholder "Search..." fill "rust"
agent-browser find testid "login-btn" click
agent-browser find first ".item" click
agent-browser find nth 2 "a" text
agent-browser find role textbox fill "hello" --name "Username"
Actions: click, fill, type, hover, focus, check, uncheck, text
agent-browser wait "#modal" # Wait for element visible
agent-browser wait 2000 # Wait N milliseconds
agent-browser wait --text "Welcome back" # Wait for text
agent-browser wait --url "**/dashboard" # Wait for URL pattern
agent-browser wait --load networkidle # Wait for load state
agent-browser wait --fn "window.appReady === true" # Wait for JS condition
agent-browser wait "#spinner" --state hidden # Wait for element to disappear
Load states: load, domcontentloaded, networkidle
agent-browser eval "document.title"
agent-browser eval "JSON.stringify(window.__STATE__)"
agent-browser eval -b "BASE64_ENCODED_JS"
echo "return document.body.innerHTML" | agent-browser eval --stdin
echo '[
["open", "https://example.com"],
["snapshot", "-i"],
["fill", "@e2", "user@example.com"],
["click", "@e1"],
["screenshot", "result.png"]
]' | agent-browser batch --json
# Stop on first failure
agent-browser batch --bail < commands.json
agent-browser tab # List tabs
agent-browser tab new https://... # New tab with URL
agent-browser tab 2 # Switch to tab 2
agent-browser tab close # Close current tab
agent-browser frame "#my-iframe" # Switch into iframe
agent-browser frame main # Return to main frame
agent-browser cookies
agent-browser cookies set session_id "abc123"
agent-browser cookies clear
agent-browser storage local
agent-browser storage local set theme dark
agent-browser storage local clear
agent-browser storage session set cart '{"items":[]}'
agent-browser network route "**/api/users" --body '{"users":[]}' # Mock response
agent-browser network route "**/ads/**" --abort # Block requests
agent-browser network unroute # Remove all routes
agent-browser network requests --filter api # View requests
agent-browser network har start
agent-browser network har stop recording.har
agent-browser set viewport 1280 800
agent-browser set viewport 375 812 2 # With device pixel ratio (retina)
agent-browser set device "iPhone 14"
agent-browser set geo 37.7749 -122.4194
agent-browser set offline on
agent-browser set headers '{"X-Custom":"value"}'
agent-browser set credentials admin secret
agent-browser set media dark
agent-browser state save ./auth.json # Save cookies + localStorage
agent-browser state load ./auth.json # Restore auth state
agent-browser state list # List saved states
agent-browser state show auth.json # Summary of saved state
agent-browser dialog accept # Accept alert/confirm/prompt
agent-browser dialog accept "My input" # Accept prompt with text
agent-browser dialog dismiss
agent-browser clipboard read
agent-browser clipboard write "Hello, World!"
agent-browser clipboard copy # Ctrl+C current selection
agent-browser clipboard paste # Ctrl+V
agent-browser diff snapshot # vs last snapshot
agent-browser diff snapshot --baseline before.txt # vs saved file
agent-browser diff snapshot --selector "#main" --compact
agent-browser diff screenshot --baseline before.png
agent-browser diff screenshot --baseline b.png -o diff.png
agent-browser diff url https://v1.example.com https://v2.example.com
agent-browser diff url https://v1.example.com https://v2.example.com --screenshot
agent-browser diff url https://v1.example.com https://v2.example.com --selector "#content"
agent-browser trace start trace.zip
agent-browser trace stop
agent-browser profiler start
agent-browser profiler stop profile.json
agent-browser console # View console messages
agent-browser errors # View uncaught JS exceptions
agent-browser highlight "#button" # Visually highlight element
agent-browser inspect # Open Chrome DevTools
agent-browser connect 9222 # Connect to existing browser via CDP port
#!/bin/bash
agent-browser open https://app.example.com/login
agent-browser fill "#email" "$LOGIN_EMAIL"
agent-browser fill "#password" "$LOGIN_PASSWORD"
agent-browser click "[type=submit]"
agent-browser wait --url "**/dashboard"
agent-browser state save ./session.json
#!/bin/bash
agent-browser open https://app.example.com
agent-browser state load ./session.json
# Get snapshot, parse @refs, act
SNAPSHOT=$(agent-browser snapshot)
echo "$SNAPSHOT"
# Agent determines @e5 is the search box
agent-browser fill @e5 "quarterly report"
agent-browser press Enter
agent-browser wait --load networkidle
agent-browser snapshot
agent-browser screenshot results.png
cat > commands.json << 'EOF'
[
["open", "https://news.ycombinator.com"],
["wait", "--load", "networkidle"],
["get", "title"],
["snapshot"],
["screenshot", "hn.png"]
]
EOF
agent-browser batch --json < commands.json
agent-browser open https://api-heavy-app.example.com
agent-browser network route "**/api/slow-endpoint" --body '{"data":"mocked"}'
agent-browser snapshot
agent-browser network unroute
agent-browser open https://example.com
agent-browser wait --load networkidle
agent-browser screenshot --full --annotate annotated.png
# Start Chrome with remote debugging
google-chrome --remote-debugging-port=9222 &
agent-browser connect 9222
agent-browser open https://example.com
agent-browser snapshot
agent-browser set device "iPhone 14"
agent-browser open https://example.com
agent-browser screenshot mobile.png
agent-browser open https://example.com
agent-browser network har start
agent-browser click "#load-data"
agent-browser wait --load networkidle
agent-browser network har stop session.har
| Format | Example | Notes |
|---|---|---|
@ref | @e1, @e12 | From snapshot output — preferred for AI |
| CSS | #id, .class, [attr=val] | Standard CSS selectors |
| Text | "Sign In" |
agent-browser install # Downloads Chrome for Testing
agent-browser install --with-deps # Linux: also installs system libs
agent-browser wait "#my-element" # Wait for visibility first
agent-browser wait --load networkidle # Wait for page to settle
agent-browser wait --fn "!!document.querySelector('#app')"
# Instead of fragile CSS:
agent-browser click ".btn.btn-primary.submit-form"
# Use snapshot refs:
agent-browser snapshot # Find @e7 = [button] "Submit"
agent-browser click @e7
agent-browser screenshot debug.png # Visual check
agent-browser snapshot # Accessibility tree
agent-browser console # JS console output
agent-browser errors # Uncaught exceptions
agent-browser eval "document.readyState"
agent-browser state save ./auth.json # After successful login
agent-browser state load ./auth.json # At start of next session
# Set up handler BEFORE the action that triggers dialog
agent-browser dialog accept
agent-browser click "#delete-button"
# Slow: one process per command
agent-browser open https://example.com
agent-browser fill "#q" "search"
agent-browser click "#submit"
# Fast: single process, multiple commands
echo '[["open","https://example.com"],["fill","#q","search"],["click","#submit"]]' \
| agent-browser batch --json
Weekly Installs
321
Repository
GitHub Stars
10
First Seen
7 days ago
Security Audits
Gen Agent Trust HubWarnSocketPassSnykWarn
Installed on
opencode320
gemini-cli320
github-copilot320
amp320
cline320
codex320
Skills CLI 使用指南:AI Agent 技能包管理器安装与管理教程
19,000 周安装
| Exact text match |
| XPath | //button[@type='submit'] | Full XPath |