Superpowers Chrome：让 Claude Code 直接操控 Chrome 的浏览器自动化神器

Superpowers Chrome：让 Claude Code 直接操控 Chrome 的浏览器自动化神器

Superpowers Chrome 是由 Superpowers 系列作者 obra 开源的 Claude Code 插件，通过 Chrome DevTools Protocol（CDP）实现对 Chrome 浏览器的直接控制。无需任何依赖、不需要 Puppeteer 或 Playwright，一个插件装进去，Claude Code 就能打开网页、填表、点击按钮、截图、提取内容。17 条命令覆盖从页面导航到底层 CDP 协议的全部场景，是目前最轻量、最完整的浏览器自动化 Skill 方案。

功能与原则

Superpowers Chrome 提供两种运行模式：Skill 模式（Claude Code CLI 工具）和 MCP 模式（通用 MCP 服务器，可接入任何 MCP 客户端）。核心设计原则：

• 零依赖：内置 WebSocket 通信，无需 npm 安装任何包
• 防小白 API：用 Tab 索引（0、1、2）代替复杂的 WebSocket URL，降低使用门槛
• 跨平台：macOS / Linux / Windows / WSL2 全部支持，开箱即用
• 对话式对话框处理：Alert、Confirm、Prompt、权限请求、Basic Auth 等弹窗不再卡死连接，以结构化方式返回给 Agent 处理

认可度

• GitHub Stars：339（截至 2026-08-14）
• Forks：52
• 最后推送：2026-08-07（近期活跃维护）
• 属于 Superpowers 生态，后者累计 Star 数已突破 187k，在 GitHub Trending 多次登顶

链接

GitHub：https://github.com/obra/superpowers-chrome

原作者

obra——Superpowers Skill 体系的作者，专注于为 Claude Code 构建工程级增强工具链，GitHub 主仓库 awesome-claude-skills 累计 Star 超过 187k，是 Claude Code 生态最知名的开发者之一。

介绍

Superpowers Chrome 解决了 AI 编程助手无法真正”看”到网页的痛点。在它出现之前，Claude Code 的浏览器操作主要依赖 Agent Browser 等 Skill，但底层要么需要复杂的 Playwright 配置，要么需要额外启动服务。Superpowers Chrome 直接利用 Chrome 内置的 DevTools Protocol，通过一个轻量 CLI 脚本建立 WebSocket 通道，让 Claude Code 在终端里就能操控真实的 Chrome 浏览器。

项目支持多 Profile 并行运行，每个 Chrome 实例分配独立端口（9222-12111 范围自动分配），互不冲突。对于需要”可见模式”浏览器的场景（调试、可视化爬虫），只需配置 DISPLAY 环境变量即可。Linux/WSL2 用户、Window 用户均有专门的处理说明，社区文档非常详尽。

此外，Dialog 处理是它的一个亮点功能：当页面弹出 Alert 确认框、权限申请或 HTTP 基本认证弹窗时，连接不会卡死，而是以结构化 Markdown 形式返回弹窗内容和操作指令，Claude Code 可以用 click selector="dialog::accept" 这样的语法直接处理。

特点

• 零依赖运行：不依赖 Puppeteer/Playwright，内置 WebSocket，Node.js 可直接运行
• 17 条命令：覆盖 start、tabs、new、close、navigate、click、fill、select、eval、extract、attr、html、screenshot、markdown 等完整自动化链路
• MCP 模式：不仅是 Claude Code Skill，也可作为通用 MCP 服务器接入 Codex CLI、Cursor 等任何 MCP 兼容客户端
• 多平台支持：macOS / Linux / Windows / WSL2，每个平台有专项优化说明
• Dialog 安全处理：弹窗不再卡死自动化流程，以 dialog::* 选择器语法统一处理
• 自动页面捕获：在 MCP 模式下，导航/点击/输入等 DOM 变更操作会自动附加页面 HTML 和 Markdown
• 并行多 Profile：同一机器可运行多个 Chrome 实例，各自独立端口，互不干扰

使用方法

安装（Skill 模式）：

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers-chrome@superpowers-marketplace

找到安装路径并进入 skills/browsing 目录：

cd ~/.claude/plugins/cache/superpowers-marketplace/superpowers-chrome/*/skills/browsing

启动与基础操作：

./chrome-ws start                        # 启动 Chrome（开启远程调试）
./chrome-ws new "https://example.com"   # 创建新标签页
./chrome-ws navigate 0 "https://google.com"  # 导航到指定页面
./chrome-ws fill 0 "textarea[name=q]" "test"  # 填写输入框
./chrome-ws click 0 "button[name=btnK]"  # 点击按钮
./chrome-ws screenshot 0                # 截图
./chrome-ws extract 0 payload=text       # 提取页面文本

MCP 模式接入（以 Claude Code 配置为例）：

{
  "mcpServers": {
    "chrome": {
      "command": "npx",
      "args": ["github:obra/superpowers-chrome", "--headless"]
    }
  }
}

Linux WSL2 有头模式需要配置 DISPLAY 环境变量：

"env": { "DISPLAY": ":0" }

无头容器模式（root 权限运行）会自动禁用 Chrome sandbox，并可通过 CHROME_EXTRA_ARGS 追加自定义参数。

使用场景与人群

适用场景：
– AI 驱动的网页数据采集与爬虫（区别于传统爬虫方案，Agent 可以根据页面结构自主决策）
– 自动化网页测试（表单填写、按钮点击、截图对比）
– 需要登录态才能访问页面的内容抓取（Cookie / Session 保持）
– 跨 Agent 协作时的浏览器共享（多 Profile 并行）
– 需要”可见”浏览器的 AI 调试场景

目标用户：
– 需要 Claude Code / Codex CLI 执行浏览器操作的高级用户
– 构建 AI 自动化工作流的开发者
– 需要无头浏览器能力但不想维护 Puppeteer/Playwright 的工程师

输入与输出案例

案例 1：自动化搜索

在 Google 搜索 "Claude Code skills"，提取搜索结果标题

Claude Code 内部执行：

./chrome-ws navigate 0 "https://google.com"
./chrome-ws fill 0 "textarea[name=q]" "Claude Code skills"
./chrome-ws click 0 "button[name=btnK]"
./chrome-ws extract 0 payload=text

返回搜索结果页面完整文本，包括：
• Claude Code Skills - GitHub
• Top Claude Code Skills in 2026 | Anthropic
• ...

案例 2：处理弹窗确认

登录某网站后页面弹出 "是否保存密码？" 的 Confirm 对话框，自动处理

Page is behind a dialog. Handle dialog::accept or dialog::dismiss first.

# Dialog: confirm
Tab origin: https://example.com
> 是否保存密码？
Buttons:
  - dialog::accept   (是)
  - dialog::dismiss (否)

Agent action: click selector="dialog::accept"

传统方案中这个弹窗会直接卡死 WebDriver 连接，Superpowers Chrome 则将弹窗作为结构化信息返回，让 Agent 自主决策处理方式。

GitHub: https://github.com/obra/superpowers-chrome