remorses/playwriter

해결하는 문제

Playwriter는 AI 에이전트가 새롭고 격리된 인스턴스를 시작하는 대신 사용자의 실제 실행 중인 Chrome 브라우저를 제어할 수 있게 해줍니다. 이는 봇 탐지 시스템에 의해 차단되는 문제와 로그인, 쿠키, 확장 프로그램을 수동으로 처리해야 하는 번거로움을 해결하며, 에이전트가 사용자의 기존 인증된 세션 내에서 작동하게 합니다.

작동 방식

외부 컨트롤러(CLI 또는 MCP 클라이언트)와 브라우저 사이의 격차를 메우기 위해 Chrome 확장 프로그램을 사용합니다. 시스템은 로컬호스트에서 실행되는 WebSocket 리레이 서버로 구성되며, chrome.debugger API를 통해 확장 프로그램과 통신합니다. 이를 통해 에이전트는 특수한 원격 디버깅 플래그 없이도 전체 Playwright API를 사용해 브라우저와 상호작용할 수 있습니다. 이는 일반 사용자 프로필에서는 자주 차단되는 설정입니다.

대상 사용자

• AI 에이전트 개발자: 사용자의 인증된 브라우저 세션에서 작업을 수행해야 하는 개발자
• 자동화 엔지니어: 기존 상태를 유지한 채 자신의 브라우저를 프로그래밍 방식으로 제어하고 싶은 사용자
• 원격 운영자: 특정 브라우저 탭을 원격 에이전트나 사람과 공유하여 인증된 작업을 수행하고 싶은 사람

주요 특징

• 기존 세션 접근: 실제 Chrome 프로필(로그인 정보 및 확장 프로그램 포함)을 사용
• 완전한 Playwright API: 제한된 사전 정의 도구가 아니라 완전한 자동화 인터페이스 제공
• MCP 지원: Model Context Protocol (MCP)와 통합되어 에이전트 도입이 쉬움
• 상태 유지 실행: state 객체를 통해 여러 CLI 호출 간 상태를 유지
• 시각적 레이블: Vimium 스타일의 레이블이 포함된 접근성 스냅샷을 생성하여 에이전트가 요소를 식별하고 클릭할 수 있도록 지원
• 원격 제어: 보안 터널을 통해 단일 탭을 원격 에이전트와 공유 가능
• CDP 접근: 고급 디버깅 및 실시간 코드 편집을 위한 Chrome DevTools Protocol (CDP)에 직접 접근 가능