Actor Playwright MCP

このプロジェクトはPlaywright - MCPを通じて、クラウドベースのサーバーレスPlaywrightブラウザサービスを提供し、Playwrightのアクセシビリティツリーを利用してピクセル入力ではなく、高速で軽量なウェブ自動化操作を実現します。構造化データのインタラクションをサポートし、ウェブナビゲーション、フォーム入力、データ抽出、自動化テストなどのシーンに適しています。

ブラウザ自動化開発者ツール #ブラウザ自動化 #サーバーレス #構造化データ #ウェブページインタラクション .TypeScript

スコア : 2ポイント

ダウンロード数 : 23

更新時間 : 2025-04-28

Playwright MCPサーバーとは？

これはPlaywrightに基づくModel Context Protocolサーバーで、LLMにブラウザ自動化機能を提供します。ピクセル入力ではなくアクセシビリティツリーを通じてウェブページとインタラクションし、AIがウェブページの構造を理解して操作を実行できるようにします。

Playwright MCPサーバーの使い方は？

1. MCPサーバーを起動する 2. APIを通じて指令を送信する 3. 構造化されたレスポンスを受け取る 4. スナップショットに基づいて次の操作を決定する

適用シーン

自動化テスト、データ収集、AIアシスタントなど、プログラムによるウェブページインタラクションが必要なシーンに適しています。

主要機能

スナップショットインタラクションアクセシビリティツリーを通じてウェブページの構造化表現を取得します。

ビジュアルインタラクション座標に基づく画面操作をサポートします。

タブ管理複数のタブの作成/切り替え/閉じるを行います。

利点と制限

利点

軽量かつ高速：画像処理ではなく構造化データを使用する

確定的な操作：ビジュアルモデルの曖昧さを回避する

完全な機能：クリック、入力、ドラッグアンドドロップなどの完全なインタラクションをサポートする

制限

純粋な画像コンテンツを処理できない

操作を実行するには要素参照が必要である

動的コンテンツに対するサポートが限られている

使い方

ページのスナップショットを取得する

まず、browser_snapshotを使用して現在のページの構造化表現を取得します。

ターゲット要素を識別する

スナップショットからインタラクションする要素とそのref値を見つけます。

操作を実行する

クリックや入力など、適切なツール関数を使用して操作を行います。

使用例

フォームの自動入力ウェブページのフォームフィールドを自動的に識別して入力します。

データ収集構造化されたページから特定のデータを抽出します。

よくある質問

なぜ要素参照(ref)が必要なのですか？

動的にロードされるコンテンツはどのように処理しますか？

🚀 Playwright コマンドセット

Playwright コマンドセットは、自動化テストやブラウザ操作を効率的に行うための様々なコマンドを提供します。

✨ 主な機能

様々な操作を行うためのコマンドを提供します。
ロールベースの操作、ナビゲーション、キーボード操作、コンソール操作、ファイルアップロードなどの機能があります。

📚 ドキュメント

🔍 ロールベースのコマンド

コマンド	説明	パラメータ
`robot role_name`	指定したロールを使用して後続の操作を実行します。	`role_name`：使用するロール名。
`robot list`	利用可能なすべてのロールをリストします。	なし
`robot remove`	指定したロールを削除します。	`role_name`：削除するロール名。

🔍 ナビゲーションコマンド

コマンド	説明	パラメータ
`navigate url`	指定した URL に移動します。	`url`：目標の URL。
`navigate back`	前のページに戻ります。	なし
`navigate forward`	次のページに進みます。	なし

🔍 キーボードコマンド

コマンド	説明	パラメータ
`keyboard key`	指定したキーを押します。	`key`：押すキー名（例：`ArrowLeft` または `a`）。

🔍 コンソールコマンド

コマンド	説明	パラメータ
`console messages`	すべてのコンソールメッセージを返します。	なし

🔍 ファイルとメディア処理

コマンド	説明	パラメータ
`file_upload paths`	指定したファイルまたは複数のファイルをアップロードします。	`paths`：アップロードするファイルの絶対パスのリスト（単一または複数）。
`pdf_save`	現在のページを PDF ファイルとして保存します。	なし

🔍 ユーティリティ

コマンド	説明	パラメータ
`browser_close`	ブラウザウィンドウを閉じます。	なし
`browser_wait time`	指定した時間（秒単位）待機します。	`time`：待機時間（秒単位）。
`browser_resize width height`	ブラウザウィンドウのサイズを調整します。	`width`：新しい幅（通常はピクセル単位）。 `height`：新しい高さ（通常はピクセル単位）。

🔍 その他のコマンド

コマンド	説明	パラメータ
`system clear`	ターミナル画面またはコンソールウィンドウをクリアします。	なし
`system pause`	スクリプトの実行を一時停止し、ユーザーの入力を待ちます。	`prompt`（オプション）：表示するプロンプトメッセージ。デフォルトは `Press Enter to continue...`。