PinchTab CLI
Управление Chrome для ИИ-агентов: локальный HTTP-сервер на Go с CLI, MCP, профилями и скиллом для Claude Code
- 10 577 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает управление настоящим Chrome вместе с профилями, куки и сохраненными входами
- Режим со скрытием отпечатка браузера и обход проверок на сайтах может нарушать правила этих сайтов и закон
- Открытый наружу порт 9867 или MCP дает постороннему полный контроль над браузером
Установка
- Работает в
Ручная установка
curl -fsSL https://pinchtab.com/install.sh | bashСкрипт установки из README. Прочитайте его перед запуском; без скрипта подойдут Homebrew или npm.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает управление настоящим Chrome вместе с профилями, куки и сохраненными входами
- Режим со скрытием отпечатка браузера и обход проверок на сайтах может нарушать правила этих сайтов и закон
- Открытый наружу порт 9867 или MCP дает постороннему полный контроль над браузером
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PinchTab — HTTP-сервер на Go весом около 30 МБ, который управляет установленным Chrome или Chromium и отдает агенту компактное описание страницы. Текст страницы занимает примерно 800 токенов, что в 5–13 раз дешевле скриншотов, а элементы получают устойчивые метки вроде `e5`, которые живут до перехода на новый документ. Командами `pinchtab nav`, `snap`, `click` и `text` браузером управляют из терминала, а то же самое доступно через HTTP API с токеном и через MCP-сервер `pinchtab mcp`. Сервер держит несколько изолированных экземпляров Chrome с профилями: в профиле хранятся авторизация, куки и расширения, и агент выбирает нужный по имени. Команда `pinchtab audit` обходит сайт и собирает отчет со скриншотами, ошибками консоли, битыми ресурсами, оценкой доступности и Core Web Vitals, а `pinchtab compare` сравнивает две версии сайта. Пакет npm сам копирует скилл `pinchtab` в каталоги агентов.
Для кого. Разработчикам и тестировщикам, которые дают Claude Code, Cursor или Codex управлять браузером на своем компьютере и следят за расходом токенов.
Подходит, если
- Агент ходит по документации и сайтам, и скриншоты съедают бюджет токенов, а текстовый снимок страницы обходится дешевле
- Для задачи нужен залогиненный профиль: агент открывает рабочий профиль и скачивает еженедельный отчет
- Перед релизом надо сравнить боевой сайт со стейджингом и остановить CI при расхождении
- Требуется аудит сайта по карте сайта с отчетом `report.json` и скриншотами
- Несколько агентов работают параллельно, и каждому нужен свой изолированный экземпляр Chrome
Не подходит, если
- Сервер собираются открыть в интернет или нескольким пользователям: он рассчитан на одного оператора на своей машине
- Нужен готовый облачный браузер: PinchTab ставится и поддерживается вами сам
- Нужен браузер вне Chrome и Chromium: PinchTab управляет только ими
Пример запроса к агенту
Открой через PinchTab страницу нашей документации, сделай снимок структуры и найди, где описан вход по токенуОграничения
Панель, HTTP API, MCP-сервер и удаленные интеграции — это привилегированные каналы управления для доверенного оператора, и открывать их наружу нельзя. По умолчанию сервер слушает `127.0.0.1`, чувствительные группы эндпоинтов выключены, а защита от внедрения инструкций разрешает только локально размещенные сайты; расширять этот список значит осознанно снижать безопасность. Лучше всего проверены macOS и Linux, на Windows поддержка ограничена и лучше запускать `pinchtab server` напрямую. На macOS для автоматизации стоит держать отдельный браузер «Chrome for Testing».
Как отключить. Остановите фоновый процесс PinchTab средствами системы и удалите установку: `npm uninstall -g pinchtab` либо `brew uninstall pinchtab`. Скилл удаляется из `~/.claude/skills`, `~/.cursor/skills` и других каталогов агентов вручную.
Частые вопросы
Как поставить PinchTab?
Выполните `curl -fsSL https://pinchtab.com/install.sh | bash`, `brew install pinchtab/tap/pinchtab` или `npm install -g pinchtab`. Затем `pinchtab daemon install` запустит фоновый сервер на порту 9867 с Chrome без окна.
Как подключить PinchTab как MCP-сервер?
Добавьте в конфигурацию клиента сервер с командой `pinchtab` и аргументом `mcp`, для Claude Desktop, Cursor и VS Code это три похожих JSON-блока. Перед этим должен работать `pinchtab server` или `pinchtab bridge`.
Почему агент не открывает внешние сайты?
По умолчанию защита от внедрения инструкций пускает его только на локально размещенные сайты. Расширить список можно в настройках, но тогда вредоносные страницы получают больше возможностей влиять на агента.
Чем PinchTab экономит токены?
Он отдает текст страницы и дерево доступности, примерно 800 токенов на страницу, вместо скриншотов, которые дороже в 5–13 раз. Метки элементов вроде `e5` переживают смену фильтра и глубины.
Умеет ли он аудит и сравнение сайтов?
Да. `pinchtab audit` пишет `report.json` и папку скриншотов, а `pinchtab compare` с флагом `--fail-on-diff` годится как проверка в CI.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыАгент работает в вашем настоящем Chrome с уже выполненными входами: CLI, MCP и расширение с отдельной группой вкладок
Скилл для Amp, Claude Code и Cursor: агент управляет вашим живым Chrome с открытыми вкладками и входами в аккаунты через один переключатель отладки
MCP-сервер и расширение Chrome дают агенту 22 инструмента для вашего браузера с входами и проверкой каждого действия.
CLI и скилл для управления Chrome из агента: снимок страницы, клики, консоль, сеть и аудит производительности в экономном выводе
CLI и MCP-сервер, через которые агент управляет вашим настоящим Chrome с сохраненными входами: 103 команды к 36 сайтам и автоматизация браузера
Консольный браузер mb для агентов: переход по адресу, снимок страницы, клики, формы, скриншоты и запись экрана
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| PinchTab (эта карточка) | да | 10 577 | ||
| agent-browser | да | не нужна | 50 530 | CLI для управления браузером без аудита сайтов и сравнения версий |
| Playwright MCP | да | не нужна | 39 570 | MCP-сервер Playwright без профилей, демона и экономии токенов на снимках |
Коротко о README
README объясняет, что PinchTab — отдельный сервер, а не расширение, и подчеркивает локальную модель безопасности. Затем идут сценарии: безголовая и обычная навигация, аудит сайтов, изоляция в Docker и распределенные запуски, потом установка, скилл, использование через CLI и HTTP API.