browser-use/browser-harness

Let Claude Code, Codex or Cursor use your real Chrome, logged in as you. One prompt to set up. Open source, MIT.

Browser Harness란 무엇인가

Browser Harness는 대규모 언어 모델 코딩 에이전트(Claude Code, Codex, Cursor 등)가 Chrome DevTools Protocol(CDP)을 통해 실제 Chrome 브라우저를 제어할 수 있게 해주는 오픈소스 브리지입니다. Python 패키지를 설치하고 에이전트에게 한 줄의 설정 프롬프트를 제공하면, 에이전트는 페이지를 열고, 클릭하고, 입력하고, 콘텐츠를 읽고, 파일을 다운로드하면서 사용자의 브라우저 프로필에 로그인된 상태를 유지할 수 있습니다.

작동 방식

설치 및 연결 – 제공된 install.md 스크립트(또는 한 줄 프롬프트)를 실행하여 browser-harness Python 패키지(uv를 통해)를 설치하고 스킬을 등록합니다(browser-harness skill). 스크립트는 Chrome의 원격 디버깅 페이지(chrome://inspect/#remote-debugging)를 열고 사용자에게 원격 디버깅을 활성화하도록 요청합니다.
스킬 정의 – SKILL.md는 에이전트가 따라야 할 높은 수준의 워크플로(페이지 열기, 요소 찾기, 클릭 등)를 설명합니다.
에이전트 생성 헬퍼 – 에이전트가 새로운 헬퍼 함수가 필요할 때, 자신의 작업 공간(agent_helpers.py)에 코드를 작성합니다. 이러한 헬퍼는 이후 작업에서 재사용할 수 있게 되어 하네스가 시간이 지남에 따라 개선됩니다.
MCP 서버 – 선택적인 browser-harness-mcp 구성 요소는 브라우저 제어 명령을 stdio를 통해 MCP 도구로 노출하므로, MCP 호환 클라이언트(Claude Code, Devin, Cursor 등)가 CDP 로직을 다시 구현하지 않고도 브라우저를 구동할 수 있습니다.
확장 – 대규모 작업의 경우, 사용자는 Browser Use Cloud로 전환할 수 있습니다. 이는 프록시, 스텔스 모드, CAPTCHA 해결과 같은 추가 기능과 함께 많은 헤드리스 브라우저를 병렬로 실행합니다.

사용할 수 있는 작업

개인 웹 작업 자동화 – 예: 로그인 상태를 유지하면서 X(Twitter) 프로필에서 최신 동영상 20개를 다운로드합니다.
인증 뒤의 데이터 스크래핑 – 에이전트는 사용자의 실제 Chrome 프로필을 사용하므로 쿠키나 로그인 세션이 필요한 사이트를 탐색할 수 있습니다.
재사용 가능한 자동화 헬퍼 생성 – 에이전트가 새로운 패턴을 발견하면 도구 상자의 일부가 되는 헬퍼 함수를 작성합니다.
대규모 실행 – 병렬 브라우저를 위한 Browser Use Cloud를 통해 일괄 처리 또는 테스트에 유용합니다.

사용 대상

AI 강화 자동화를 구축하는 개발자 – LLM이 실제 웹 페이지와 안전하게 상호 작용하기를 원합니다.
웹 에이전트 워크플로를 프로토타이핑하는 제품 팀 – 에이전트가 UI 작업을 수행할 수 있는 방법을 빠르게 테스트합니다.
에이전트 구동 웹 상호 작용을 연구하는 연구자 – 재현 가능한 오픈소스 하네스가 필요합니다.

시작하기(간단히)

# uv 사용(권장), Python 3.12 사용
uv pip install browser-harness
# 그런 다음 한 줄의 설정 프롬프트를 코딩 에이전트에 붙여넣습니다

에이전트는 원격 디버깅을 활성화하는 방법을 안내하고 스킬을 등록합니다.

라이선스

MIT – 개인, 상업 또는 연구 목적으로 자유롭게 사용할 수 있습니다.