Agent Browser

브라우저 제어 및 네비게이션

Agent Browser는 브라우저를 열고 특정 URL로 이동하는 기본 기능을 제공합니다. agent-browser open example.com 명령으로 브라우저를 실행하고 웹 페이지로 이동할 수 있으며, agent-browser back, agent-browser forward, agent-browser reload 명령으로 페이지 내비게이션을 제어할 수 있습니다.

요소 상호작용

스냅샷을 통해 얻은 요소 참조(@e1, @e2 등)를 사용하여 웹 페이지의 요소를 정밀하게 제어할 수 있습니다. 클릭(agent-browser click @e2), 텍스트 입력(agent-browser fill @e3 "[email protected]"), 스크롤(agent-browser scroll down 100), 드래그 앤 드롭(agent-browser drag @e1 @e5) 등의 다양한 상호작용이 가능합니다.

스크린샷 및 PDF 생성

현재 페이지의 스크린샷을 agent-browser screenshot page.png 명령으로 캡처할 수 있으며, 전체 페이지 스크린샷은 --full 옵션을 사용합니다. 또한 PDF로 저장하는 agent-browser pdf document.pdf 기능도 제공됩니다. 스크린샷 형식과 품질을 조정할 수 있는 옵션도 포함되어 있습니다.

접근성 트리 및 텍스트 추출

agent-browser snapshot 명령은 접근성 트리를 반환하여 AI가 이해하기 쉬운 형식으로 웹 페이지 구조를 제공합니다. agent-browser read 명령으로 웹 페이지의 텍스트 콘텐츠를 추출할 수 있으며, 마크다운 형식으로 변환하거나 특정 섹션만 필터링하여 가져올 수 있습니다.

네트워크 제어 및 모니터링

네트워크 요청을 가로채고 수정하는 agent-browser network route 기능을 통해 특정 리소스를 차단하거나 모의 응답을 반환할 수 있습니다. HAR 기록을 시작하고 중지하여 네트워크 활동을 분석할 수 있으며, 실시간 요청 모니터링도 가능합니다.

탭 및 윈도우 관리

여러 탭과 윈도우를 관리할 수 있는 기능을 제공합니다. agent-browser tab new로 새 탭을 열고, agent-browser tab docs로 라벨이 지정된 탭으로 전환하며, agent-browser tab close로 탭을 닫을 수 있습니다. 윈도우 수준에서의 관리도 지원됩니다.

디버깅 및 개발 도구

콘솔 메시지 보기(agent-browser console), 오류 확인(agent-browser errors), 요소 하이라이트(agent-browser highlight @e1), Chrome DevTools 열기(agent-browser inspect) 등의 디버깅 기능을 제공합니다. 또한 성능 프로파일링과 비디오 녹화 기능도 포함되어 있습니다.

다운로드·설치 방법

Windows 사용자는 npm을 통해 전역 설치를 권장합니다. npm install -g agent-browser 명령으로 패키지를 설치한 후, agent-browser install 명령을 실행하여 Chrome for Testing에서 브라우저 바이너리를 다운로드해야 합니다. 이 과정은 최초 실행 시에만 필요하며, 이후에는 자동으로 감지된 기존 Chrome 설치를 사용할 수 있습니다.

기본 사용법/명령어

기본적인 워크플로우는 다음과 같습니다: 먼저 agent-browser open example.com으로 브라우저를 열고 웹 페이지로 이동합니다. 그런 다음 agent-browser snapshot -i로 현재 페이지의 접근성 트리를 얻어 요소 참조를 확인합니다. 얻은 참조(예: @e1, @e2)를 사용하여 agent-browser click @e2로 요소를 클릭하거나 agent-browser fill @e3 "[email protected]"로 텍스트를 입력할 수 있습니다. 작업이 완료되면 agent-browser screenshot result.png로 스크린샷을 저장하고 agent-browser close로 브라우저를 종료합니다.

이런 경우에 유용합니다

AI 에이전트가 웹사이트를 자동으로 탐색하고 정보를 추출해야 하는 경우에 유용합니다. 예를 들어, 제품 가격 정보를 수집하거나 뉴스 기사의 내용을 요약하는 작업에서 Agent Browser를 사용할 수 있습니다. 또한 웹 애플리케이션의 엔드투엔드 테스트를 자동화하거나, 사용자 인증이 필요한 서비스에 자동으로 로그인하여 반복적인 작업을 수행해야 하는 시나리오에서도 활용할 수 있습니다.

지원 환경·시스템 요구사항

Agent Browser는 Windows x64 플랫폼에서 네이티브 바이너리로 실행됩니다. 브라우저 자동화를 위해 Chrome for Testing에서 제공하는 Chrome 바이너리가 필요하며, 이는 agent-browser install 명령을 통해 자동으로 다운로드됩니다. 소스 코드에서 직접 빌드하려는 경우 Node.js 24+와 pnpm 11+, 그리고 Rust가 필요하지만, 일반 사용자는 사전 빌드된 바이너리를 사용하므로 이러한 개발 도구는 필수가 아닙니다.

최신 버전·업데이트

현재 버전은 0.37.0이며, agent-browser upgrade 명령을 통해 최신 버전으로 업데이트할 수 있습니다. 이 명령은 설치 방법(npm, Homebrew, Cargo 등)을 자동으로 감지하여 적절한 업데이트 절차를 실행합니다.

제한 사항·확인 사항

Agent Browser는 헤드리스 Chromium을 기본으로 사용하며, 이때 네이티브 스크롤바가 숨겨집니다. 스크린샷에서 네이티브 스크롤바를 유지하려면 --hide-scrollbars false 옵션을 사용해야 합니다. 또한 일부 웹사이트에서 동의 배너나 모달이 목표 요소를 가릴 수 있는데, 이 경우 먼저 가리는 요소를 처리한 후 새로 스냅샷을 얻어 다시 시도해야 합니다.

FAQ

Q: Agent Browser를 사용하기 위해 Node.js가 필요한가요?
A: 사전 빌드된 바이너리를 사용하는 경우에는 Node.js가 필요하지 않습니다. Node.js는 소스 코드에서 직접 빌드하거나 npm을 통해 패키지를 설치할 때만 필요하며, 브라우저 자동화 자체에는 요구되지 않습니다.

Q: 기존에 설치된 Chrome이나 Brave 브라우저를 사용할 수 있나요?
A: 네, Agent Browser는 기존에 설치된 Chrome, Brave, Playwright, Puppeteer 설치를 자동으로 감지하여 사용할 수 있습니다. 다만 최신 자동화 기능을 위해 Chrome for Testing에서 제공하는 바이너리를 사용하는 것이 권장됩니다.