SuperAPI AI 工具集

core-agent-browser

智能体与模型

查看项目

更新于 10-15 08:18

技能介绍

用途

core-agent-browser 是 agent-browser CLI 工作流的内置支持技能,被 rust-learner、docs-researcher 和 crate-researcher 使用。它的作用是在需要通过命令行进行浏览器自动化时提供统一的操作方式。

优先级与适用条件

资料给出了获取 Rust/crate 信息时的优先级顺序:

  1. rust-learner 技能 —— 负责编排 actionbook + browser-fetcher
  2. actionbook MCP —— 为已知站点提供预计算选择器
  3. 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

核心工作流:

  1. 导航:agent-browser open <url>
  2. 快照:agent-browser snapshot -i(返回带 refs 的元素,如 @e1、@e2)
  3. 使用快照中的 refs 进行交互
  4. 在导航或发生显著 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 缺少目标站点预计算选择器时的备选方案
  • 需要进行交互式浏览器测试/自动化
  • 需要截图或填写表单

限制

资料中未提供关于收费、价格、平台支持范围、性能或效果的具体说明。关于具体安装方式亦暂未提供。