SuperAPI AI 工具集

browser-automation

通用与其它

查看项目

更新于 10-23 10:08

技能介绍

本技能让 Claude Code 在 macOS 上驱动浏览器,目标是以最小摩擦和正确身份执行网页操作。

用途与分级策略 技能要求从最高一级开始选择方案:第 0 级优先使用站点 API 或短期 OAuth 令牌,完全不开浏览器;第 1 级用 curl 或 httpx 处理服务端渲染页面;第 2 级使用自带配置档的浏览器,包括一次性无头 Playwright MCP 服务器,或在调试端口上按工具单独维护、只登录一次的配置档,这是无人值守任务的默认选择;第 3 级才使用用户本人已登录的真实 Chrome,适用于需要人工监督、需要本人会话,或站点屏蔽自动化浏览器的场景。无人值守工作绝不使用真实配置档,以免错误或恶意页面波及全部会话。

主要能力

  • 通过邮箱解析 Chrome 配置档(resolve、open),避免因文件夹名在不同机器上变化而指向错误账号。
  • setup 命令在指定配置档安装 Microsoft Playwright Extension,读取扩展令牌并存入 macOS 登录钥匙串,注册名为 chrome-<邮箱本地部分> 的 MCP 服务器。
  • setup-main 可选注册 chrome-main 服务器,汇总所有配置档的标签页。
  • doctor 命令检查 Chrome 版本、远程调试状态、各浏览器 MCP 服务器的形态与目标账号、令牌存储情况以及是否存在冒名的 Playwright 扩展。
  • chrome-debug-port-control.sh 可在独立配置档上开启调试端口,用于只登录一次的自动化环境,用完须关闭。
  • fill-secret.mjs 从钥匙串或保管库读取密钥,仅填入一个标签页的一个字段,只输出字符数。
  • mcp-drive.ts 可从 Bash 按需启动 MCP 服务器并执行工具调用列表,免除重启 Claude Code。

使用方式与限制 需要按说明运行相应脚本命令,安装扩展时由人工点击“Add to Chrome”。2FA 和通行密钥仍需真人处理。密码管理器的内联菜单可能破坏扩展连接,必要时改用脚本赋值或 chrome-main 完成页面。不得为每条命令新建调试连接,否则会反复弹出授权点击。不应依赖页面上的“成功”文字,需重新读取状态验证。密钥不得经过对话,只能通过脚本写入钥匙串或保管库并仅输出长度。遇到验证码、2FA 或异常页面应停止而非重试。

适用场景 需要登录态网页操作、表单填写、多步骤向导、页面状态检查等浏览器自动化任务,尤其适合希望按身份隔离、降低误操作风险的 macOS 环境。具体支持站点和效果暂未提供。