cdpilot

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

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

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

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

Почему cdpilot?

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

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

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

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

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

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

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

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

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

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

Почему Brave?

cdpilot использует Brave Browser в качестве движка. Вот почему:

TL;DR: Brave = мощь Chrome + встроенная конфиденциальность + меньше лишнего. Идеально для автоматизации.

cdpilot также работает с Chrome и Chromium в качестве резервных вариантов. Brave рекомендуется, но не обязателен.

Установка

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

# Or install globally
npm i -g cdpilot

Требования: Node.js 18+ и один из браузеров: Brave Browser, 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

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

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 (остается включенным во время всей сессии ИИ, как оранжевое свечение Claude)

• [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 — делайте что хотите.