本技能让 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 环境。具体支持站点和效果暂未提供。