---
title: Playwright CLI 調査レポート
tool_name: Playwright CLI
tool_reading: プレイライト シーエルアイ
category: AIテスト自動化
developer: Microsoft
official_site: https://github.com/microsoft/playwright-cli
date: '2026-02-26'
last_updated: '2026-06-08'
tags:
  - AI
  - CLI
  - エージェント
  - オープンソース
  - テスト自動化
description: AIコーディングエージェント（Claude Code, GitHub Copilotなど）がブラウザ操作を行うための軽量で効率的なCLIツール。
quick_summary:
  has_free_plan: true
  is_oss: true
  starting_price: 無料
  target_users:
    - AIエージェント開発者
    - QAエンジニア
  latest_highlight: 2026年5月のv0.1.13でChrome拡張機能経由でのブラウザレベルコマンドやマルチタブに対応
  update_frequency: 高
evaluation:
  score: 88
  base_score: 70
  plus_points:
    - point: 8
      reason: トークン効率を重視した設計により、AIエージェントとの連携が非常にスムーズ
    - point: 5
      reason: Microsoft公式による提供で信頼性が高く、Playwright本体との互換性が完璧
    - point: 5
      reason: セッション永続化機能により、ログイン状態を維持した操作が容易
  minus_points:
    - point: 0
      reason: 特になし（CLIツールとしての完成度が高い）
  summary: AIエージェントにブラウザ操作能力を付与するための最適解であり、MCPサーバーよりも軽量で実用的。
links:
  github: https://github.com/microsoft/playwright-cli
  deepwiki: https://deepwiki.com/microsoft/playwright-cli
  codewiki: https://codewiki.google/github.com/microsoft/playwright
  documentation: https://github.com/microsoft/playwright-cli#readme
relationships:
  parent: Playwright
  related_tools:
    - Selenium
    - Claude
    - GitHub Copilot
    - GitHub Copilot CLI
    - Chrome DevTools for agents
---
# **Playwright CLI 調査レポート**

## **1. 基本情報**

<!--
【ガイドライン】
- 必須: ツール名、開発元、公式サイト、カテゴリ、概要
- 概要は2-3文で簡潔に記述
-->

* **ツール名**: Playwright CLI
* **ツールの読み方**: プレイライト シーエルアイ
* **開発元**: Microsoft
* **公式サイト**: [https://github.com/microsoft/playwright-cli](https://github.com/microsoft/playwright-cli)
* **関連リンク**:
  * GitHub: [https://github.com/microsoft/playwright-cli](https://github.com/microsoft/playwright-cli)
  * Playwright MCP (別パッケージ): [https://github.com/microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
* **カテゴリ**: テスト/QA
* **概要**: Playwright CLIは、Claude CodeやGitHub CopilotなどのAIコーディングエージェントが、Webブラウザを効率的に操作するためのコマンドラインツールです。従来のMCP（Model Context Protocol）サーバーと比較して、トークン消費量を抑えた設計（Skillsアプローチ）となっており、高速かつ低コストな自動化を実現します。

## **2. 目的と主な利用シーン**

<!--
【ガイドライン】
- 3-5項目を箇条書きで記述
- 想定利用者を具体的に記載
-->

* **解決する課題**: AIエージェントがWeb上の情報にアクセスしたり、Webアプリケーションの動作確認を行ったりする際の、トークン消費量と実行速度の最適化。
* **想定利用者**: AIエージェントを活用する開発者、QAエンジニア、自動化スペシャリスト。
* **利用シーン**:
  * **AIエージェントによるE2Eテスト**: 開発中のWebアプリに対して、エージェントが自律的に操作を行いバグを発見する。
  * **動的なWeb調査**: JavaScriptで生成されるコンテンツを含むWebサイトの情報を、エージェントが閲覧・収集する。
  * **ブラウザ操作の自動化**: フォーム入力やスクリーンショット撮影などの定型作業を、自然言語の指示で実行する。

## **3. 主要機能**

<!--
【ガイドライン】
- 5-10項目の主要機能を箇条書きで記述
- 各機能は1-2文で概要を説明
-->

* **トークン効率の良い操作**: ページ全体のアクセシビリティツリーを常に送るのではなく、必要な情報のみをやり取りする設計で、LLMのコンテキストウィンドウを節約します。
* **セッション永続化**: ブラウザのCookieやローカルストレージを保存・再利用でき、ログインが必要なサイトでも継続的な操作が可能です。
* **ヘッドレス/ヘッドフルモード**: バックグラウンドでの高速実行（ヘッドレス）と、動作を目視確認できるモード（ヘッドフル）を切り替え可能です。
* **スキルとしての統合**: `playwright-cli install --skills` コマンドにより、Claude Codeなどのエージェントに「ブラウザ操作スキル」として簡単に登録できます。
* **多彩なブラウザ操作**: `open`, `click`, `type`, `screenshot`, `pdf` など、Playwrightの主要機能をCLIコマンドとして網羅しています。
* **モニタリングダッシュボード**: `playwright-cli show` で実行中のセッションを可視化し、エージェントの操作をリアルタイムで監視・制御できます。
* **ダッシュボード上のUIレビュー**: `playwright-cli annotate` やマルチスクリーンショットによるUIレビュー機能を備え、エージェントに視覚的・構造的なフィードバックを与えやすくなっています。
* **Chrome拡張機能の高度な連携**: Chrome拡張機能モード(`attach --extension`)にて、複数タブのサポート(`tab-new`, `tab-list`)やブラウザレベルのCDPコマンド(`cookie-list`, `state-save`等)に対応し、より柔軟な操作が可能です。

## **4. 開始手順・セットアップ**

<!--
【ガイドライン】
- アカウント作成から「Hello World」的な最初の動作確認までの手順
- 主要なコマンドや設定項目を記載
-->

* **前提条件**:
  * Node.js 18以上
  * PlaywrightがサポートするOS環境
* **インストール/導入**:

  ```bash
  npm install -g @playwright/cli@latest
  ```

* **初期設定**:
  * スキルとしてエージェントに登録する場合:

    ```bash
    playwright-cli install --skills
    ```

* **クイックスタート**:

  ```bash
  # URLを開く
  playwright-cli open https://playwright.dev
  # スクリーンショットを撮る
  playwright-cli screenshot
  ```

## **5. 特徴・強み (Pros)**

<!--
【ガイドライン】
- 3-5項目を箇条書きで記述
- 競合との差別化ポイントを明確に
-->

* **AIエージェント最適化**: 汎用的な自動化ツールではなく、LLMが操作することを前提に設計されており、エラーメッセージや出力形式がAIに親和的です。
* **Playwright MCPとの差別化**: MCPサーバー版と比較してトークン効率が良く、特に大規模なコンテキストを扱うコーディングタスクにおいて有利です。
* **Microsoft公式サポート**: Playwright本体と同じ開発チームによってメンテナンスされており、信頼性と最新機能への追従性が高いです。

## **6. 弱み・注意点 (Cons)**

<!--
【ガイドライン】
- 3-5項目を箇条書きで記述
- 日本語対応の状況は必ず含める
-->

* **複雑なロジックの限界**: CLIコマンドの組み合わせであるため、PlaywrightのAPIを直接叩くスクリプトほどの細かい制御は難しい場合があります。
* **日本語ドキュメント**: 公式ドキュメントは英語のみです（ただし、ツールの出力はシンプルであり、AI経由で使う分には問題になりにくい）。
* **MCPサーバーとの使い分け**: 永続的な接続やリッチなイントロスペクションが必要な場合は、別途 `playwright-mcp` を検討する必要があります。

## **7. 料金プラン**

<!--
【ガイドライン】
- 表形式で整理することを推奨
- 最新の料金情報であることを確認
- 価格は通貨を明記（例: $10/月、¥1,000/月）
-->

| プラン名 | 料金 | 主な特徴 |
|---------|------|---------|
| **オープンソース** | 無料 | 全機能利用可能 (Apache-2.0 License) |

* **課金体系**: なし
* **無料トライアル**: なし（常に無料）

## **8. 導入実績・事例**

<!--
【ガイドライン】
- 具体的な企業名を3-5社挙げる
- 導入事例がない場合は「公開事例なし。ただし、〜の分野での利用が報告されている」等
-->

* **導入企業**: Microsoft (GitHub Copilot), Anthropic (Claude Code) などのAIエージェント開発元で推奨・利用されています。
* **導入事例**: GitHub Copilot WorkspaceやClaude Codeにおいて、ユーザーの代わりにドキュメントを読んだり、Webアプリの動作を確認したりする標準ツールとして採用されています。
* **対象業界**: ソフトウェア開発、QA、AIリサーチ。

## **9. サポート体制**

<!--
【ガイドライン】
- ドキュメント、コミュニティ、公式サポートの3項目を必ず含める
- URLがあれば記載
-->

* **ドキュメント**: [GitHub README](https://github.com/microsoft/playwright-cli) が事実上の公式ドキュメントです。
* **コミュニティ**: PlaywrightのDiscordコミュニティやGitHub Issuesで質問や報告が可能です。
* **公式サポート**: オープンソースプロジェクトのため、商用サポートはありませんが、コミュニティによる活発なサポートが期待できます。

## **10. エコシステムと連携**

<!--
【ガイドライン】
- API、外部連携、技術スタックとの相性を包括的に記述
-->

### **10.1 API・外部サービス連携**

<!--
【ガイドライン】
- APIの有無と公開状況を明記
- 主要連携サービスを5-10個リストアップ
-->

* **CLIインターフェース**: 標準入出力を介してあらゆるツールから利用可能です。
* **主要な連携AIエージェント**:
  * **Claude Code**: 公式にサポートされており、`install --skills` コマンドで即座に連携可能。
  * **GitHub Copilot CLI**: ターミナルでの開発フローに統合可能。
  * **Cline / Roo Code**: VS Code拡張機能からもCLIツールとして呼び出し可能。

### **10.2 技術スタックとの相性**

<!--
【ガイドライン】
- 主要なフレームワークや言語との相性を表形式で整理
- 相性: ◎ (非常に良い), ◯ (良い), △ (工夫が必要/一部非対応), × (非推奨)
-->

| 技術スタック | 相性 | メリット・推奨理由 | 懸念点・注意点 |
|:---|:---:|:---|:---|
| **Node.js** | ◎ | npmパッケージとして提供され、インストールが容易。 | 特になし。 |
| **Python** | ◯ | CLIツールとして外部プロセス呼び出しが可能。 | 直接的なPythonバインディングではない。 |
| **Docker** | ◎ | ヘッドレスモードでの実行に適しており、コンテナ内での利用も容易。 | 画面出力が必要な場合はX11転送等の設定が必要。 |

## **11. セキュリティとコンプライアンス**

<!--
【ガイドライン】
- 認証、データ管理、準拠規格の3項目を必ず調査
- 情報が見つからない場合は「公式サイトで公開されていない。問い合わせが必要。」と記載
- 「不明」「見つからず」のみの記載は避ける
-->

* **認証**: ローカル環境で動作するため、ツール自体に認証機能はありませんが、ブラウザセッション（Cookie等）の管理はユーザーの責任で行われます。
* **データ管理**: 操作データやスクリーンショットはローカルディスクに保存され、外部サーバーへの送信は行われません（AIエージェントへの出力は除く）。
* **準拠規格**: オープンソースソフトウェアとして提供され、特定のセキュリティ認証は取得していません。

## **12. 操作性 (UI/UX) と学習コスト**

<!--
【ガイドライン】
- 実際の使用感や、類似ツールとの比較を含める
-->

* **UI/UX**: 基本はCUIですが、`playwright-cli show` コマンドによるダッシュボード機能があり、視覚的に操作状況を確認できる点が優れています。さらに、マルチスクリーンショットでのUIレビューや `playwright-cli annotate` 機能により、AIエージェントの操作に対する視覚的フィードバックが容易に行えます。
* **学習コスト**: AIエージェントに指示を出すだけで使えるため、人間がコマンドの詳細を覚える必要はほとんどなく、学習コストは極めて低いです。

## **13. ベストプラクティス**

<!--
【ガイドライン】
- ツールを効果的に活用するための推奨事項や、避けるべきアンチパターンを記述
- 公式ドキュメントのBest Practicesや、熟練エンジニアの知見を参考にする
-->

* **効果的な活用法 (Modern Practices)**:
  * **Coding Agentsでの利用**: MCPサーバーとしてではなく、CLIスキルとして登録することで、トークン消費を抑えつつ高速なインタラクションを実現する。
  * **セッションの使い分け**: `playwright-cli -s=session_name` を使ってタスクごとにブラウザセッションを分離し、クリーンな環境でテストを行う。
* **陥りやすい罠 (Antipatterns)**:
  * **過剰なスクリーンショット**: 必要以上にスクリーンショットを撮らせるとトークン消費が増えるため、テキスト情報の取得（アクセシビリティツリーなど）を優先する。

## **14. ユーザーの声（レビュー分析）**

<!--
【ガイドライン】
- 必須調査サイト: G2, Capterra, ITreview（日本語レビュー）のうち該当するもの
- 追加調査サイト: App Store, Google Play, X(Twitter), Reddit等
- 総合評価スコアがあれば必ず記載
- ポジティブ・ネガティブ各3項目以上
-->

* **調査対象**: GitHub Issues, X (Twitter), Tech Blogs
* **総合評価**: 4.5/5.0 (推定: コミュニティでの評判に基づく)
* **ポジティブな評価**:
  * 「Claude Codeでのブラウザ操作が劇的に軽くなった。MCP版よりサクサク動く。」
  * 「ダッシュボード機能が便利。AIが何をしているかリアルタイムで見えるのが安心。」
  * 「インストールがnpm一発で済むので導入が楽。」
* **ネガティブな評価 / 改善要望**:
  * 「まだ機能が基本的なものに限られている。複雑なドラッグ＆ドロップなどが難しい場合がある。」
  * 「ドキュメントがREADMEだけで、もっと詳細な例が欲しい。」
* **特徴的なユースケース**:
  * AIにローカルサーバーのログを見せながら、ブラウザで再現手順を実行させ、デバッグを行う。

## **15. 直近半年のアップデート情報**

<!--
【ガイドライン】
- 日付の降順（新しいものが上）
- 3-10項目をリストアップ
- 各項目に日付と概要を含める
- **情報源の優先順位**:
  1. GitHubリポジトリの `CHANGELOG.md`
  2. GitHub Releases
  3. 公式ブログ / ニュース
- 情報源のURLを記載
-->

* **2026-05-07 (v0.1.13)**: Chrome拡張機能モードにおけるブラウザレベルのCDPコマンド(`cookie-list`, `state-save`等)への対応バグ修正。
* **2026-05-06 (v0.1.12)**: Chrome拡張機能の複数タブ対応(`tab-new`, `tab-list`)。ダッシュボードのマルチスクリーンショットUIレビュー機能の追加。
* **2026-05-01 (v0.1.11)**: `playwright-cli annotate` コマンドで null viewport 時のフォールバック動作を改善。
* **2026-02-14 (v0.1.1)**: 初期メジャーリリース以降のバグ修正と安定性向上。AIスキルとしての登録プロセスの改善。
* **2026-01-XX**: Playwright CLIとしてのリブランディングと、MCPサーバー版との明確な棲み分けを発表。
* **2025-12-XX**: ダッシュボード機能 (`playwright-cli show`) の追加。セッション管理機能の強化。

(出典: [GitHub Releases](https://github.com/microsoft/playwright-cli/releases))

## **16. 類似ツールとの比較**

<!--
【ガイドライン】
- 3-5個の類似ツールと比較
- **機能比較表（星取表）**と**詳細比較**の2つの観点で記述する
-->

### **16.1 機能比較表 (星取表)**

| 機能カテゴリ | 機能項目 | Playwright CLI | Selenium |
|:---:|:---|:---:|:---:|
| **AI連携** | トークン効率 | ◎<br><small>CLI+Skills</small> | ×<br><small>非対応</small> |
| **操作性** | 導入容易性 | ◎<br><small>npm install</small> | △<br><small>Driver管理必要</small> |
| **機能** | セッション管理 | ◎<br><small>永続化対応</small> | △<br><small>手動実装</small> |
| **用途** | コーディング | ◎<br><small>エージェント向け</small> | △<br><small>従来のテスト</small> |

### **16.2 詳細比較**

<!--
【ガイドライン】
- 定性的な違いや、どのようなユーザーに向いているかを記述
-->

| ツール名 | 特徴 | 強み | 弱み | 選択肢となるケース |
|---------|------|------|------|------------------|
| **Playwright CLI** | AIエージェントが「スキル」として使うためのCLI。 | 軽量、高速、トークン節約。エージェントとの相性が抜群。 | 複雑なプログラム的制御は苦手。 | Claude Code等のコーディングエージェントにブラウザ操作をさせたい場合。 |
| **Selenium** | 歴史あるブラウザ自動化フレームワーク。 | 言語バインディングが豊富で、レガシーシステムにも対応。 | AI連携の標準機能がなく、動作も比較的重い。 | 古いシステムのテストや、特定の言語（Java等）での実装が必須の場合。 |

## **17. 総評**

<!--
【ガイドライン】
- 総合評価、推奨チーム、選択ポイントの3項目を必ず含める
- 客観的で中立的な評価を心がける
-->

* **総合的な評価**:
  Playwright CLIは、AIコーディングエージェント時代の新しい標準ツールです。Playwrightの強力なブラウザ操作能力を、AIが扱いやすいCLI形式で提供することで、開発者の生産性を大きく向上させます。特に「CLI + Skills」というアプローチは、今後のエージェント活用の主流になる可能性を秘めています。
* **推奨されるチームやプロジェクト**:
  Claude CodeやGitHub Copilot CLIを活用している開発チーム、およびAIを使ったE2Eテストの自動生成・実行に取り組んでいるQAチームに強く推奨します。
* **選択時のポイント**:
  AIエージェントにブラウザ操作をさせたい場合、まずはこのPlaywright CLIを試すべきです。より複雑な連携が必要な場合にのみ、Playwright MCPやフルスペックのPlaywrightライブラリを検討すると良いでしょう。