Kimi WebBridge는 AI 에이전트와 실제 브라우저 사이를 연결하는 로컬 우선 브라우저 확장이다. Claude Code 같은 로컬 에이전트가 현재 페이지를 읽고, 클릭하고, 입력하고, 스크린샷을 확인할 수 있게 해 브라우저 기반 리서치·테스트·업무 자동화에 활용한다.
구조
WebBridge는 대략 세 부분으로 나뉜다.
| 구성 요소 | 역할 |
|---|---|
| 브라우저 확장 | 현재 탭 DOM, 스크린샷, 클릭·입력 이벤트 접근 |
| 로컬 연결 계층 | 에이전트와 확장 사이의 메시지 전달 |
| AI 에이전트 | 작업 계획 수립, 명령 실행, 결과 검증 |
Browserbase 같은 클라우드 브라우저와 달리 사용자의 실제 브라우저 상태를 활용할 수 있다는 점이 장점이다. 로그인 세션, 확장 프로그램, 로컬 네트워크 접근이 필요한 작업에 특히 유용하다.
설치 흐름
- Kimi WebBridge 확장을 설치한다.
- 브라우저 툴바에 확장을 고정한다.
- 로컬 에이전트에서 WebBridge 연결을 활성화한다.
- 확장 상태가 connected인지 확인한다.
- 에이전트에게 현재 탭 기반 작업을 지시한다.
실제 자동화에서는 첫 실행부터 복잡한 결제·삭제 작업을 맡기지 말고, 읽기 전용 리서치나 폼 입력 전 미리보기 같은 낮은 위험 작업부터 검증하는 편이 좋다.
예시 워크플로
현재 탭의 제품 문서를 읽고,
가격 정책과 API 제한을 표로 정리한 뒤,
불확실한 부분은 원문 링크와 함께 확인 필요로 표시해라.
페이지 이동이 필요하면 먼저 이동 계획을 설명하고 대기해라.브라우저 자동화 에이전트는 화면을 볼 수 있다고 해서 모든 상태를 정확히 이해하는 것은 아니다. 따라서 페이지 이동, 로그인, 제출, 삭제처럼 상태가 바뀌는 작업에는 명시적인 승인 지점을 둬야 한다.
Playwright MCP와 비교
| 항목 | Kimi WebBridge | Playwright MCP |
|---|---|---|
| 실행 위치 | 사용자의 실제 브라우저 확장 | 자동화 브라우저 |
| 장점 | 로그인 세션과 기존 브라우저 상태 활용 | 재현성, 테스트 자동화, 격리 |
| 적합한 작업 | 리서치, 실제 웹앱 조작, 수동 업무 보조 | E2E 테스트, 스크립트형 검증 |
| 위험 | 민감 세션 노출, 의도치 않은 클릭 | 테스트 환경과 실제 환경 차이 |
보안 체크리스트
- 확장이 접근 가능한 사이트 범위를 제한한다.
- 삭제, 구매, 전송, 권한 변경은 사람 승인 후 실행한다.
- 에이전트 로그에 토큰·쿠키·개인정보가 남지 않게 한다.
- 업무용 브라우저와 실험용 브라우저 프로필을 분리한다.
관련 문서
- kimi — Moonshot AI의 Kimi 모델 생태계
- browser-harness — 브라우저 자동화를 위한 자기치유 하네스
- chrome-devtools-mcp — Chrome 브라우저 제어·디버깅 MCP 서버
- agent-harness — 도구 권한과 검증 루프를 설계하는 하네스 엔지니어링
참고 자료
- Kimi WebBridge: Hands-on Guide to Kimi’s Browser Extension for AI Agents — Analytics Vidhya (2026-05-19)