Playwright MCP

• 실제 브라우저 세션이 필요한 로그인 플로우, 양식 제출 또는 다단계 웹 상호작용을 자동화해야 합니다.
• JavaScript 렌더링(SPA, 동적 테이블 등)에 의존하는 페이지에서 구조화된 데이터를 추출하려 합니다.
• 크로스 브라우저 동작을 검증하기 위해 여러 브라우저 엔진(Chromium, Firefox, WebKit)에서 사이트를 테스트하거나 스크래핑해야 합니다.
• 클릭, 타이핑, 드롭다운 선택, 파일 업로드 등 사람이 하는 것과 동일한 방식으로 웹 UI와 상호작용해야 하는 AI 에이전트 워크플로우를 구축하고 있습니다.

• 대상 사이트가 공개 API를 노출하는 경우 — 브라우저 자동화는 불필요한 오버헤드를 추가하므로, API를 직접 사용하세요.
• 정적 HTML 파싱만 필요한 경우; 가벼운 HTTP fetch + HTML 파서가 더 빠르고 안정적입니다.
• 높은 처리량으로 대규모 병렬 스크래핑이 필요한 경우; Playwright MCP는 대용량 크롤링이 아닌 에이전트 워크플로우에 최적화되어 있습니다.

--browser 플래그 하나만 전달하면 Chromium, Firefox, 또는 WebKit을 대상으로 자동화를 실행할 수 있습니다. 엔진을 전환할 때 코드 변경이 필요 없으므로, 크로스 브라우저 테스트나 호환성 검사를 간편하게 수행할 수 있습니다.

10가지 목적에 맞게 제작된 도구들을 제공합니다 — browser_navigate, browser_click, browser_type, browser_evaluate, browser_snapshot, browser_choose_file, browser_press 등 — AI 에이전트에 필요한 모든 일반적인 브라우저 상호작용 패턴을 포괄합니다.

browser_evaluate 도구는 페이지 컨텍스트에서 임의의 JavaScript를 실행하고 결과를 JSON으로 반환하며, 추가적인 도구 없이 복잡한 데이터 추출, DOM 조작 및 커스텀 스크립팅을 가능하게 합니다.

헤드리스 및 헤디드 모드, 구성 가능한 뷰포트 크기, 사용자 정의 사용자 에이전트, 조정 가능한 액션/네비게이션 타임아웃을 지원하며 — CI 파이프라인과 대화형 디버깅 세션 모두에 적응 가능합니다.

기본적으로 파일시스템 접근을 워크스페이스 루트로 제한하며, --allowed-hosts 및 --blocked-origins 옵션을 통해 탐색 대상을 제어하고, 공격 표면을 줄이기 위해 기본적으로 샌드박싱을 활성화합니다.

선택적으로 Playwright 트레이스를 저장하고(--save-trace), 세션 비디오를 녹화하며(--save-video), 출력 아티팩트를 설정 가능한 디렉터리로 전달할 수 있습니다 — 자동화 실행 실패 디버깅이나 에이전트 동작 감사에 유용합니다.

로그인 페이지로 이동하여 browser_type으로 자격 증명을 입력하고, browser_click으로 제출한 후, 인증된 페이지로 이동하여 데이터를 추출합니다 — 모든 과정이 단일 에이전트 워크플로우로 이루어집니다.

browser_navigate를 사용하여 페이지를 로드한 다음, browser_evaluate와 커스텀 스크립트를 함께 사용하여 JavaScript 실행 후에만 나타나는 테이블 행, 구조화된 JSON 또는 모든 DOM 콘텐츠를 추출하세요.

드롭다운 옵션 선택, 파일 업로드, 키보드 단축키 입력, 결과 텍스트 확인 등 다단계 폼을 단계별로 진행하며 사용자 관점에서 웹 앱 동작을 검증합니다.

대시보드나 랜딩 페이지를 일정에 따라 탐색하고, browser_evaluate 및 출력 디렉터리 스크린샷을 통해 렌더링된 상태를 캡처하며, 시간 경과에 따른 시각적 또는 콘텐츠 변경 사항을 표시합니다.