agent-browser

选择器#

Ref（推荐）#

Refs 可以从快照中进行确定性的元素选择，最适合 AI 代理。

bash
# 1. 获取带 refs 的快照
agent-browser snapshot
# Output:
# - heading "Example Domain" [ref=e1] [level=1]
# - button "Submit" [ref=e2]
# - textbox "Email" [ref=e3]
# - link "Learn more" [ref=e4]

# 2. 使用 refs 交互
agent-browser click @e2                   # 点击按钮
agent-browser fill @e3 "test@example.com" # 填充文本框
agent-browser get text @e1                # 获取标题文本
agent-browser hover @e4                   # 悬停链接

为什么用 ref？#

  • 确定性 - Ref 指向快照中的精确元素
  • 快速 - 无需重新查询 DOM
  • 适合 AI - LLM 可以可靠地解析并使用 refs

CSS 选择器#

bash
agent-browser click "#id"
agent-browser click ".class"
agent-browser click "div > button"
agent-browser click "[data-testid='submit']"

文本与 XPath#

bash
agent-browser click "text=Submit"
agent-browser click "xpath=//button[@type='submit']"

语义定位器#

按 role、label 或其他语义属性查找元素：

bash
agent-browser find role button click --name "Submit"
agent-browser find label "Email" fill "test@test.com"
agent-browser find placeholder "Search..." fill "query"
agent-browser find testid "submit-btn" click