프로젝트 소개

Browser Harness는 LLM 에이전트를 위한 브라우저 자동화 브리지다. 고정된 액션 집합을 제공하는 대신, 하나의 편집 가능한 CDP 웹소켓을 통해 에이전트를 사용자의 실제 브라우저에 연결하고 스킬 정의를 통해 브라우저 워크플로를 가르친다. 작업 중 필요한 헬퍼가 없으면 에이전트가 로컬 워크스페이스에 작성할 수 있어 이후 작업에서 재사용할 수 있으며, 패키지 자체의 소스 디렉터리는 보호된다. 문서화된 설정은 Claude Code 또는 Codex에서 설정 프롬프트를 사용하는 방식이다. 이 프롬프트는 코딩 에이전트에게 Python 3.12에서 uv로 browser-harness를 설치하거나 업그레이드하고, `browser-harness skill`의 출력을 등록하고, 브라우저에 연결하고, 로컬 브라우저 녹화를 활성화할지 묻도록 요청한다. 연결은 `chrome://inspect/#remote-debugging` 권한 단계를 포함한 Chrome 원격 디버깅을 사용하며, `install.md`가 대체 설정 가이드로 제공된다. MCP 서버인 `browser-harness-mcp`는 브라우저 제어 헬퍼를 stdio를 통해 MCP 도구로 노출한다. 이를 통해 Claude Code, Devin, Cursor 같은 MCP 클라이언트가 별도의 CDP 통합을 구현하지 않고도 브라우저를 구동할 수 있다. 저장소는 로그인이 필요한 작업을 위한 개인 브라우저 워크플로를 보여주며, 실시간 미리보기, 프록시, 스텔스 조치, CAPTCHA 해결 및 관련 관리 기능을 갖춘 다수의 브라우저를 병렬로 실행하기 위한 Browser Use Cloud를 링크한다. README에서 시연된 예제 작업은 X 프로필을 열고 최신 동영상 게시물 20개를 찾아 다운로드하는 것이다. 언급된 기여에는 버그 수정, 문서 개선, 에이전트가 생성한 도메인 스킬이 포함된다.