agent-browser의 개요
agent-browser는 Vercel Labs가 만든 Rust 기반 네이티브 명령줄 도구로, AI 에이전트에게 조작할 수 있는 브라우저를 줍니다. agent-browser snapshot은 페이지를 간결한 접근성 텍스트로 돌려주며 각 요소에 @e1 같은 참조를 붙입니다. 에이전트는 참조로 클릭하거나 입력하고, 페이지를 다시 읽고, 이를 반복합니다. 첫 명령에서 백그라운드 데몬이 시작되어 Chrome DevTools Protocol로 브라우저를 제어하고 호출 사이에도 열려 있으므로, 각 단계는 짧은 셸 명령 하나입니다.
탐색과 입력 외에도 스크린샷, PDF, 녹화, 시각적 비교, 쿠키와 저장소, 네트워크 검사, 콘솔 오류, 트레이스, Core Web Vitals, React 검사기를 다룹니다. 기본 브라우저는 Chrome for Testing이며, 실행 중인 Chrome에 연결하거나 Lightpanda 또는 Obscura 엔진으로 바꾸거나, iOS Simulator의 Mobile Safari를 조작하거나, Browserbase, Browserless, Browser Use, Kernel, AgentCore의 클라우드 브라우저를 쓸 수도 있습니다. 스킬은 바이너리에 함께 들어 있고, agent-browser mcp는 stdio MCP 서버를 시작합니다.
저장소는 Apache-2.0 라이선스이며 GitHub 스타는 약 53,000개입니다. v0.43.0은 2026년 11월 12일에 나왔고, npm 패키지는 11월 19일까지 일주일 동안 약 260만 회 다운로드되었습니다.
agent-browser, 쓸 만한 가치가 있습니까?
agent-browser는 코딩 에이전트가 이미 터미널을 다룰 줄 아니, 브라우저도 터미널 명령이어야 한다는 데 걸었습니다. 각 단계는 open, snapshot, click @e3, 다시 snapshot이고, 출력은 스크린샷이나 HTML 페이지가 아니라 몇 줄의 텍스트입니다. 숨겨졌거나 비활성화되었거나 다른 요소에 가려진 요소를 클 릭하면 성공으로 보고하지 않고 실패합니다. 덕분에 에이전트가 쿠키 배너를 열 번이나 자신 있게 클릭하는 일을 막습니다.
이것이 Playwright MCP와의 주된 차이입니다. Playwright MCP는 브라우저를 MCP 도구로 제공하고 클라이언트가 그 정의를 처음부터 불러옵니다. 여기서는 MCP가 부가 기능이며, 셸을 실행할 수 있는 에이전트라면 클라이언트 지원 없이도 쓸 수 있습니다. browser-use와는 다른 방식으로 다릅니다. browser-use는 자체 모델 루프를 가진 Python 라이브러리이지만, agent-browser는 모델이 내장되어 있지 않고 생각하는 일은 Claude Code, Codex 등 호출하는 에이전트에 맡깁니다. 일주일에 약 260만 회라는 npm 다운로드 수는 이 방식이 자리 잡았다는 뜻입니다.
주의할 점: 기본 상태에서는 에이전트가 어디로 가는지, 무엇을 실행하는지, 무엇을 출력하는지에 제한이 없습니다. 문서화된 통제 수단은 좋지만 모두 직접 켜야 합니다. 도메인 허용 목록, 14개 명령 범주에 대한 작업 정책, 60초가 지나면 자동으로 거부되는 사람의 확인, 페이지 텍스트를 신뢰할 수 없는 것으로 표시하는 nonce 기반 콘텐츠 경계가 있습니다. auth vault는 로그인 정보를 AES-256-GCM으로 암호화해 저장하므로 모델은 비밀번호를 보지 못합니다. 그러나 ~/.agent-browser/sessions/에 저장된 세션 파일은 암호화 키를 설정하지 않으면 토큰을 평문으로 담습니다. --profile은 실제 Chrome의 쿠키를 세션에 복사하고, --auto-connect는 Chrome의 디버깅 포트를 열어야 하는데, 문서는 이것이 모든 로컬 프로세스에 완전한 제어권을 준다고 경고합니다. 허용 목록은 두 모드 모두와 함께 쓸 수 없습니다.
결론: 웹 코드를 쓰고 확인하는 에이전트라면 이제 이것이 기본 브라우저 도구이며, 설치 후 첫 작업은 --allowed-domains와 eval을 거부하는 --action-policy 파일을 붙인 실행 명령을 만드는 일입니다. 로그인된 세션을 에이전트에게 넘겨도 괜찮은 경우가 아니라면, 평소 쓰는 Chrome 프로필과는 떨어뜨려 두십시오.
제 역할을 하는 곳
Claude Code로 Next.js 앱을 개발하는 프런트엔드 개발자
에이전트가 완료를 알리기 전에 자기가 바꾼 UI를 브라우저에서 확인하게 하고 싶다
npm install -g agent-browser와 agent-browser install로 설치하고, agent-browser skills get core를 가리키는 두 줄을 AGENTS.md에 추가한 뒤, 에이전트가 localhost를 열고 스냅샷을 찍고 흐름을 클릭해 가며 콘솔 오류를 읽게 합니다. 무료이며 노트북의 Chrome for Testing에서 실행됩니다.
직원 20명 규모 SaaS 기업의 QA 엔지니어
스테이징 사이트에서 레이아웃 회귀와 느린 페이지를 잡아내고 싶다
CI에서 스테이징을 대상으로 agent-browser diff와 vitals를 실행하되, --allowed-domains는 스테이징 호스트로 제한하고 작업 정책으로 eval과 다운로드를 거부합니다. 라이선스 비용은 없으며, Browserbase나 Kernel의 클라우드 브라우저는 선택 사항이고 해당 업체가 요금을 청구합니다.
운영 분석가
로그인이 필요한 포털에서 에이전트가 매달 내보내기 파일을 받아 오게 하고 싶다
agent-browser auth와 --password-stdin으로 로그인 정보를 저장해 모델에는 프로필 이름만 보이게 하고, AGENT_BROWSER_ENCRYPTION_KEY를 설정해 세션 파일을 암호화하며, --confirm-actions로 실행해 다운로드마다 승인을 받게 합니다.
도입 전 확인할 점
- 설정
- npm install -g agent-browser(또는 brew install agent-browser) 후 agent-browser install로 Chrome for Testing을 내려받습니다. Linux에서는 --with-deps를 추가합니다. npx agent-browser open example.com은 설치 없이 동작합니다. macOS, Linux, Windows용 네이티브 바이너리가 있습니다.
- 연동
- 셸 CLI, 함께 제공되는 스킬(agent-browser skills get core), skills.sh 설치, stdio MCP 서버, 플러그인. 엔진은 Chrome for Testing, Lightpanda, Obscura, iOS Simulator. 클라우드 업체는 Browserbase, Browserless, Browser Use, Kernel, AgentCore. Vercel Sandbox용 가이드도 있습니다.
- 데이터와 개인정보
- 로컬에서 실행됩니다. ~/.agent-browser/auth/의 auth vault는 자동 생성된 키 파일로 항상 AES-256-GCM 암호화됩니다. ~/.agent-browser/sessions/의 세션 상태는 AGENT_BROWSER_ENCRYPTION_KEY를 설정하지 않으면 평문이며, 기본적으로 30일 후 만료됩니다. 공개된 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 유료 버전은 없습니다. 비용은 Chrome을 실행하는 머신과 모델 토큰이며, 클라우드 브라우저 업체를 선택하면 분 단위 요금이 추가됩니다.
- 제한
- 참조는 페이지 이동이나 DOM 변경 후 무효가 되어 새 스냅샷이 필요합니다. 허용 목록은 최선 노력 방식이며 방화벽이 아닙니다. 데몬은 기본적으로 1시간 동안 명령이 없으면 헤드리스 브라우저를 닫습니다. 버전 0.43.0은 아직 1.0 이전입니다.
좋은 점
- 참조가 붙은 간결한 텍스트 스냅샷으로 각 단계가 몇 줄에 그침
- 평범한 셸 명령이라 어떤 에이전트에서도 사용 가능, MCP는 선택
- 네트워크, 트레이스, vitals, 비교, 녹화, iOS Simulator까지 폭넓게 지원
- 암호화된 auth vault가 비밀번호를 모델의 컨텍스트 밖에 둠
아쉬운 점
- 직접 설정하지 않으면 탐색, 작업, 출력에 제한이 없음
- 암호화 키가 없으면 저장된 세션 상태가 평문
- 도메인 허용 목록은 --profile, --cdp, --auto-connect와 함께 쓸 수 없음
- 1.0 이전이고 변화가 빨라 릴리스마다 명령이 바뀜
추천 대상
Claude Code, Codex 같은 터미널 에이전트가 컨텍스트를 많이 쓰 지 않고 실제 브라우저에서 웹 앱을 테스트하고 디버깅하게 하려는 개발자.
agent-browser 대안
agent-browser: 자주 묻는 질문
- agent-browser, 쓸 만한 가치가 있습니까?
- 대부분의 코딩 에이전트가 가장 먼저 써 봐야 할 브라우저 CLI입니다. 단, 기본으로 꺼져 있는 안전장치를 켜야 합니다. 평점은 5점 만점에 4.4점입니다.
- agent-browser의 가격은 얼마입니까?
- 무료 오픈 소스입니다(Apache-2.0). 선택 사항인 클라우드 브라우저 업체는 별도로 요금을 청구합니다.
- agent-browser의 단점은 무엇입니까?
- 직접 설정하지 않으면 탐색, 작업, 출력에 제한이 없음; 암호화 키가 없으면 저장된 세션 상태가 평문; 도메인 허용 목록은 --profile, --cdp, --auto-connect와 함께 쓸 수 없음; 1.0 이전이고 변화가 빨라 릴리스마다 명령이 바뀜.
- agent-browser에 적합한 사람은 누구입니까?
- Claude Code, Codex 같은 터미널 에이전트가 컨텍스트를 많이 쓰지 않고 실제 브라우저에서 웹 앱을 테스트하고 디버깅하게 하려는 개발자.
- 팀이나 프로덕션 환경에서 agent-browser의 비용은 얼마입니까?
- 유료 버전은 없습니다. 비용은 Chrome을 실행하는 머신과 모델 토큰이며, 클라우드 브라우저 업체를 선택하면 분 단위 요금이 추가됩니다.
- agent-browser에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 실행됩니다. ~/.agent-browser/auth/의 auth vault는 자동 생성된 키 파일로 항상 AES-256-GCM 암호화됩니다. ~/.agent-browser/sessions/의 세션 상태는 AGENT_BROWSER_ENCRYPTION_KEY를 설정하지 않으면 평문이며, 기본적으로 30일 후 만료됩니다. 공개된 보안 권고는 없습니다.
- agent-browser의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Browser Use, Stagehand, PinchTab 및 Lightpanda입니다.
답변 확인일: 2026년 11월 20일.