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, 스크린샷을 자동으로 저장하는 '자동 캡처' 기능을 포함합니다.

복잡한 WebSocket URL 대신 간단한 탭 인덱스 구문(예: 0, 1, 2)을 사용하여 탭을 대상으로 지정합니다. 또한 브라우저 대화 상자(알림, 프롬프트, 권한 요청)는 합성 응답으로 표시되어 전용 선택자 구문(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 접근: 고급 사용자를 위해 전체 Chrome DevTools Protocol 접근을 제공하는 raw 명령어 포함.