코딩 에이전트가 테스트와 여러 단계의 웹 작업을 위한 Playwright 자동화 스크립트를 작성하고 실행하게 해주는 Agent Skill입니다.
microsoft/playwright-cli
코딩 에이전트가 짧은 셸 명령과 스킬로 브라우저를 제어할 수 있도록 만든 Playwright 브라우저 자동화 CLI입니다.
- 스타
- 15,007
- 포크
- 901
- 열린 이슈
- 21
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
playwright-cli는 자주 사용하는 Playwright 브라우저 작업을 셸 명령으로 제공합니다. Claude Code나 GitHub Copilot 같은 코딩 에이전트는 모델 컨텍스트에 큰 도구 스키마를 불러오지 않고도 페이지 열기, 요소 클릭 및 입력, 스크린샷 촬영, 사용자 동작의 Playwright 코드 기록, 셀렉터 확인 등을 할 수 있습니다. 개발자도 같은 명령을 직접 실행해 사이트를 둘러보거나 흐름을 디버깅할 수 있습니다.
이 도구는 이름이 지정된 세션에서 호출 간 브라우저 상태를 유지하므로 브라우저를 닫기 전까지 쿠키와 스토리지가 명령 사이에 보존됩니다. 세션을 디스크에 저장하고, headed 또는 headless 모드로 실행하며, 시각적 대시보드에서 목록을 확인하거나 닫고 모니터링할 수 있습니다. 요소는 snapshot ref, CSS 셀렉터 또는 Playwright locator로 지정합니다.
상호작용 외에도 tracing, 동영상 녹화, 네트워크 라우트 모킹, 스토리지 및 쿠키 관리, 기기 및 색상 구성표 에뮬레이션, 실험적인 WebMCP 도구 호출 인터페이스를 지원합니다. JSON 파일이나 환경 변수로 설정할 수 있으며, Node.js 18 이상이 필요합니다.
핵심 기능
- 01클릭, 입력, 이동, 스크린샷 촬영 등 자주 쓰는 Playwright 작업을 셸에서 실행합니다.
- 02브라우저 동작을 기록하고 이에 대응하는 Playwright 코드를 생성합니다.
- 03선택적으로 영구 프로필을 사용할 수 있는 격리된 이름 지정 브라우저 세션을 유지합니다.
- 04실행 중인 세션을 확인하고 제어할 수 있는 시각적 대시보드를 제공합니다.
- 05tracing, 동영상 녹화, 네트워크 요청 모킹을 지원합니다.
- 06대상 요소를 ref, CSS 셀렉터 또는 Playwright locator로 지정할 수 있습니다.
활용 사례
- 코딩 에이전트가 웹 앱 흐름을 테스트하고 성공 및 실패 단계의 스크린샷을 캡처하도록 합니다.
- 표시된 브라우저에서 명령을 직접 실행해 페이지를 대화형으로 디버깅합니다.
- 사용자 흐름을 기록해 Playwright 테스트 코드로 변환합니다.
- 엔드투엔드 테스트를 작성하면서 셀렉터와 요소 속성을 확인합니다.
빠른 시작
- 1
npm으로 CLI를 전역 설치합니다
npm install -g @playwright/cli@latest - 2
에이전트 스킬을 설치합니다
playwright-cli install --skills - 3
브라우저를 열고 페이지로 이동합니다
playwright-cli open https://playwright.dev --headed
사용 전 알아둘 점
- Node.js 18 이상이 필요합니다.
- 주로 코딩 에이전트를 위해 설계되었으며, 범용 테스트 러너는 아닙니다.
포함된 컬렉션
토픽
자주 묻는 질문
- playwright-cli은(는) 무엇인가요?
- 코딩 에이전트가 짧은 셸 명령과 스킬로 브라우저를 제어할 수 있도록 만든 Playwright 브라우저 자동화 CLI입니다. playwright-cli는 자주 사용하는 Playwright 브라우저 작업을 셸 명령으로 제공합니다. Claude Code나 GitHub Copilot 같은 코딩 에이전트는 모델 컨텍스트에 큰 도구 스키마를 불러오지 않고도 페이지 열기, 요소 클릭 및 입력, 스크린샷 촬영, 사용자 동작의 Playwright 코드 기록, 셀렉터 확인 등을 할 수 있습니다. 개발자도 같은 명령을 직접 실행해 사이트를 둘러보거나 흐름을 디버깅할 수 있습니다.
- playwright-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- playwright-cli은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- playwright-cli은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. playwright-cli의 마지막 커밋은 2026년 11월 5일입니다.
- playwright-cli은(는) 어디에 사용할 수 있나요?
- 코딩 에이전트가 웹 앱 흐름을 테스트하고 성공 및 실패 단계의 스크린샷을 캡처하도록 합니다. 표시된 브라우저에서 명령을 직접 실행해 페이지를 대화형으로 디버깅합니다. 사용자 흐름을 기록해 Playwright 테스트 코드로 변환합니다. 엔드투엔드 테스트를 작성하면서 셀렉터와 요소 속성을 확인합니다.
- playwright-cli는 어떻게 설치하나요?
- npm으로 CLI를 전역 설치합니다: npm install -g @playwright/cli@latest 에이전트 스킬을 설치합니다: playwright-cli install --skills 브라우저를 열고 페이지로 이동합니다: playwright-cli open https://playwright.dev --headed
- playwright-cli은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/microsoft/playwright-cli
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
자연어로 테스트 목표를 설명하고 에이전트로 앱을 조작하는 웹·모바일 앱용 E2E 테스트 프레임워크입니다.
여러 엔진에서 읽기 쉬운 사용자 관점의 단계로 브라우저 및 모바일 테스트를 작성할 수 있는 JavaScript E2E 테스트 프레임워크입니다.
PRD, ADR, README를 바탕으로 Playwright 엔드투엔드 테스트를 생성하고 제품과 문서의 내용이 다른 부분을 찾아냅니다.
Playwright는 단일 API로 Chromium, Firefox, WebKit을 제어하는 웹 테스트 및 자동화 프레임워크입니다.
WebDriver, BiDi, Appium을 통해 브라우저와 모바일 앱의 E2E·유닛·컴포넌트 테스트를 지원하는 Node.js 테스트 자동화 프레임워크입니다.