TP

tacosyhorchata/pilot

Browser automation

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

32 stars 4 forks Качество 75 Тренд 15MIT

Расширение Chrome + MCP-сервер — агенты ИИ управляют вкладкой в реальном браузере, уже вошедшей в систему

Обзор

Сеансы браузера с поддержкой Native Playwright по умолчанию. Для автоматизации QA не требуется расширение Chrome. - (по умолчанию): изолированные контексты браузера Playwright. Это поддерживаемый путь для параллельной автоматизации QA и надежных скриншотов. - (наследие/отказ): подключается к вашему реальному профилю Chrome, когда вам нужны существующие файлы cookie и сеансы входа в систему. Нативный режим полностью избегает chrome.tabs.captureVisibleTab(), поэтому скриншоты не зависят от того, что Chrome находится на переднем плане, вкладка заметно активна или работник службы расширения свежий. 1. — Claude Code, Cursor или любой MCP-клиент подключается через stdio 2. на локальном хосте 3. 4. 5, а не через API захвата расширений Chrome «Откройте https://example.com, скриншот и суммируйте страницу». Нет установки расширения. Никаких предварительных требований Chrome. Для полных операций в нативном режиме, команд напряжения и проверок очистки см. docs/native-mode.md. Другие инструменты сбрасывают 50K + заголовок на страницу в окно контекста. Пилот держит вещи маленькими:

Обзор (машинный перевод)

Сеансы браузера с поддержкой Native Playwright по умолчанию. Для автоматизации QA не требуется расширение Chrome.

Pilot имеет два бэкэнда браузера:

Нативный режим (по умолчанию): изолированные контексты браузера Playwright. Это поддерживаемый путь для параллельной автоматизации QA и надежных скриншотов. ** Режим расширения** (наследие/отказ): подключается к вашему реальному профилю Chrome, когда вам нужны существующие файлы cookie и сеансы входа в систему.

Нативный режим полностью избегает chrome.tabs.captureVisibleTab(), поэтому скриншоты не зависят от того, что Chrome находится на переднем плане, вкладка заметно активна или работник службы расширения свежий.

Как это работает

  1. **Pilot работает как MCP-сервер ** — Claude Code, Cursor или любой MCP-клиент подключается через stdio
  2. Первый пилотный процесс становится брокером 3Последние пилотные процессы связаны с клиентами-брокерами
  3. Каждая сессия получает изолированный нативный контекст/страницу браузера
  4. Скриншоты получены от Playwright, а не от Chrome

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

###1 Добавить MCP-сервер

Для местного оформления:

###2 Используйте

«Откройте https://example.com, скриншот и суммируйте страницу».

Нет установки расширения.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

pilot — browser automation MCP for AI agents

Native Playwright-backed browser sessions by default. No Chrome extension required for QA automation.

Pilot has two browser backends:

  • Native mode (default): isolated Playwright browser contexts. This is the supported path for parallel QA automation and reliable screenshots.
  • Extension mode (legacy/opt-in): connects to your real Chrome profile when you need existing cookies and logged-in sessions.

Native mode avoids chrome.tabs.captureVisibleTab() entirely, so screenshots do not depend on Chrome being foregrounded, a tab being visibly active, or the extension service worker being fresh.


How it works

AI Agent → MCP Server → Broker on 127.0.0.1:3131 → Native browser session
         (stdio)       (first process owns broker)  (Playwright context/page)
  1. Pilot runs as an MCP server — Claude Code, Cursor, or any MCP client connects via stdio
  2. The first Pilot process becomes the broker on localhost
  3. Later Pilot processes connect as broker clients
  4. Each session gets an isolated native browser context/page
  5. Screenshots come from Playwright, not the Chrome extension capture API

Quick Start

1. Add the MCP server

codex mcp add pilot \
  --env PILOT_BROWSER_MODE=native \
  --env PILOT_PROFILE=full \
  -- npx -y pilot-mcp

For a local checkout:

npm install
npm run build
codex mcp add pilot \
  --env PILOT_BROWSER_MODE=native \
  --env PILOT_PROFILE=full \
  -- node /absolute/path/to/pilot/dist/index.js

2. Use it

“Open https://example.com, take a screenshot, and summarize the page.”

No extension install. No Chrome foreground requirement.

For full native-mode operations, stress commands, and cleanup checks, see docs/native-mode.md.


Lean snapshots

Other tools dump 50K+ chars per page into your context window. Pilot keeps things small:

Other tools:   navigate(58K) → navigate(58K) → answer        = 116K chars
Pilot:         navigate(2K)  → navigate(2K)  → snapshot(9K)  =  13K chars

snapshot_diff shows only what changed between actions — no redundant re-reads.

Less context = faster responses, cheaper API calls, fewer hallucinations.


Pilot vs @playwright/mcp

Pilot @playwright/mcp
Browser Native Playwright context by default; real Chrome via legacy extension New Chromium instance
Auth state Native isolated by default; extension mode can use real Chrome cookies Anonymous — manual setup
Открыть полный README на GitHub

Установка

npx -y pilot-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "pilot": { "command": "npx", "args": ["-y", "pilot-mcp"], "env": { "PILOT_PROFILE": "standard" } } } }