用途
core-agent-browser 是 agent-browser CLI 工作流的内置支持技能,被 rust-learner、docs-researcher 和 crate-researcher 使用。它的作用是在需要通过命令行进行浏览器自动化时提供统一的操作方式。
优先级与适用条件
资料给出了获取 Rust/crate 信息时的优先级顺序:
- rust-learner 技能 —— 负责编排 actionbook + browser-fetcher
- actionbook MCP —— 为已知站点提供预计算选择器
- agent-browser CLI —— 直接浏览器自动化(最后手段)
只有在以下情况才直接使用 agent-browser:
- actionbook 没有目标站点的预计算选择器
- 需要交互式浏览器测试/自动化
- 需要截图或填写表单
主要能力
该技能覆盖以下命令类别:
导航
agent-browser open <url> # Navigate to URL
agent-browser back # Go back
agent-browser forward # Go forward
agent-browser reload # Reload page
agent-browser close # Close browser
快照(页面分析)
agent-browser snapshot # Full accessibility tree
agent-browser snapshot -i # Interactive elements only (recommended)
agent-browser snapshot -c # Compact output
agent-browser snapshot -d 3 # Limit depth to 3
交互(使用快照中的 @refs)
agent-browser click @e1 # Click
agent-browser dblclick @e1 # Double-click
agent-browser fill @e2 "text" # Clear and type
agent-browser type @e2 "text" # Type without clearing
agent-browser press Enter # Press key
agent-browser press Control+a # Key combination
agent-browser hover @e1 # Hover
agent-browser check @e1 # Check checkbox
agent-browser uncheck @e1 # Uncheck checkbox
agent-browser select @e1 "value" # Select dropdown
agent-browser scroll down 500 # Scroll page
agent-browser scrollintoview @e1 # Scroll element into view
获取信息
agent-browser get text @e1 # Get element text
agent-browser get value @e1 # Get input value
agent-browser get title # Get page title
agent-browser get url # Get current URL
截图
agent-browser screenshot # Screenshot to stdout
agent-browser screenshot path.png # Save to file
agent-browser screenshot --full # Full page
等待
agent-browser wait @e1 # Wait for element
agent-browser wait 2000 # Wait milliseconds
agent-browser wait --text "Success" # Wait for text
agent-browser wait --load networkidle # Wait for network idle
语义定位器(作为 refs 的替代)
agent-browser find role button click --name "Submit"
agent-browser find text "Sign In" click
agent-browser find label "Email" fill "user@test.com"
使用方式
快速开始示例:
agent-browser open <url> # Navigate to page
agent-browser snapshot -i # Get interactive elements with refs
agent-browser click @e1 # Click element by ref
agent-browser fill @e2 "text" # Fill input by ref
agent-browser close # Close browser
核心工作流:
- 导航:agent-browser open <url>
- 快照:agent-browser snapshot -i(返回带 refs 的元素,如 @e1、@e2)
- 使用快照中的 refs 进行交互
- 在导航或发生显著 DOM 变化后重新快照
表单提交示例
agent-browser open https://example.com/form
agent-browser snapshot -i
# Output shows: textbox "Email" [ref=e1], textbox "Password" [ref=e2], button "Submit" [ref=e3]
agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "password123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i # Check result
适用场景
- 作为 rust-learner、docs-researcher、crate-researcher 的内置支持,在需要浏览器自动化时使用
- actionbook 缺少目标站点预计算选择器时的备选方案
- 需要进行交互式浏览器测试/自动化
- 需要截图或填写表单
限制
资料中未提供关于收费、价格、平台支持范围、性能或效果的具体说明。关于具体安装方式亦暂未提供。