cdpilot

Автоматизация браузера из терминала без зависимостей. Одна команда, полный контроль.

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

npx cdpilot launch    # Start browser with CDP
npx cdpilot go https://example.com
npx cdpilot shot      # Take screenshot

Никаких файлов конфигурации. Никакого шаблонного кода. Просто npx и вперед.

Related MCP server: Scout

Почему cdpilot?

ИИ-агентам и разработчикам нужен контроль над браузером, который просто работает:

• Нулевая конфигурация — npx cdpilot launch запускает изолированную сессию браузера

• Нулевые зависимости — Никакого Puppeteer, Playwright или Selenium. Чистый CDP через HTTP

• 40+ команд — Навигация, клики, ввод текста, скриншоты, сеть, консоль, доступность и многое другое

• Дружелюбен к ИИ-агентам — Разработан для Claude, GPT, Gemini и любых рабочих процессов с использованием инструментов LLM

• Изолированные сессии — Ваш личный браузер остается нетронутым. cdpilot работает в собственном профиле

• Визуальная обратная связь — Зеленое свечение, визуализация курсора, эффекты кликов и отображение нажатий клавиш держат вас в курсе во время автоматизации

• Изоляция проектов — Каждый проект автоматически получает свой экземпляр браузера и порт, никаких конфликтов

• Предупреждение об ИИ-контроле — Красное уведомление появляется при наведении курсора во время активной автоматизации

• Приоритет конфиденциальности — Всё работает локально. Никакие данные не покидают вашу машину

Выбор браузера (автоматический подбор с учетом нагрузки)

cdpilot выбирает подходящий браузер для ваших задач. auto (по умолчанию) — это политика по двум осям: нагрузка расширений × стабильность платформы:

Переопределить в любой момент:

cdpilot browser            # show current pick + reason
cdpilot browser vivaldi    # pin to Vivaldi
cdpilot browser auto       # restore smart default

Почему такое разделение?

• Chrome 147+ молча отключает --load-extension для распакованных расширений (без ошибок и предупреждений). Проверено — chrome://extensions показывает 0 элементов.

• Vivaldi, Brave, Edge, Chromium поддерживают --load-extension (проверено).

• В macOS 26 (Tahoe) Brave 1.89 детерминированно падает через ~7 минут работы (SIGTRAP в ThreadPoolForegroundWorker). cdpilot определяет ОС и автоматически понижает приоритет Brave до выхода исправленного релиза.

Каждый браузер получает свой изолированный профиль (~/.cdpilot/.../profile-vivaldi и т.д.), поэтому переключение никогда не вызывает повреждение настроек.

Установка

# Use directly (no install needed)
npx cdpilot <command>

# Or install globally
npm i -g cdpilot

Требования: Node.js 18+ и один из браузеров: Brave, Google Chrome или Chromium.

Первичная настройка

npx cdpilot setup     # Auto-detect browser, create isolated profile
npx cdpilot launch    # Start browser with CDP enabled
npx cdpilot status    # Check connection

Команды

Навигация и контент

cdpilot go <url>              # Navigate to URL
cdpilot content               # Get page text content
cdpilot html                  # Get page HTML
cdpilot shot [file]           # Take screenshot (PNG)
cdpilot pdf [file]            # Save page as PDF

Взаимодействие

cdpilot click <selector>      # Click element
cdpilot type <selector> <text># Type into input
cdpilot fill <selector> <val> # Set input value (React-compatible)
cdpilot submit <form>         # Submit form
cdpilot hover <selector>      # Hover element
cdpilot keys <combo>          # Keyboard shortcut (ctrl+a, enter, etc.)
cdpilot scroll-to <selector>  # Scroll element into view
cdpilot drag <from> <to>      # Drag and drop

Отладка

cdpilot console [url]         # Capture console logs
cdpilot network [url]         # Monitor network requests
cdpilot debug [url]           # Full diagnostic (console+network+perf+shot)
cdpilot perf                  # Performance metrics
cdpilot eval <js>             # Execute JavaScript

Управление вкладками

cdpilot tabs                  # List open tabs
cdpilot new-tab [url]         # Open new tab
cdpilot switch-tab <id>       # Switch to tab
cdpilot close-tab [id]        # Close tab
cdpilot close                 # Close active tab

Управление сетью

cdpilot throttle slow3g       # Simulate slow 3G
cdpilot throttle fast3g       # Simulate fast 3G
cdpilot throttle offline      # Go offline
cdpilot throttle off          # Back to normal
cdpilot proxy <url>           # Set proxy
cdpilot proxy off             # Remove proxy

Перехват запросов

cdpilot intercept block <pattern>                    # Block requests
cdpilot intercept mock <pattern> <json-file>         # Mock responses
cdpilot intercept headers <pattern> <header:value>   # Add headers
cdpilot intercept list                               # List active rules
cdpilot intercept clear                              # Clear all rules

Эмуляция устройств

cdpilot emulate iphone        # iPhone emulation
cdpilot emulate ipad          # iPad emulation
cdpilot emulate android       # Android emulation
cdpilot emulate reset         # Back to desktop

Геолокация

cdpilot geo istanbul          # Set location to Istanbul
cdpilot geo london            # Set location to London
cdpilot geo 41.01 28.97       # Custom coordinates
cdpilot geo off               # Remove override

Доступность

cdpilot a11y                  # Full accessibility tree
cdpilot a11y summary          # Quick summary
cdpilot a11y find <role>      # Find elements by ARIA role

Управление сессиями

cdpilot session               # Current session info
cdpilot sessions              # List all sessions
cdpilot session-close [id]    # Close session

Дополнительно

cdpilot cookies [domain]      # List cookies
cdpilot storage               # localStorage contents
cdpilot upload <sel> <file>   # Upload file to input
cdpilot multi-eval <js>       # Execute JS in all tabs
cdpilot headless [on|off]     # Toggle headless mode
cdpilot frame list            # List iframes
cdpilot dialog auto-accept    # Auto-accept dialogs
cdpilot permission grant geo  # Grant geolocation

Стелс и CAPTCHA

Слой защиты от отпечатков (fingerprinting) без зависимостей — патчит navigator.webdriver, chrome.runtime, плагины (правильное наследование PluginArray), WebGL vendor/renderer, разрешения, аппаратную конкурентность и конструктор Worker. Внедряется через Page.addScriptToEvaluateOnNewDocument до запуска любых скриптов страницы. Отключено по умолчанию; включается опционально.

cdpilot stealth on            # enable fingerprint patches (opt-in)
cdpilot stealth off           # disable (default)
cdpilot stealth status        # show which patches are applied

cdpilot captcha-check         # JSON detection of Turnstile/hCaptcha/reCAPTCHA/
                              # DataDome/PerimeterX/Arkose/GeeTest. Exit 0/3
cdpilot captcha-wait [sec]    # block until user solves (interactive)
                              # or poll with JSON stream (non-interactive)

Проверено на публичных панелях обнаружения ботов:

• bot.sannysoft.com: 24/24 PASS (WebDriver, Chrome obj, Plugins as PluginArray, WebGL, PHANTOM_, HEADCHR_, SELENIUM_DRIVER)

• bot.incolumitas.com intoli: 6/6 OK — new-tests: 6/7 OK (один FAIL = присутствие чистого CDP, не может быть исправлено через JS)

• nowsecure.nl (полная проверка Cloudflare): пройдено

• arh.antoinevastel.com/areyouheadless: "You are not Chrome headless"

Надежность

cdpilot browser [name|auto]   # workload-aware browser selection
cdpilot health                # JSON: alive, port, tabs, browser, today's crashes

cdpilot health разработан для shell-мониторов:

until cdpilot health >/dev/null; do cdpilot launch; sleep 2; done

Отображает количество сегодняшних падений Brave из ~/Library/Logs/DiagnosticReports/ на macOS — обнаруживайте деградацию до того, как автоматизация молча остановится.

Использование с ИИ-агентами

cdpilot разработан для вызова ИИ-агентами в качестве инструмента:

Claude Code (MCP)

{
  "mcpServers": {
    "cdpilot": {
      "command": "npx",
      "args": ["cdpilot", "mcp"]
    }
  }
}

Любой LLM (использование инструментов)

{
  "name": "browser",
  "description": "Control a browser via CDP",
  "parameters": {
    "command": "go https://example.com"
  }
}

Python (subprocess)

import subprocess
result = subprocess.run(["npx", "cdpilot", "go", url], capture_output=True, text=True)
print(result.stdout)

Переменные окружения

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

┌─────────────┐     HTTP/WebSocket      ┌──────────────┐
│  cdpilot │ ◄──────────────────────► │ Brave/Chrome │
│   (CLI)     │    Chrome DevTools       │  (CDP mode)  │
└─────────────┘     Protocol             └──────────────┘
       │                                        │
       │  Zero dependencies                     │  Isolated profile
       │  Pure HTTP + WebSocket                 │  Separate from your
       │  ~2500 lines, single file              │  personal browser
       └────────────────────────────────────────┘

Никакого Puppeteer. Никакого Playwright. Никакого Selenium. Только прямое общение по CDP.

Сравнение

Монетизация / Pro (скоро)

CLI cdpilot есть и всегда будет бесплатным и с открытым исходным кодом (MIT).

Будущие платные предложения:

• cdpilot cloud — Удаленные экземпляры браузера, локальный браузер не нужен

• Панель управления командой — Общие сессии, журналы аудита, аналитика использования

• Приоритетная поддержка — Прямая помощь для корпоративных интеграций

Безопасность

• Изолированный профиль браузера — cdpilot работает в ~/.cdpilot/profile, отдельно от вашего основного браузера. Ваши куки, пароли и история никогда не будут раскрыты.

• Нет доступа к произвольным файлам — Имена файлов скриншотов MCP очищаются и ограничены директорией скриншотов. Обход путей заблокирован.

• Безопасные CSS-селекторы — Все селекторы, передаваемые в querySelector, экранируются в JSON для предотвращения инъекций.

• Нет сетевого доступа — CDP слушает только 127.0.0.1. Удаленные подключения по умолчанию невозможны.

• Нет зависимостей — Нулевые зависимости npm/Python означают нулевую поверхность атаки на цепочку поставок.

Нашли уязвимость? Пожалуйста, напишите напрямую сопровождающему, вместо открытия публичного тикета.

Дорожная карта

Единственный браузерный MCP со встроенными тестовыми утверждениями. Вот что мы выпустили и что будет дальше:

Выпущено

• [x] 60+ CLI команд (навигация, клик, заполнение, скриншот, PDF, консоль, сеть...)

• [x] MCP-сервер для интеграции с ИИ-агентами (Claude Code, Cursor и др.)

• [x] 10 встроенных тестовых утверждений — assert, assert-url, assert-title, assert-count, assert-value, assert-attr, assert-visible/hidden, wait-for, check (batch), screenshot-diff

• [x] Снимок дерева доступности (a11y-snapshot) — структурированные данные со ссылками @ref, в 500 раз меньше токенов, чем скриншоты

• [x] Эффективные скриншоты — обрезка на уровне элементов (в 13 раз меньше), контроль качества JPEG, выбор формата

• [x] Визуальный фоллбэк (describe) — доступность + скриншот + текст в одном вызове

• [x] Аннотированные скриншоты — наложение значков @N на интерактивные элементы

• [x] Авто-ожидание — на основе MutationObserver, 5-секундное автоматическое ожидание элементов

• [x] Пакетные команды — передача JSON-массивов через stdin для многошаговой автоматизации

• [x] Система визуальной обратной связи (постоянное зеленое свечение, курсор, эффекты, отображение клавиш)

• [x] Предупреждение об ИИ-контроле (красное предупреждение при взаимодействии пользователя во время автоматизации)

• [x] Изоляция браузера для проектов (каждый проект получает свой порт + профиль)

• [x] Мастер предварительной настройки (автоматическая установка зависимостей при первом запуске)

• [x] Постоянное свечение MCP (остается включенным во время всей сессии ИИ)

• [x] Система DevExtension (внедрение JS без магазина расширений)

• [x] Умные команды — smart-click, smart-fill, smart-select — взаимодействие по видимому тексту, без CSS-селекторов, без LLM

• [x] Извлечение данных (extract) — структурированные данные DOM в текстовом, JSON или списочном формате

• [x] Наблюдение за страницей (observe) — список всех интерактивных элементов с доступными действиями

• [x] Запуск скриптов (run) — выполнение файлов скриптов .cdp с отчетами о прохождении

Скоро

• [ ] Поддержка iframe и Shadow DOM — взаимодействие с элементами внутри iframe и shadow roots

• [ ] Запись и воспроизведение сессий — запись сессий браузера и их детерминированное воспроизведение

• [ ] Стелс-режим (Pro) — человекоподобное движение мыши/печать, защита от отпечатков, решение CAPTCHA

• [ ] cdpilot Cloud — API для хостинга сессий браузера, REST + WebSocket MCP эндпоинт

• [ ] Расширение для Chrome — использование cdpilot из любого браузера без CLI

• [ ] Аудит производительности — Core Web Vitals (LCP, CLS, INP) через домен CDP Performance

• [ ] Аудит доступности WCAG — автоматизированная отчетность о соответствии требованиям доступности

• [ ] Режим навыков Claude Code — запуск как навыка .claude/skills/ в дополнение к MCP

Есть идея? Откройте тикет или отправьте PR!

Вклад

git clone https://github.com/mehmetnadir/cdpilot.git
cd cdpilot
npm install
npm test

PR приветствуются! Пожалуйста, сначала прочитайте CONTRIBUTING.md.

Лицензия

MIT — делайте что хотите.