Vibium (브라우저 자동화)

개요

Vibium은 Selenium 창시자 Jason Huggins가 AI 에이전트를 위해 다시 만든 브라우저 자동화 도구. 21년 전 Selenium을 만든 사람이 AI 시대에 맞게 처음부터 재설계. 10MB Go 바이너리(Clicker) 하나로 Chrome 자동 감지·BiDi 프록시·MCP 서버 통합. claude mcp add vibium 한 줄로 Claude Code에 브라우저 제어 추가.

GitHub: https://github.com/VibiumDev
개발: Jason Huggins (Selenium 창시자)
언어: Go (Clicker) + JS/TS (클라이언트)
크기: ~10MB 단일 바이너리
플랫폼: Linux x64, macOS (Intel/Apple Silicon), Windows x64

”Selenium 아버지”의 21년 만의 귀환

2004: Jason Huggins → Selenium 개발
  → 웹 테스트 자동화의 표준
  → 수백만 개발자 사용

2025: Jason Huggins → Vibium 개발
  → AI 에이전트를 위한 브라우저 자동화
  → MCP 네이티브
  → 설정 없는 즉시 사용

구성 요소

1. Clicker (Go 바이너리)

~10MB 단일 바이너리:
  ✓ Chrome 자동 탐지 + BiDi 모드 실행
  ✓ WebSocket BiDi 프록시 서버
  ✓ MCP 서버 (LLM 에이전트 통신)
  ✓ Auto-Wait (요소 대기 후 상호작용)
  ✓ 스크린샷 캡처

2. JS/TS 클라이언트

npm install vibium

동기·비동기 API 모두 지원:

vibe.go() — URL 이동
vibe.find() — 요소 탐색
vibe.click() — 클릭
vibe.quit() — 종료

AI 에이전트 연동 (핵심)

Claude Code — 한 줄 설정

claude mcp add vibium -- npx -y vibium

→ Chrome 자동 다운로드, 별도 설정 ❌, 즉시 사용

MCP 제공 명령

명령	기능
`browser_launch`	브라우저 실행
`browser_navigate`	URL 이동
`browser_find`	CSS 셀렉터 요소 탐색
`browser_click`	요소 클릭
`browser_type`	텍스트 입력
`browser_screenshot`	뷰포트 캡처
`browser_quit`	브라우저 종료

사용 예시 (Claude Code)

사용자: "example.com에 가서 첫 번째 링크를 클릭해"
  ↓ Claude가 MCP 도구 호출
  ↓ browser_launch → browser_navigate → browser_find → browser_click
  ↓
결과: 브라우저에서 실제 동작 수행

JS/TS 클라이언트 사용

import { browser } from "vibium";
 
const vibe = await browser.launch();
await vibe.go("https://example.com");
const el = await vibe.find("a");
await el.click();
await vibe.quit();

동기 버전: browserSync도 제공

설치 (인간 사용자)

npm install vibium
 
# 자동 다운로드:
#   - Clicker 바이너리
#   - Chrome for Testing
#   - chromedriver
 
# 캐시 위치:
#   Linux:   ~/.cache/vibium/
#   macOS:   ~/Library/Caches/vibium/
#   Windows: %LOCALAPPDATA%\vibium\
 
# 브라우저 다운로드 건너뛰기:
VIBIUM_SKIP_BROWSER_DOWNLOAD=1 npm install vibium

vs Selenium vs Playwright vs Puppeteer

항목	Selenium	Playwright	Puppeteer	Vibium
출시	2004	2020	2017	2025
만든 사람	Jason Huggins	MS	Google	Jason Huggins
AI 에이전트 설계	❌ 후속 적용	△	△	✅ 처음부터
MCP 네이티브	❌	❌	❌	✅
설치 크기	수백 MB	~200MB	~200MB	~10MB
설정	복잡	중간	중간	제로
프로토콜	WebDriver	CDP/BiDi	CDP	WebDriver BiDi
언어	Java, Python, JS, C#	JS/TS, Python, Java, .NET	JS	Go(서버) + JS/TS(클라이언트)

→ Vibium의 niche: “AI 에이전트를 위해 처음부터 설계된 브라우저 자동화”

로드맵

V1 (현재)

MCP + JS 클라이언트 기반 브라우저 제어

V2 (예정)

기능	설명
Python, Java 클라이언트	다국어 지원
Cortex	메모리·내비게이션 계층
Retina	녹화 확장 기능
비디오 녹화	세션 기록
AI 기반 요소 탐색	CSS 셀렉터 없이 자연어 탐색

활용 시나리오

시나리오	사용
Claude Code 브라우저 제어	MCP 한 줄 설정
AI 에이전트 웹 스크래핑	구조화된 데이터 추출
테스트 자동화	E2E 테스트 (Selenium 대체)
스크린샷 루프	Claude 스크린샷 루프 (3D 작업) 패턴
폼 자동 입력	반복 웹 작업
경쟁사 모니터링	주기적 웹 체크

의의

1. "Selenium 아버지"의 AI 시대 재설계
   - 21년의 교훈을 담아 처음부터

2. AI-first 설계
   - MCP 네이티브
   - LLM이 자연어로 브라우저 제어

3. 제로 설정
   - npm install + 한 줄 → 즉시 동작
   - Chrome 자동 다운로드

4. 경량
   - 10MB 단일 바이너리 (vs Selenium 수백 MB)

5. WebDriver BiDi
   - 최신 W3C 표준 채택
   - 양방향 통신 (이벤트 구독 가능)

다른 노트와의 연결

노트	연결
Claude Code CLI	MCP 연동 대상
Serena MCP	MCP 생태계
Claude 스크린샷 루프 (3D 작업)	브라우저 스크린샷 패턴
GPT-5.4 프론트엔드 디자인 가이드	Playwright 검증
Codex 플랫폼 (SDLC 가이드)	브라우저 제어 도구
understudy (데스크톱 에이전트)	유사 자동화
MCP (Model Context Protocol)	프로토콜

Bigstones

Explorer