anomalyco/browser-control

해결하는 문제

브라우저 제어는 AI 코드 에이전트가 별도의 헤드리스 인스턴스가 아닌 사용자의 실제 웹 브라우저에 접근할 수 있게 해줍니다. 이로 인해 사용자의 기존 로그인 세션, 브라우저 프로필, 설치된 확장 프로그램을 사용하여 작업을 수행할 수 있으며, 에이전트가 복잡한 인증 또는 세션 관리를 수동으로 처리할 필요가 없습니다.

작동 방식

로컬 리레이와 브라우저 확장 프로그램을 연결하는 드라이버로 작동합니다. 에이전트는 Playwright 코드 조각을 리레이에 전송하고, 리레이가 사용자의 Chromium 기반 브라우저에서 확장 프로그램을 통해 이를 실행합니다. 에이전트에게 최적의 워크플로우(예: 행동 전 페이지 검사)를 가르치는 '스킬'을 포함하며, MCP(Model Context Protocol) 서버를 통해 도구로 노출할 수 있습니다.

대상 사용자

Claude Code나 OpenCode와 같은 AI 코드 에이전트를 사용하면서, 실제 브라우저 환경에서 안전하고 효율적으로 작업을 자동화하고자 하는 개발자를 대상으로 합니다.

주요 특징

• 세션 지속성: 헤드리스 브라우저가 아닌 실제 브라우저 프로필과 로그인 세션을 사용합니다.
• 사람의 개입: CAPTCHA나 2FA와 같은 사람만 처리할 수 있는 단계를 일시 중지하기 위한 handoff() 함수를 포함합니다.
• 탭 수용: 기존에 열려 있는 브라우저 탭에 연결하고 제어할 수 있습니다.
• 스마트 검사: DOM 드리프트를 방지하기 위해 안정적인 참조를 사용하여 페이지 구조를 이해하는 데 도움이 되는 snapshot() 및 ariaSnapshot() 헬퍼를 제공합니다.
• 네트워크 캡처: 인증된 API 교환을 기록하여 시크릿을 노출하지 않고 직접 API 클라이언트를 추출할 수 있습니다.
• 읽기 전용 모드: 키보드 및 마우스 입력을 거부하는 세션 유형을 제공하여 실수로 변경되는 것을 방지합니다.