SuperAPI AI 工具集

agent-browser

智能体与模型

查看项目

更新于 10-16 05:46

技能介绍

用途:通过 Agent Browser CLI 进行浏览器自动化,适用于需要真实浏览器交互的场景,例如打开站点、点击、填写表单、截图、录制视频、抓取页面和验证 UI。

主要能力:提供 open、wait、snapshot、click、fill、screenshot 等命令;支持命名会话以复用登录状态;支持截图与视频作为验证证据;优先使用可访问性树快照和稳定元素引用,而非脆弱的 CSS 选择器。

使用方式:先检查 CLI 是否可用:agent-browser --version。若可用,获取当前核心指令:agent-browser skills get core --full;若该命令不支持,则用 agent-browser skills list 和 agent-browser skills get core。若缺失且环境允许安装,使用 npm i -g agent-browser 和 agent-browser install。通用流程为:打开目标 URL、等待加载或特定 UI 条件、用可访问性快照检查页面、点击/填写/滚动、截图或录屏、保存并复用命名会话、完成后关闭或重置会话。示例:agent-browser open http://localhost:3000;agent-browser wait --load networkidle;agent-browser snapshot -i;agent-browser click @e1;agent-browser fill @e2 "example";agent-browser screenshot --annotate reports/agent-browser/step.png。长流程可用 --session 指定命名会话。

适用场景:需要真实浏览器交互的 UI 验证、页面抓取、多步骤流程录制、认证状态复用等。

限制:不用于纯 HTTP/API 调用(可用 curl 或项目 SDK);不用于编写单元、集成或 E2E 测试文件(应使用 automate-e2e-tests);不得用于绕过认证、条款、权限或访问控制。证据需在状态变化后采集,并检查截图/录屏是否有效,拒绝空白、黑屏、错误路由、过期状态或无法播放的证据。认证需使用批准的测试凭据或已保存状态,不得编造凭据。若 CLI 缺失,仅在允许时安装,否则询问批准的安装方式。命令语法差异时以已安装版本为准。具体命令语法、模板、选择器和故障排除以 CLI 提供的指令为准。