AI 칼럼

업무 자동화@donghyeok99운영진

agent-browser: 코딩 에이전트가 셸 명령으로 모는 브라우저

웹페이지를 @e1 같은 번호표가 붙은 짧은 글로 바꿔 주면, 에이전트가 그 번호로 누르고 입력해요

open으로 로그인 페이지를 열고, snapshot -i가 요소마다 @e1~@e5 번호표를 붙이면, click @e5가 계속 버튼을 눌러요.
open으로 로그인 페이지를 열고, snapshot -i가 요소마다 @e1~@e5 번호표를 붙이면, click @e5가 계속 버튼을 눌러요.
누가
Vercel Labs가 만들었어요. 웹사이트를 열고, 누르고, 확인하는 일을 코딩 에이전트에게 맡기고 싶은 사람을 위한 도구예요.
언제
2026년 1월에 저장소가 열렸고, 2026년 11월 10일에 저장한 흐름을 다시 돌리는 기능이 들어간 v0.42.0이 나왔어요.
어디서
Rust로 만든 CLI라 macOS, Linux, Windows에서 돌아요. 셸을 쓰는 에이전트라면 다 쓸 수 있고, MCP 서버로도 띄울 수 있어요.

이게 불편했어요

에이전트에게 내 웹앱이 제대로 도는지 눌러 보라고 하면, 화면을 스크린샷으로 찍어 보거나 HTML을 통째로 읽으며 버튼 위치를 짐작해야 했어요. 한 번 누를 때마다 브라우저를 새로 띄우면 로그인 상태도 날아갔어요.

그래서 이렇게 풀어요

agent-browser는 페이지를 접근성 트리로 읽어, 누를 수 있는 요소마다 @e1 같은 번호를 붙인 짧은 글로 돌려줘요. 에이전트는 그 번호로 클릭하거나 입력하고, 페이지가 바뀌면 다시 스냅샷을 찍어 결과를 확인해요. 브라우저는 명령 사이에도 열려 있어서 한 단계가 셸 명령 한 줄이에요. README 기준으로, 대상이 동의 배너 같은 것에 가려져 있으면 클릭은 성공이라고 하지 않고 실패를 알려요.

agent-browser open example.comagent-browser snapshot -i       # interactive elements, each with a ref- link "Learn more" [ref=e1]agent-browser click @e1         # act on a ref from that snapshotagent-browser get url           # check the result
README의 실행 예시
vercel-labs/agent-browser

이걸로 만든 사람들

abhimanyuaryan.github.ioAbhimanyu Aryan2026-03-24

에이전트에게 자기 로컬 사이트의 하위 메뉴를 확인하게 했고, 에이전트가 페이지를 열고 스냅샷을 찍어 드롭다운 내용을 보고한 화면을 올렸어요. 작업 흐름에서 Playwright MCP를 이것으로 바꿨다고 적었어요.

it navigated, took a snapshot, and reported back the dropdown contents
alexop.devalexop.dev2026-04-11

Claude Code가 agent-browser로 실제 브라우저를 몰며 앱을 사용자처럼 둘러보고, 찾은 버그를 JSON 리포트로 돌려주는 QA 흐름을 만들어 글로 정리했어요.

Claude explores it like a user: clicking navigation, filling forms, checking for JS errors
Hacker Newsmiteshashar2026-05-05

Claude Code에서 agent-browser로 회계 서비스 Zoho Books의 작업을 자동화하는 영상을 Hacker News에 올렸어요.

Using Agent-Browser in Claude Code to Automate Zoho Books Workflows
좋아요 2 · 댓글 1 (2026-11-11 기준)Hacker News ↗

안에서는 이렇게 돌아가요

  1. 1

    나 → Claude Code · Codex

    이 사이트에서 폼을 채워 봐 줘설치한 스킬은 짧은 안내만 들고 있어서, 폼, 클릭, 스크린샷 같은 부탁이 오면 CLI에서 진짜 지침을 불러오라고 해요.skills/agent-browser/SKILL.md
  2. 2

    Claude Code · Codex → agent-browser CLI

    agent-browser skills get core설치된 버전과 맞는 core 지침(스냅샷, 번호, 기다리기)을 CLI가 skill-data 폴더에서 꺼내 보여 줘요.cli/src/skills.rs
  3. 3

    agent-browser CLI → 백그라운드 데몬

    agent-browser open example.com첫 명령에서 세션마다 데몬을 띄우고, 다음 명령부터는 소켓으로 같은 데몬에 붙어요.cli/src/connection.rs
  4. 4

    백그라운드 데몬 → Chrome for Testing

    Chrome DevTools Protocol데몬이 브라우저를 열어 두고 명령을 받아요. 한 시간 동안 명령이 없으면 헤드리스 브라우저를 닫고 끝나요.cli/src/native/daemon.rs
  5. 5

    Chrome for Testing → Claude Code · Codex

    snapshot -i: [ref=e1] 붙은 요소 목록Accessibility.getFullAXTree로 받은 트리에서 누를 수 있는 요소마다 e1, e2 번호를 매겨 짧은 글로 돌려줘요.cli/src/native/snapshot.rs
  6. 6

    Claude Code · Codex → Chrome for Testing

    click @e1번호로 요소를 찾아 가운데 좌표를 잡고 마우스 클릭을 보내요. 가려졌거나 비활성이면 성공이라 하지 않고 실패를 알려요.cli/src/native/interaction.rs
  7. 7

    Chrome for Testing → 확인한 결과와 스크린샷

    get url · screenshot다시 스냅샷을 찍거나 주소를 확인해 결과를 보고하고, 필요할 때만 화면을 이미지로 저장해요.cli/src/native/screenshot.rs

넣으면 이렇게 나와요

agent-browser snapshot -i (example.com)- link "Learn more" [ref=e1] 한 줄. 이제 click @e1로 누를 수 있어요.
agent-browser find role button click --name "Submit"번호 없이도 역할과 이름으로 Submit 버튼을 찾아 눌러요.
로컬 사이트의 하위 메뉴를 확인해 줘에이전트가 페이지를 열고 스냅샷을 찍어 드롭다운 내용을 보고했어요 (Abhimanyu Aryan의 글).
agent-browser skills get dogfood탐색 테스트와 버그 찾기를 하고 리포트를 남기는 전문 지침을 불러와요.

나한테 맞을까요

이럴 때 좋아요

  • 배포 전에 내 웹앱을 실제 브라우저로 눌러 보게 하고 싶을 때
  • 로그인, 폼 입력처럼 반복되는 웹 작업을 에이전트에게 맡기고 싶을 때
  • Playwright MCP보다 가벼운 셸 명령 방식이 맞을 때
  • 여러 에이전트가 각자 다른 브라우저 세션을 따로 써야 할 때

이건 안 돼요

  • 번호는 스냅샷을 찍은 순간의 페이지 기준이라, 이동하거나 화면이 바뀌면 다시 스냅샷을 찍어야 해요.
  • 처음 한 번 agent-browser install로 Chrome for Testing을 내려받아야 해요. Linux는 --with-deps로 시스템 라이브러리까지 설치해요.
  • 이름 없는 기본 세션은 같은 PC의 모든 에이전트가 함께 쓰는 브라우저라, 작업마다 --session 이름을 주는 게 안전해요.
  • Apache-2.0이라 회사에서도 쓰고 고칠 수 있어요. 고친 파일에는 바꿨다는 표시를 남기고 라이선스 문서를 함께 둬야 해요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기