Playwright Browser Extension

Microsoft Docker 이미지를 사용한 headless Playwright 브라우저 자동화 Extension.

Features

• Microsoft Docker 이미지 (mcr.microsoft.com/playwright:v1.50.0-jammy) 사용
• Headless mode - 모든 브라우저 동작은 headless 모드로 실행
• Docker isolation - 브라우저가 컨테이너 안에서 격리되어 실행됨

Tools

Tool	Description
browser_navigate	URL로 네비게이션
browser_screenshot	페이지 또는 요소 스크린샷
browser_click	CSS 셀렉터로 요소 클릭
browser_type	CSS 셀렉터로 입력 요소에 텍스트 입력
browser_select	드롭다운 옵션 선택
browser_evaluate	페이지 컨텍스트에서 JavaScript 실행
browser_content	HTML 소스 또는 가시 텍스트 가져오기
browser_wait	셀렉터 또는 시간대기
browser_script	임의 Playwright 스크립트 실행
browser_close	브라우저 세션 리셋

Commands

/playwright status    - 컨테이너 상태 확인
/playwright start     - 컨테이너 시작
/playwright stop      - 컨테이너 중지
/playwright restart   - 컨테이너 재시작
/playwright logs      - 컨테이너 로그 확인

Requirements

• Docker Desktop 또는 Docker Engine 설치 필요
• docker CLI 가 PATH 에 등록되어 있어야 함

Usage Example

User: https://example.com 에 접속하고 스크린샷을 찍어줘

Assistant:
1. browser_navigate(url="https://example.com") 호출
2. browser_screenshot() 호출

Architecture

┌─────────────┐         ┌──────────────────────────────┐
│   pi (host) │         │  Docker Container             │
│             │  exec   │  mcr.microsoft.com/playwright  │
│  Extension  ├────────►│                                │
│             │         │  ┌────────────────────────┐   │
│             │         │  │  Chromium (headless)    │   │
│             │         │  └────────────────────────┘   │
│             │         │                                │
└─────────────┘         │  Shared Volume (results)      │
                        └──────────────────────────────┘

각 브라우저 명령은 독립적인 Playwright 세션을 실행하며, 페이지 상태(URL)는 shared volume 을 통해 세션 간 유지됩니다.