브라우저 하네스: LLM에 CDP 직접 접근 권한을 부여하여 브라우저 작업 자체 수정

Browser Harness는 LLM이 CDP 웹소켓을 통해 Chrome에 직접 연결함으로써(~592줄의 Python 코드) 브라우저 작업을 완전히 자유롭게 수행할 수 있게 해주는 자기 치유형 도구입니다. Playwright MCP나 agent-browser처럼 Chrome을 미리 정의된 함수로 감싸는 대신, 웹소켓을 유지하는 얇은 데몬, 기본 헬퍼, SKILL.md 파일을 제공하며, 필요할 때 에이전트가 직접 도구를 작성하도록 합니다.

작동 방식

핵심 개념은 다음과 같습니다:

• CDP 웹소켓을 계속 유지하는 데몬
• helpers.py (~195줄)의 매우 기본적인 도구들
• 사용법을 설명하는 SKILL.md

LLM이 존재하지 않는 함수를 필요로 할 때, helpers.py를 편집하여 추가합니다. 저자들은 에이전트가 파일을 업로드하려고 할 때 upload_file() 함수가 없음을 발견하고, 스스로 DOM.setFileInputFiles를 사용하여 함수를 작성한 후 계속 진행했다는 사례를 보고했습니다. 이는 git diff에서만 확인 가능합니다.

다른 접근 방식과의 비교

다른 도구(Playwright MCP, browser-use CLI, agent-browser, Chrome DevTools MCP)는 Chrome을 미리 정의된 함수로 감쌉니다. 이들의 최악의 실패 모드는 click()이 성공을 반환했지만 아무 일도 일어나지 않는 조용한 실패입니다. Browser Harness는 LLM에게 완벽한 컨텍스트와 스스로 수정할 수 있는 자유를 제공하는 것을 목표로 합니다.

설정 및 설치

Claude Code나 Codex에 다음을 붙여넣어 설치합니다:

Set up https://github.com/browser-use/browser-harness for me.

에이전트는 부트스트랩을 위해 install.md를 읽고, 일반 사용을 위해 SKILL.md를 읽으며, 항상 helpers.py에서 사용 가능한 함수를 확인합니다.

실제 예시

• Stockfish 체스 엔진 플레이
• 테트리스 세계 기록 수립
• JavaScript로 하트 그리기

기여하기

기여를 환영합니다: LinkedIn, Amazon 등의 사이트를 위한 domain-skills/ 아래에 도메인 기술을 추가하세요. 기술은 수동으로 작성되는 것이 아니라 도구에 의해 생성됩니다. 버그 수정, 문서 개선, 헬퍼 개선도 환영합니다.

라이선스: MIT.