playwriter について
playwriterは、セッション単位のコマンドラインでブラウザーを操作するスキルです。実行前にドキュメント全体を読む手順と、ページを開く例を示します。
主な機能
- 01セッション単位のブラウザー操作
- 02ページの作成とURLへの移動
- 03コマンド実行前の全ドキュメント確認
活用シーン
- 01ブラウザー自動化セッションの開始
- 02スクリプトによる操作対象ページの表示
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/playwriterを入力して読み込まれたか確認します。
詳細
ドキュメント全体を読む（セッションごとに1回）
セッション内で最初の playwriter コマンドを実行する前に、次を実行してください。
playwriter skill # IMPORTANT! do not use | head here. read in full!
次の内容を含むドキュメント全体が出力されます。
- セッション管理とタイムアウト設定
- セレクター戦略（および避けるべきもの）
- タイムアウトや失敗を防ぐためのルール
- 遅いページや SPA に関するベストプラクティス
- コンテキスト変数、ユーティリティ関数など
この手順を省略しないでください。 タイムアウト、セレクターのルール、ドキュメント全体に記載された落とし穴を理解していないと、以下の例は失敗します。この手順が必要なのはセッションごとに1回だけです。同じセッション内で後続の playwriter コマンドを実行する際に、再度読み込む必要はありません。
出力全体を読んでください。 head、tail、または出力を切り詰めるコマンドにパイプしないでください。重要なルールはドキュメントの冒頭だけでなく、全体に記載されています。
最小限の例（ドキュメント全体を読んだ後）
playwriter session new
playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'
-e 引数には必ずシングルクォートを使用してください。シングルクォートを使うと、JS コード内の $、バッククォート、バックスラッシュが bash に解釈されるのを防げます。JS 内の文字列にはダブルクォートまたはバッククォートのテンプレートリテラルを使用してください。
playwriter が見つからない場合は、npx playwriter@latest または bunx playwriter@latest を使用してください。
コメント
Markdown 対応