AI 에이전트의 브라우저 자동화, agent-browser 설치부터 Claude Code 활용까지

작성자: 슬기로운 오늘과 내일 편집부 · 발행일: 2026-11-11

AI 에이전트가 웹사이트를 직접 방문하고, 버튼을 클릭하고, 검색하거나 로그인 후 필요한 작업을 수행하게 하려면 브라우저 자동화 도구가 필요합니다. Vercel Labs의 agent-browser는 이러한 작업을 명령어 기반으로 실행할 수 있도록 지원하는 브라우저 자동화 CLI입니다.

특히 Claude Code와 함께 사용하면 AI가 웹페이지를 확인하고 실제 브라우저를 조작하는 작업 흐름을 구성할 수 있습니다.

📌 핵심 요약

  • agent-browser는 AI 에이전트를 위한 브라우저 자동화 CLI입니다.
  • npm install -g agent-browser 명령으로 설치할 수 있습니다.
  • npx skills add vercel-labs/agent-browser 명령으로 Claude Code용 스킬을 추가할 수 있습니다.
  • snapshot으로 웹페이지의 요소를 확인하고 click, fill 등의 명령으로 조작합니다.
  • 로그인, 개인정보 입력, 결제 등 민감한 작업은 별도 권한과 검증이 필요합니다.

agent-browser란 무엇인가요?

일반적인 AI 에이전트는 웹페이지의 내용을 읽고 분석하는 데 그치는 경우가 많습니다. agent-browser를 사용하면 웹페이지 이동, 버튼 클릭, 입력 양식 작성, 스크린샷 촬영 등의 브라우저 작업을 명령어로 수행할 수 있습니다.

특징은 웹페이지를 단순한 이미지가 아니라 접근성 트리(페이지 요소와 역할을 텍스트로 표현한 정보) 형태로 읽을 수 있다는 점입니다. snapshot 명령을 실행하면 버튼이나 입력창 등에 @e1과 같은 참조 번호가 부여됩니다.

AI는 이 번호를 이용해 원하는 요소를 선택할 수 있어 페이지 구조를 파악하고 작업을 이어가기 편리합니다.

Claude Code에 agent-browser 설치하기

먼저 Node.js와 npm을 사용할 수 있는 환경을 준비합니다. 터미널에서 다음 명령어를 실행합니다.

npm install -g agent-browser agent-browser install

첫 번째 명령은 agent-browser CLI를 설치하며, 두 번째 명령은 자동화에 사용할 Chrome for Testing 브라우저를 설치합니다.

이어서 Claude Code에서 활용할 스킬을 추가합니다.

npx skills add vercel-labs/agent-browser

이 명령은 프로젝트의 Claude Code 스킬 경로에 agent-browser 스킬을 연결합니다. 실제 사용 지침은 설치된 CLI 버전에 맞춰 불러오는 구조이므로 오래된 지침 파일을 그대로 복사하는 방식보다 관리하기 편리합니다.

실제 브라우저 자동화 실행하기

설치가 끝났다면 간단한 웹페이지 접속부터 테스트해 보겠습니다.

agent-browser open https://example.com agent-browser snapshot -i

open은 브라우저에서 지정한 페이지를 엽니다. snapshot -i는 페이지에서 상호작용할 수 있는 요소를 추출합니다.

예를 들어 결과에 다음과 같은 링크가 표시되었다고 가정해 보겠습니다.

- link "Learn more" [ref=e1]

이제 해당 링크를 클릭할 수 있습니다.

agent-browser click @e1 agent-browser get url agent-browser close

click은 해당 요소를 클릭하고, get url은 현재 페이지 주소를 확인합니다. 작업이 끝나면 close로 브라우저를 종료합니다.

입력창을 조작할 때는 fill 명령을 활용할 수 있습니다.

agent-browser fill @e2 "검색할 내용"

다만 페이지 이동이나 화면 구조 변경 후에는 snapshot을 다시 실행해야 합니다. 이전에 사용한 참조 번호가 더 이상 유효하지 않을 수 있기 때문입니다.

AI 에이전트로 어떤 작업을 자동화할 수 있을까요?

  • 🔎 웹사이트 검색 및 자료 수집
  • 📝 웹페이지 입력 양식 작성
  • 🖱️ 버튼 클릭과 메뉴 이동
  • 📸 웹페이지 스크린샷 및 PDF 저장
  • 📂 파일 다운로드와 업로드
  • 🧪 웹서비스의 화면 동작 테스트
  • 🔍 여러 페이지를 순서대로 확인하는 반복 작업

예를 들어 AI에게 특정 웹사이트에서 상품 정보를 찾아 비교하도록 지시하면, agent-browser로 페이지를 열고 검색어를 입력한 뒤 결과를 확인하는 작업 흐름을 만들 수 있습니다.

사용할 때 주의할 점

브라우저 자동화는 실제 웹사이트에 영향을 주는 작업을 수행할 수 있습니다. 따라서 단순한 정보 조회와 달리 회원가입, 게시물 작성, 결제, 데이터 삭제 등은 실행 전에 사용자 확인 단계를 두는 것이 안전합니다.

또한 로그인 세션과 쿠키에는 개인정보가 포함될 수 있으므로 인증 정보를 안전하게 관리하고, 신뢰할 수 없는 웹페이지의 지시를 AI가 무조건 따르지 않도록 권한과 접근 도메인을 제한하는 것이 좋습니다.

agent-browser는 AI가 웹페이지를 읽는 수준에서 실제 브라우저를 조작하는 단계로 확장할 때 활용할 수 있는 도구입니다. 먼저 CLI를 설치하고 example.com에서 snapshot과 click 명령을 실행해 보세요. 이후 Claude Code에 스킬을 연결하면 반복적인 웹 작업을 AI 에이전트의 자동화 업무로 확장할 수 있습니다.