コーディングエージェントがPlaywrightの自動化スクリプトを作成・実行できるAgent Skill
microsoft/playwright-cli
コーディングエージェントが短いシェルコマンドやスキルでブラウザーを操作できる、Playwrightブラウザー自動化向けCLIです。
- スター
- 15,007
- フォーク
- 901
- 未解決の Issue
- 21
- 最終コミット
- 昨日
これは何?
playwright-cliは、Playwrightの一般的なブラウザー操作をシェルコマンドとして提供します。Claude CodeやGitHub Copilotなどのコーディングエージェントは、大きなツールスキーマをモデルのコンテキストに読み込ませることなく、ページを開く、要素をクリック・入力する、スクリーンショットを撮る、ユーザー操作をPlaywrightコードとして記録する、セレクターを調べるといった操作を実行できます。開発者も同じコマンドを手動で実行して、サイトを調べたりフローをデバッグしたりできます。
名前付きセッションでは、呼び出しをまたいでブラウザーの状態が保持されるため、ブラウザーを閉じるまでCookieやストレージが維持されます。セッションはディスクに保存でき、headfulまたはheadlessで実行できるほか、一覧表示、終了、ビジュアルダッシュボードでの監視が可能です。要素の指定には、snapshotのref、CSSセレクター、Playwright locatorを使用できます。
操作機能に加えて、トレース、動画録画、ネットワークルートのモック、ストレージとCookieの管理、デバイスやカラースキームのエミュレーション、実験的なWebMCP tool-callingインターフェースにも対応しています。設定はJSONファイルまたは環境変数で行えます。Node.js 18以降が必要です。
主な機能
- 01クリック、入力、ページ遷移、スクリーンショットなど、一般的なPlaywrightの操作をシェルから実行できます。
- 02ブラウザー操作を記録し、対応するPlaywrightコードを生成できます。
- 03必要に応じて永続プロファイルを使える、分離された名前付きブラウザーセッションを維持できます。
- 04実行中のセッションを確認し、操作を引き継げるビジュアルダッシュボードを提供します。
- 05トレース、動画録画、ネットワークリクエストのモックに対応しています。
- 06要素の指定にはref、CSSセレクター、Playwright locatorを使用できます。
ユースケース
- コーディングエージェントにWebアプリのフローをテストさせ、成功した手順と失敗した手順のスクリーンショットを取得する。
- 表示中のブラウザーに対してコマンドを手動で実行し、ページを対話的にデバッグする。
- ユーザーフローを記録し、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 は何に使えますか?
- コーディングエージェントにWebアプリのフローをテストさせ、成功した手順と失敗した手順のスクリーンショットを取得する。 表示中のブラウザーに対してコマンドを手動で実行し、ページを対話的にデバッグする。 ユーザーフローを記録し、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 の数値は毎日更新されます。
関連プロジェクト
自然言語でテスト目標を記述し、エージェントでアプリを操作できるWeb・モバイル向けE2Eテストフレームワーク。
複数のエンジンでブラウザやモバイルのテストを、ユーザー視点の読みやすいステップで記述できるJavaScript製E2Eテストフレームワークです。
PRD、ADR、READMEからPlaywrightのE2Eテストを生成し、プロダクトとドキュメントの食い違いを検出します。
Playwrightは、単一のAPIでChromium、Firefox、WebKitを操作するWebテスト・自動化フレームワークです。
WebDriver、BiDi、Appiumを通じて、ブラウザーやモバイルアプリのE2E・ユニット・コンポーネントテストを自動化するNode.jsテストフレームワーク。