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。