remorses/playwriter

귀하의 에이전트가 CLI나 MCP를 통해 직접 크롬을 제어하도록 하세요. 로그인, 확장 프로그램, 쿠키 — 모두 이미 존재합니다.

다른 브라우저 MCP들은 로그인도, 확장 기능도 없고, 봇 탐지기에 즉시 감지되고, 메모리가 두 배로 늘어난 새로운 크롬을 생성합니다. Playwriter는 대신 당신의 실행 중인 브라우저에 연결됩니다. 하나의 크롬 확장 프로그램, 완전한 Playwright API, 이미 로그인된 모든 것.

설치

1. Chrome 웹 스토어에서 확장 프로그램 설치

2. 탭에서 확장 프로그램 아이콘을 클릭→ 연결 시 초록색으로 변함

3. CLI 설치 후 브라우저 자동화 시작:

4. 에이전트가 Playwriter 사용법을 알 수 있도록 스킬을 설치하세요:

퀵 스타트

팁: -e에는 항상 따옴표를 사용해 jon 코드에서 bash가 $, 백틱, \를 해석하지 못하게 하세요. JS 내 문자열에는 쌍따옴표를 사용하세요.

CLI 사용

각 세션은 격리 상태를 가집니다. 브라우저 탭은 세션 간에 공유됩니다.

기본 page는 없습니다. 직접 탭을 만들어 state에 저장하세요. 사용자가 이미 열었던 탭을 사용하려면 URL로 찾아보세요:

탭 그룹

로컬 확장 세션은 기본적으로 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"))'