Repolode
microsoft

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. 1

    npm으로 CLI를 전역 설치합니다

    npm install -g @playwright/cli@latest
  2. 2

    에이전트 스킬을 설치합니다

    playwright-cli install --skills
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트