SuperAPI AI 工具集

browser

前端与建站

查看项目

更新于 10-15 16:49

技能介绍

用途:该技能通过 playwriter 实现浏览器自动化,适用于需要与网站交互的场景,例如导航页面、填写表单、点击按钮、截图、提取数据以及监控控制台输出。

主要能力与用法:提供两条路径,且不可在同一次 spool 调度中混用。一是 exec:browser,对页面运行 JS,可用全局对象包括 page、snapshot、screenshotWithAccessibilityLabels、state;有 15 秒实时窗口,之后转入后台,输出会在后续每次 plugkit 调用时自动排出。示例:将 await page.goto('https://example.com') 与 await snapshot({ page }) 写入 .gm/exec-spool/in/browser/<N>.txt。二是 browser: 前缀,用于 playwriter 会话管理,每个块只允许一条命令,例如 playwriter session new --direct,或 playwriter -s 1 -e 'await page.goto("http://example.com")';会话状态在多次 browser: 调用间保持,-e 参数外单引号、内双引号。数据提取可用 page.$$eval('.title', els => els.map(e => e.textContent));控制台监控需先设置监听器再轮询,如 state.logs = []、page.on('console', msg => state.logs.push({ type: msg.type(), text: msg.text() }))。

限制:不要 await setTimeout 超过 10000 的值,应改为轮询。UV_HANDLE_CLOSING 报错属正常退出噪声,可忽略。每个 browser: 块只能有一个 playwriter 命令;exec:browser 正文为纯 JS,不做 shell 引用;浏览器任务在每次 plugkit 交互时自动排出;会话空闲 5 至 15 分钟后回收,并在会话结束时清理。禁止编写独立的 .mjs/.js Playwright 脚本作为兜底,exec:browser 的错误应通过重试调试。资料未提供安装命令与收费信息。