remorses/playwriter

Позвольте вашим агентам управлять вашим собственным Chrome через CLI или MCP. Ваши логины, расширения, куки — уже там.

Другие браузерные MCP создают свежий Chrome — нет логинов, нет расширений, мгновенно отмечается детекторами ботов, удваивает память. Playwriter подключается к вашему запущенному браузеру. Одно расширение для Chrome, полный API Playwright — всё, в что вы уже вошли.

Установка

1. Установка расширения из веб-магазина Chrome

2. Нажмите на значок расширения на вкладке→ которая становится зелёной при подключении

3. Установите CLI и начните автоматизировать браузер:

4. Установите навык, чтобы ваш агент знал, как пользоваться Playwriter:

Быстрый старт

Совет: Всегда используйте одиночные кавычки для -e, чтобы предотвратить интерпретацию bash $, обратные тики и \ в вашем JS-коде. Используйте двойные кавычки для строк внутри JS.

Использование CLI

Каждая сессия имеет изолированное состояние. Вкладки браузера общие между сессиями.

По умолчанию нет page. Создайте свою вкладку и храните её в state. Чтобы использовать вкладку, которую пользователь уже открыл, найдите её по URL:

Группы вкладок

Локальные сессии расширений по умолчанию используют группу вкладок** в Chrome с названием playwriter. Сессии удалённого управления перемещают открытые вкладки в 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"))'