Repolode
microsoft

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. 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 は何に使えますか?
コーディングエージェントに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 の数値は毎日更新されます。

関連プロジェクト