agent-browser: AI 에이전트가 명령 한 줄씩 실제 브라우저를 다루게 하는 CLI

agent-browser는 AI 코딩 에이전트가 셸 명령 한 줄씩으로 실제 브라우저를 열고, 읽고, 누르게 해 주는 Vercel Labs의 명령줄 도구예요. 화면 캡처 대신 페이지를 짧은 텍스트로 바꿔 보여 주기 때문에, 에이전트가 적은 토큰으로 웹 페이지를 다룰 수 있게 만든 것이 핵심이에요.

무엇을 해 주나요

페이지를 텍스트 스냅샷으로 바꿔 줘요. snapshot 명령을 실행하면 페이지 안의 버튼, 입력 칸, 링크 같은 요소가 간단한 목록으로 나오고, 요소마다 @e1 같은 참조 번호(ref)가 붙어요. 에이전트는 이 번호를 골라 클릭하거나 값을 입력하고, 다시 스냅샷을 찍어 결과를 확인하는 식으로 한 단계씩 일을 진행해요.

브라우저를 계속 띄워 둬요. 첫 명령을 실행할 때 백그라운드 데몬이 함께 시작되고, 이 데몬이 Chrome DevTools Protocol로 브라우저를 조종해요. 그래서 명령을 여러 번 나눠 보내도 같은 탭과 로그인 상태가 이어져요. --session 이름을 다르게 주면 세션마다 데몬과 브라우저가 따로 떠요. 아무 명령이 없으면 기본값으로 한 시간 뒤 헤드리스 브라우저를 닫고 데몬도 끝나요.

여러 브라우저를 고를 수 있어요. 기본은 설치 때 내려받는 Chrome for Testing이고, 이미 켜져 있는 Chrome에 붙거나(--cdp, --auto-connect), Lightpanda 같은 다른 엔진, iOS 시뮬레이터의 모바일 Safari, Browserbase·Browserless 같은 클라우드 브라우저 서비스도 쓸 수 있다고 해요.

에이전트 연동 장치가 들어 있어요. agent-browser skills get core를 실행하면 설치된 버전에 맞는 사용 안내문이 나와서, 에이전트가 오래된 문서를 보고 틀린 명령을 쓰는 일을 줄여 줘요. agent-browser mcp로 MCP 서버(stdio)로도 띄울 수 있어요. 명령은 이동·읽기, 조작, 대기, 캡처(스크린샷·PDF·녹화·비교), 페이지와 네트워크 상태, 탭·프레임, 디버그, 세션·인증, 관찰(스트리밍·대시보드) 등 11개 묶음으로 나뉘어 있어요.

설치와 사용

미리 빌드된 실행 파일은 macOS(ARM64·x64), Linux(ARM64·x64, glibc와 musl), Windows(x64)용이 있어요. npm 전역 설치 뒤 브라우저를 내려받는 순서예요.

npm install -g agent-browser
agent-browser install
# Linux에서 시스템 라이브러리까지 함께 설치
agent-browser install --with-deps

Homebrew(brew install agent-browser)나 설치 없이 npx agent-browser open example.com으로 써 볼 수도 있어요. 소스에서 빌드하려면 README 기준으로 Node.js 24 이상, pnpm 11 이상, Rust가 필요해요. 기본 흐름은 아래와 같아요.

agent-browser open example.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser get url
agent-browser close

참조 번호 대신 역할과 이름으로 찾는 방법도 있어요. 예를 들어 agent-browser find role button click --name "Submit"처럼 쓰면 이름이 Submit인 버튼을 눌러요.

누구에게 쓸모 있나요

Claude Code나 Codex 같은 코딩 에이전트에게 “만든 웹 화면을 직접 열어 확인해 봐”라고 시키고 싶은 개발자에게 잘 맞아요. 스크린샷을 매번 모델에 넣는 방식보다 텍스트 스냅샷이 가볍기 때문에 긴 작업에서 비용과 속도 면에서 유리할 수 있어요. 로그인 상태를 유지한 채 여러 단계를 거치는 테스트, 폼 입력 점검, 간단한 화면 회귀 확인에도 쓸 수 있어요. 반대로 사람이 직접 클릭하며 쓰는 브라우저 자동화 녹화 도구를 찾는다면 Playwright 같은 기존 도구가 더 익숙할 거예요.

쓰기 전에 알아 둘 점

  • 참조 번호는 스냅샷을 찍은 순간의 페이지 기준이에요. 페이지를 이동하거나 내용이 바뀌면 다시 스냅샷을 찍어야 해요.
  • 대상이 숨겨져 있거나, 비활성이거나, 쿠키 동의 배너에 가려져 있으면 클릭이 실패로 끝나요. 성공한 척 넘어가지 않는 대신, 가림막을 먼저 닫고 다시 시도하는 처리가 필요해요.
  • --auto-connect로 평소 쓰는 Chrome에 붙이면 에이전트가 내 로그인 세션을 그대로 쓰게 돼요. 권한 범위를 꼭 생각하고 쓰는 게 좋아요. README 목차에는 인증 보관함, 도메인 허용 목록, 동작 정책 같은 보안 기능이 있다고 나오지만 자세한 내용은 별도 문서에 있어서 이번에는 확인하지 못했어요.
  • 텔레메트리(사용 통계 전송)에 대한 설명은 README에서 찾지 못했어요. 클라우드 브라우저 서비스를 쓰면 페이지 내용이 그 회사로 넘어간다는 점도 기억해 두세요.
  • 변경 속도가 빨라요. 11월 3일부터 12일 사이에 릴리스가 세 번 나왔고, v0.42.0에서는 Node 최소 버전이 22로 올라갔어요. 열린 이슈에는 교차 출처 iframe 선택 문제, Windows에서 브라우저가 사라진 뒤 데몬이 CPU를 100% 쓰는 문제 같은 보고가 올라와 있어요.

저장소 상태

  • 별 52.5k, 포크 3.7k (확인 시점 기준)
  • 열린 이슈 182개, 열린 PR 412개
  • 언어: Rust (GitHub 트렌딩 페이지 표시 기준)
  • 라이선스: Apache-2.0
  • 마지막 커밋: 2026년 11월 18일 (탭 동작, 세션별 데몬 실행 잠금 수정 등)
  • 최신 릴리스: v0.43.0 (11월 12일, 페이지에 연도는 표시되지 않음). 큰 페이지의 스냅샷 속도 개선, 닫힌 탭 명령의 빠른 실패 처리 등이 들어갔어요.
  • 최상위 폴더: cli, packages, skills, benchmarks, evals, docs, docker 등. README가 말하는 스킬과 CLI 구성이 실제로 있어요.

확인 범위

2026년 11월 18일에 GitHub 웹 페이지로 확인(API 미사용)했어요. 읽은 페이지는 저장소 첫 화면과 README(두 번 나눠 읽음), 릴리스 목록, 최근 커밋 목록, 열린 이슈 목록이에요. 보안·설정·네트워크 같은 외부 문서 페이지는 읽지 않았어요. 저장소 첫 화면에서 언어 비율과 사이드바 릴리스 정보는 보이지 않아서 트렌딩 페이지와 릴리스 페이지로 대신 확인했어요. 코드 분석, 설치와 실행은 하지 않았어요.

출처

Similar Posts