obra/superpowers-chrome

解决的问题

Superpowers Chrome 为 AI 代理（如 Claude Code）提供了一种通过 Chrome DevTools Protocol (CDP) 直接控制网页浏览器的方法。它无需复杂的设置或重型依赖，使代理能够实时、程序化地导航页面、与元素交互，并从网页中提取数据。

工作原理

该项目实现了两种不同的运行模式：

1. 技能模式：专为 Claude Code 代理设计的 CLI 工具，提供 17 个不同的浏览器自动化命令（例如 navigate、click、fill、extract）。
2. MCP 模式：一个轻量级 Model Context Protocol (MCP) 服务器，为 MCP 兼容客户端提供单一的 use_browser 工具。此模式包含“自动捕获”功能，可在每次 DOM 变更操作后自动保存 HTML、Markdown 和截图。

使用简化的标签索引语法（例如 0、1、2）来定位标签页，而非复杂的 WebSocket URL。它还通过将浏览器对话框（警告、提示和权限请求）作为合成响应呈现，使代理能够使用专用选择器语法（dialog::accept、dialog::dismiss）与其交互。

适用人群

• AI 代理开发者：正在为 LLM 构建网页浏览工具的人。
• Claude Code 用户：希望为其 AI 代理赋予网页浏览能力的用户。
• MCP 客户端用户：使用 Claude Desktop 或其他 MCP 兼容软件的用户。

主要亮点

• 零依赖：内置 WebSocket 支持，核心 CLI 工具无需 npm install。
• 傻瓜式 API：使用索引简化标签页管理。
• 对话框处理：专用系统防止浏览器对话框阻塞代理操作。
• 跨平台：在 macOS、Linux 和 Windows 上均可运行。
• 自动捕获：在 MCP 模式下，交互后自动生成 DOM 摘要、截图和页面状态的 Markdown。
• 完整 CDP 访问：为高级用户提供 raw 命令，可完全访问 Chrome DevTools Protocol。