mcpField
A
agent-browser

agent-browser

github.com/hjewkesAgent 工作流443 次安装35 周前更新
代码仓库

关于 agent-browser

agent-browser 是面向 Agent 的浏览器自动化技能，围绕页面导航、快照和元素引用交互组织操作流程。它还提供命令指南及表单、身份验证和内容采集模板。

主要功能

  1. 01导航并检查页面
  2. 02通过元素引用进行交互
  3. 03页面变化后刷新引用
  4. 04会话与身份验证指南
  5. 05可复用的自动化模板

适用场景

  1. 01自动提交表单
  2. 02复用已验证身份的浏览器状态
  3. 03结合截图提取内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hjewkes/agent-skills --skill agent-browser

安装后在 Claude Code 中输入/agent-browser确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
authentication.md
commands.md
common-patterns.md
javascript-evaluation.md
proxy-support.md
semantic-locators.md
session-management.md
snapshot-refs.md
video-recording.md
templates/
authenticated-session.sh
capture-workflow.sh
form-automation.sh

详细介绍

使用 agent-browser 进行浏览器自动化

核心工作流

每次浏览器自动化都遵循以下模式：

  1. 导航：agent-browser open <url>
  2. 快照：agent-browser snapshot -i（获取 @e1、@e2 等元素引用）
  3. 交互：使用引用进行点击、填充和选择
  4. 重新获取快照：导航或 DOM 发生变化后，获取最新引用
agent-browser open https://example.com/form
agent-browser snapshot -i
# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"

agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "password123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i  # Check result

基本命令

# Navigation
agent-browser open <url>              # Navigate
agent-browser close                   # Close browser

# Snapshot
agent-browser snapshot -i             # Interactive elements with refs (recommended)
agent-browser snapshot -i -C          # Include cursor-interactive elements

# Interaction (use @refs from snapshot)
agent-browser click @e1               # Click
agent-browser fill @e2 "text"         # Clear and type
agent-browser select @e1 "option"     # Select dropdown
agent-browser check @e1               # Checkbox
agent-browser press Enter             # Key press

# Wait
agent-browser wait @e1                # Wait for element
agent-browser wait --load networkidle # Wait for network idle

# Capture
agent-browser screenshot              # Screenshot
agent-browser screenshot --full       # Full page

引用生命周期（重要）

引用（@e1、@e2 等）会在页面发生变化时失效。点击会触发导航的链接或按钮、提交表单或加载动态内容后，务必重新获取快照。

深入文档

参考文档适用场景
references/commands.md完整的命令参考及所有选项
references/snapshot-refs.md引用生命周期、失效规则和故障排查
references/session-management.md并行会话、状态持久化和并发抓取
references/authentication.md登录流程、OAuth、2FA 处理和状态复用
references/video-recording.md用于调试和编写文档的录制工作流
references/proxy-support.md代理配置、地理位置测试和轮换代理
references/common-patterns.md表单提交、身份验证、数据提取、并行会话和 iOS 模拟器
references/semantic-locators.md引用的替代方案
references/javascript-evaluation.mdeval 规则及 --stdin/-b 说明

可直接使用的模板

模板说明
templates/form-automation.sh带验证的表单填写
templates/authenticated-session.sh登录一次，复用状态
templates/capture-workflow.sh使用截图提取内容

评论

支持 Markdown