remorses/playwriter

あなたのエージェントにCLIやMCPを使って自分のChromeを管理させましょう。ログイン情報、拡張機能、クッキーはすべてすでに存在しています。

他のブラウザMCPは新しいChromeをスポーンさせます — ログインなし、拡張機能なし、ボット検出に即座にフラグを立てられ、メモリも倍になります。Playwriterは代わりにあなたの実行中のブラウザに接続します。Chrome拡張機能は1つ、Playwright APIはフルで、すでにログインしているすべての機能が使えます。

設置

1. Chrome Web Storeから拡張機能をインストールする

2. タブの拡張機能アイコンをクリックすると→接続時に緑色に変わります

3. CLIをインストールし、ブラウザの自動化を開始します:

4. エージェントがPlaywriterの使い方を知ってもらえるようにスキルをインストールします:

クイックスタート

ヒント: -eは必ずシングルクォートで使い、bashが$]、バックティック、\]をJSコード内で解釈しないようにしてください。JS内の文字列にはダブルクォートを使いましょう。

CLIの使用例

各セッションは孤立状態を持っています。ブラウザタブはセッション間で共有されています。

デフォルトのpageはありません。自分専用のタブを作成し、stateに保存してください。ユーザーがすでに開いたタブを使うには、URLで検索してください:

タブグループ

ローカル拡張機能セッションはデフォルトでplaywriterという名前のChromeタブグループを使用します。リモートコントロールセッションは開いたタブをremoteに配置します。

Other browser MCPs spawn a fresh Chrome — no logins, no extensions, instantly flagged by bot detectors, double the memory. Playwriter connects to your running browser instead. One Chrome extension, full Playwright API, everything you’re already logged into.

Installation

1. Install Extension from Chrome Web Store

2. Click extension icon on a tab → turns green when connected

3. Install the CLI and start automating the browser:

   npm i -g playwriter
   playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'
   

4. Install the skill so your agent knows how to use Playwriter:

   npx -y skills add https://playwriter.dev -g -y
   

Quick Start

playwriter browser start  # starts Chrome for Testing/Chromium with bundled Playwriter extension
playwriter session new  # creates stateful sandbox, outputs session id (e.g. 1)
playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'
playwriter -s 1 -e 'console.log(await snapshot({ page: state.page }))'
playwriter -s 1 -e 'await state.page.locator("aria-ref=e5").click()'

Tip: Always use single quotes for -e to prevent bash from interpreting $, backticks, and \ in your JS code. Use double quotes for strings inside the JS.

CLI Usage

Each session has isolated state. Browser tabs are shared across sessions.

# Browser management
playwriter browser start             # auto-finds Chrome for Testing or Chromium
playwriter browser start /path/to/browser-binary

# Session management
playwriter session new              # creates stateful sandbox, outputs id (e.g. 1)
playwriter session new --tab-group agent1 --tab-group-color blue
playwriter session update 1 --tab-group research
playwriter session list             # show sessions + state keys + group
playwriter session reset        # fix connection issues

# Execute (always use -s)
playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'
playwriter -s 1 -e 'await state.page.click("button")'
playwriter -s 1 -e 'console.log(await state.page.title())'

There is no default page. Create your own tab and store it in state. To use a tab the user already opened, find it by URL:

playwriter -s 1 -e 'state.page = context.pages().findLast((p) => p.url().includes("github.com"))'