关于 agent-browser
agent-browser 是面向 Agent 的命令行浏览器自动化技能。它通过页面快照和元素引用来导航、操作页面元素并获取页面信息。
主要功能
- 01打开网页
- 02查看无障碍快照
- 03通过元素引用进行交互
- 04读取文本、标题和 URL
- 05等待元素或页面加载
适用场景
- 01填写并提交网页表单
- 02检查页面交互元素
- 03提取网页文本
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ actionbook/ actionbook --skill agent-browser安装后在 Claude Code 中输入/agent-browser确认已加载。
详细介绍
使用 agent-browser 进行浏览器自动化
快速开始
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(返回带有@e1、@e2等引用的元素) - 使用快照中的引用进行交互
- 导航或 DOM 发生重大变化后,重新生成快照
- 务必关闭:
agent-browser close
命令
导航
agent-browser open <url> # Navigate to URL
agent-browser close # Close browser (ALWAYS do this)
快照(页面分析)
agent-browser snapshot # Full accessibility tree
agent-browser snapshot -i # Interactive elements only (recommended)
交互(使用快照中的 @refs)
agent-browser click @e1 # 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 scroll down 500 # Scroll page
获取信息
agent-browser get text @e1 # Get element text
agent-browser get title # Get page title
agent-browser get url # Get current URL
等待
agent-browser wait @e1 # Wait for element
agent-browser wait 2000 # Wait milliseconds
agent-browser wait --load networkidle # Wait for network idle
示例:提交表单(request-website)
# Open Actionbook request page
agent-browser open "https://actionbook.app/request-website"
# Get form elements
agent-browser snapshot -i
# Output shows: textbox "Site URL" [ref=e1], textbox "Email" [ref=e2], textbox "Use Case" [ref=e3], button "Submit" [ref=e4]
# Fill form
agent-browser fill @e1 "https://example.com/products"
agent-browser fill @e2 "[email protected]"
agent-browser fill @e3 "Scraping product catalog"
# Submit
agent-browser click @e4
agent-browser wait --load networkidle
# Verify submission
agent-browser snapshot -i
# Close browser
agent-browser close
需要权限
添加到 .claude/settings.local.json:
{
"permissions": {
"allow": [
"Bash(agent-browser *)"
]
}
}
或者运行 ./setup.sh 自动配置。
评论
支持 Markdown