
tacosyhorchata/pilot
Browser automationЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Расширение 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 находится на переднем плане, вкладка заметно активна или работник службы расширения свежий.
Как это работает
- **Pilot работает как MCP-сервер ** — Claude Code, Cursor или любой MCP-клиент подключается через stdio
- Первый пилотный процесс становится брокером 3Последние пилотные процессы связаны с клиентами-брокерами
- Каждая сессия получает изолированный нативный контекст/страницу браузера
- Скриншоты получены от 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)
- Pilot runs as an MCP server — Claude Code, Cursor, or any MCP client connects via stdio
- The first Pilot process becomes the broker on localhost
- Later Pilot processes connect as broker clients
- Each session gets an isolated native browser context/page
- 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 |
Установка
npx -y pilot-mcpКонфигурация
{
"mcpServers": {
"pilot": {
"command": "npx",
"args": ["-y", "pilot-mcp"],
"env": { "PILOT_PROFILE": "standard" }
}
}
}