Communitygithub.com

agent-browser

AI 에이전트를 위한 빠른 브라우저 자동화 CLI. 웹사이트 탐색, 양식 작성, 버튼 클릭, 스크린샷 촬영, 데이터 추출, 웹 앱 테스트 등 브라우저 작업을 자동화합니다.

agent-browser란 무엇인가요?

agent-browser는 AI 에이전트(Claude Code, Cursor, Codex, Continue, Windsurf 등)를 위해 설계된 고속 브라우저 자동화 CLI 도구입니다. Rust로 구축되어 기존 Node.js 기반 도구보다 빠르며, Chrome/Chromium을 CDP(Chrome DevTools Protocol)로 직접 제어하여 Playwright나 Puppeteer 같은 추가 의존성이 필요 없습니다. 접근성 트리 스냅샷과 `@eN` 형식의 간결한 요소 참조를 제공하여 에이전트가 웹 페이지 요소를 안정적으로 식별하고 상호작용할 수 있도록 합니다. 세션, 인증 저장소, 상태 지속성, 비디오 녹화, 전용 Electron 앱이나 Slack 워크스페이스 자동화를 위한 특화 스킬 등 고급 기능을 갖추고 있으며, 4848 포트에서 독립적으로 실행되는 관찰 대시보드를 통해 세션 상태와 트래픽을 모니터링할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Windsurf
npx skills add https://github.com/vercel-labs/agent-browser/tree/main/skills/agent-browser

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

agent-browser은(는) 무엇을 하나요?

AI 에이전트를 위한 빠른 브라우저 자동화 CLI. Chrome/Chromium을 CDP로 제어하며 접근성 트리 스냅샷과 간결한 @eN 요소 참조를 사용합니다.

설치: npm i -g agent-browser && agent-browser install

시작하기

이 파일은 사용법 안내가 아닌 검색용 스텁(stub)입니다. agent-browser 명령어를 실행하기 전에 CLI에서 실제 워크플로우 콘텐츠를 불러오세요:

agent-browser skills get core             # 여기서 시작 — 워크플로우, 일반 패턴, 문제 해결
agent-browser skills get core --full      # 전체 명령어 참조 및 템플릿 포함

CLI는 설치된 버전과 항상 일치하는 스킬 콘텐츠를 제공하므로 지침이 최신 상태로 유지됩니다. 이 스텁의 내용은 릴리스 간에 변경될 수 없으므로 skills get core를 가리키도록 되어 있습니다.

특화 스킬

브라우저 웹 페이지 범위를 벗어나는 작업이 필요할 때 특화 스킬을 불러오세요:

agent-browser skills get electron          # Electron 데스크톱 앱 (VS Code, Slack, Discord, Figma, ...)
agent-browser skills get slack             # Slack 워크스페이스 자동화
agent-browser skills get dogfood           # 탐색적 테스팅 / QA / 버그 헌팅
agent-browser skills get derive-client     # HAR 기록 후 사이트 전용 독립 API 클라이언트 도출
agent-browser skills get vercel-sandbox    # Vercel Sandbox 마이크로VM 내 agent-browser
agent-browser skills get protected-vercel-deployments  # 보호된 Vercel 배포 접근
agent-browser skills get agentcore         # AWS Bedrock AgentCore 클라우드 브라우저

agent-browser skills list를 실행하여 설치된 버전에서 사용 가능한 모든 스킬을 확인하세요.

agent-browser의 장점

  • 빠른 네이티브 Rust CLI, Node.js 래퍼가 아님
  • 모든 AI 에이전트와 호환 (Cursor, Claude Code, Codex, Continue, Windsurf 등)
  • Playwright나 Puppeteer 의존성 없이 Chrome/Chromium을 CDP로 직접 제어
  • 안정적인 상호작용을 위한 접근성 트리 스냅샷 및 요소 참조 제공
  • 세션, 인증 저장소, 상태 지속성, 비디오 녹화 지원
  • Electron 앱, Slack, 탐색적 테스팅, 클라우드 제공자를 위한 특화 스킬

관찰 대시보드

대시보드는 브라우저 세션과 독립적으로 4848 포트에서 실행되며, https://dashboard.agent-browser.localhost와 같은 프록시 또는 포워딩된 URL을 통해서도 열 수 있습니다. 에이전트는 대시보드 출처를 유지해야 합니다. 세션 탭, 상태 및 스트림 트래픽은 내부적으로 프록시 처리되므로 세션 포트를 노출할 필요가 없습니다.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

vercel-labs/agentcore

Run agent-browser on AWS Bedrock AgentCore cloud browsers. Use when the user wants to use AgentCore, run browser automation on AWS, use a cloud browser with AWS credentials, or needs a managed browser session backed by AWS infrastructure. Triggers include "use agentcore", "run on AWS", "cloud browser with AWS", "bedrock browser", "agentcore session", or any task requiring AWS-hosted browser automation.

vercel-labs/derive-client

Reverse-engineer a website's internal API by recording browser traffic into a HAR file, then generate a standalone client or CLI that calls the endpoints directly, with no browser needed after the first recording. Use when asked to "derive a client", "build a CLI for <site>", "reverse engineer this site's API", "record network requests", "turn this site into an API", or when the same site will be automated repeatedly and direct HTTP calls would beat driving the browser every time.

vercel-labs/dogfood

Systematically explore and test a web application to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", "test this app/site/platform", or review the quality of a web application. Produces a structured report with full reproduction evidence -- step-by-step screenshots, repro videos, and detailed repro steps for every issue -- so findings can be handed directly to the responsible teams.

vercel-labs/electron

Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.

vercel-labs/protected-vercel-deployments

Access and test Vercel deployments protected by Vercel Authentication, SSO, or Deployment Protection with agent-browser. Use when a preview or production URL redirects to a Vercel login page, returns a protection 401 or 403, or needs short-lived Trusted Sources OIDC authentication instead of a static bypass secret or public exception.

vercel-labs/slack

Interact with Slack workspaces using browser automation. Use when the user needs to check unread channels, navigate Slack, send messages, extract data, find information, search conversations, or automate any Slack task. Triggers include "check my Slack", "what channels have unreads", "send a message to", "search Slack for", "extract from Slack", "find who said", or any task requiring programmatic Slack interaction.

vercel-labs/vercel-sandbox

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

vercel-labs/webmcp-gen

Build and validate experimental WebMCP tools for an existing web page. Use when an agent needs to expose a site's real workflows as page tools, create webmcp.init.js, define deterministic checks, or compare WebMCP with accessibility-tree automation.

관련 스킬