SuperAPI AI 工具集

agent-browser

智能体与模型

查看项目

更新于 10-16 00:04

技能介绍

用途:在 cloudrouter 云沙箱中自动化浏览器交互,适用于网页抓取、表单填写、测试、截图和数据提取等涉及网页、URL、登录流程的任务。

前提:需要一个运行中的 cloudrouter 沙箱,可用 cloudrouter ls 获取沙箱 ID,或用 cloudrouter start 创建。

核心工作流:打开 -> 快照 -> 交互 -> 重新快照。例如:cloudrouter browser open <id> "https://example.com";cloudrouter browser snapshot -i <id>;cloudrouter browser click <id> @e5;cloudrouter browser fill <id> @e3 "text";再次 snapshot -i。

主要能力:导航(open、back、forward、reload、url、title);检查(snapshot -i、snapshot、snapshot -c、screenshot、eval);交互(click、dblclick、fill、type、press、hover、focus、scroll、scrollintoview、select、check、uncheck、upload、drag、wait);获取信息(get-text、get-value、get-attr、get-html、get-count、is-visible、is-enabled、is-checked);语义定位(find text/label/placeholder/testid);JS 与调试(eval、console、errors);标签页与框架(tab-list、tab-new、tab-switch、tab-close、frame);Cookie 与存储(cookies、cookies-set、cookies-clear、storage-local 等);状态管理(state-save、state-load);浏览器设置(set-viewport、set-device、set-geo、set-offline、set-media);网络拦截(network-route、network-unroute、network-requests);对话框(dialog-accept、dialog-dismiss)。

选择器:优先使用快照生成的元素引用 @e1、@e2 等,也可用 CSS 选择器。

关键规则:标志位放在沙箱 ID 之前,如 snapshot -i <id>;导航或点击后必须重新快照;快照建议用 -i 只显示交互元素;不要混用快照模式;表单字段用 fill 而非 type;引用是临时的,每次快照后重置;交互前先验证元素;处理加载状态。

限制与排错:scrollintoview 和 highlight 只接受 CSS 选择器,不接受 @e 引用;find role button click 只能点第一个按钮,无法按名称过滤,也没有 --name 标志;文件保存在沙箱内,需用 cloudrouter download 取回;storage-local 查看具体值需用 eval;npm install 出现 EACCES 时先执行 cloudrouter ssh <id> "sudo chown -R 1000:1000 /home/user/.npm"。