Browser Harness는 browser-use 팀이 제작한 약 592줄의 경량 브라우저 하네스다. CDP(Chrome DevTools Protocol) 웹소켓 하나로 Chrome에 직접 연결하며, 프레임워크나 레시피 없이 LLM이 작업 중에 빠진 헬퍼 함수를 스스로 작성해 채운다. 이 자기치유(self-healing) 구조 덕분에 사전에 모든 시나리오를 정의하지 않아도 된다.
작동 원리
● 에이전트: 파일 업로드 필요
│
● helpers.py → upload_file() 없음
│
● 에이전트가 helpers.py를 편집해 upload_file() 직접 작성
│ helpers.py: 192 → 199줄
✓ 파일 업로드 완료에이전트가 새 기능을 필요로 할 때마다 helpers.py를 직접 수정해 도구를 추가한다. 이렇게 생성된 스킬은 domain-skills/ 폴더에 누적되어 같은 사이트·작업 유형에 재사용된다.
구조 (592줄)
| 파일 | 역할 | 줄 수 |
|---|---|---|
install.md | 초기 설치 및 브라우저 부트스트랩 | — |
SKILL.md | 일상 사용 가이드 | — |
run.py | helpers 사전 로드 후 Python 실행 | ~36 |
helpers.py | 시작 도구 함수들 (에이전트가 확장) | ~195 |
admin.py + daemon.py | CDP 웹소켓·소켓 브릿지 | ~361 |
기존 browser-use와의 차이
browser-use는 풍부한 기능을 갖춘 브라우저 자동화 라이브러리이고, Browser Harness는 같은 팀이 만든 별도 미니멀리스트 프로젝트다. Harness는 추상화 레이어를 없애고 CDP에 직접 연결하므로 더 단순하지만, 에이전트가 더 많은 것을 직접 구현해야 한다.
무료 원격 브라우저
스텔스 모드, 서브에이전트, 배포 환경을 위한 클라우드 브라우저를 무료로 사용할 수 있다. 동시 3개, 프록시, CAPTCHA 해결 포함이며 카드 등록 불필요.
설치 및 시작
Claude Code 또는 Codex에 다음 프롬프트를 붙여넣으면 에이전트가 설치를 대신 진행한다:
Set up https://github.com/browser-use/browser-harness for me.
Read `install.md` first to install and connect this repo to my real browser.
Then read `SKILL.md` for normal usage.활용 대상
- 브라우저 자동화 프레임워크의 복잡성 없이 LLM 에이전트로 웹 작업을 처리하고 싶은 개발자
- 서비스별 커스텀 스킬을 쌓아나가며 반복 웹 작업을 자동화하려는 팀
- 브라우저 에이전트의 동작 원리를 최소 코드로 이해하려는 학습자
관련 문서
- browser-run — Cloudflare 클라우드 브라우저 인프라 (AI 에이전트용)
- agent-harness — 에이전트 하네스 엔지니어링 방법론
참고 자료
- browser-use/browser-harness — GitHub 공식 저장소