qz CLI
Расширение Chrome с CLI, MCP и скиллом: Claude Code и Codex поручают qz веб-задачу, он выполняет ее в вашем браузере
- 220 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Задача идет в вашем Chrome с действующими входами и куки и может выполнять на сайтах любые доступные вам действия
- Содержимое страниц передается выбранной вам модели, а агент из терминала может запускать задачи без вашего участия
Установка
- Работает в
Ручная установка
npx skills add alibaba/qz-browser-agent -gСначала поставьте расширение qz в Chrome. Затем выполните npx qz-browser-agent@latest connect для сопряжения, нужен Node.js 22 или новее.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Задача идет в вашем Chrome с действующими входами и куки и может выполнять на сайтах любые доступные вам действия
- Содержимое страниц передается выбранной вам модели, а агент из терминала может запускать задачи без вашего участия
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
qz работает как расширение Chrome с боковой панелью. Задачу формулируют одной фразой, и qz выполняет ее на сайтах, где вы уже вошли в аккаунт: ищет и сопоставляет данные из нескольких источников, собирает таблицы, файлы и отчеты со ссылками на источники. Модель подключается своя: DeepSeek, OpenAI, Claude, а для аккаунта ChatGPT есть вход через OpenAI Codex без ключа API. Для других агентов проект выпускает пакет `qz-browser-agent` на npm с командной строкой и MCP-сервером, а также скилл `skills/qz-browser-agent/SKILL.md`. Агент, например Claude Code или Codex, ставит скилл, один раз выполняет `connect` для сопряжения с браузером и дальше передает веб-задачу qz целиком вместо отдельных кликов. Ход выполнения виден в боковой панели, а вмешаться или остановить задачу можно в любой момент. Qz запускает несколько задач параллельно, а каждая может порождать подзадачи. Удачно выполненную задачу можно сохранить как скилл фразой «Save this as a Skill» и повторить одной фразой.
Для кого. Тем, кто просит Claude Code или Codex собрать данные с сайтов за логином или сравнить десяток источников и не хочет настраивать для этого отдельный безголовый браузер.
Подходит, если
- Нужна таблица сравнения с источниками: модели, тарифы или характеристики с разных сайтов
- Данные лежат за логином, а ваш обычный Chrome уже держит нужную сессию
- Еженедельный отчет, например список быстрорастущих репозиториев, надо один раз выполнить и сохранить как скилл
- Агенту в терминале нужен браузер, при этом вы хотите видеть каждый его шаг и иметь возможность остановить
- Исследование большое, и его выгодно разбить на параллельные подзадачи
Не подходит, если
- Агент работает в облачной оболочке: CLI запускают на машине, где стоит Chrome с расширением, а облако до настольного браузера не дотянется
- Версия Node.js ниже 22: для сопряжения и CLI она требуется
- Нужен безголовый браузер на сервере без пользователя: qz рассчитан на видимый Chrome и боковую панель
- Страницы нельзя передавать модели из-за требований к данным: содержимое уходит выбранной вами модели
Пример запроса к агенту
Используй qz: сравни открытые языковые модели, вышедшие за последние полгода, в таблице с датой выхода, размером, длиной контекста, лицензией и источникамиОграничения
- Для CLI и сопряжения нужен Node.js 22 или новее. Агент и браузер должны работать на одной машине.
- Расширение ставится из Chrome Web Store или вручную из архива релиза через режим разработчика. Автоматический запуск Chrome при сопряжении зависит от выбранного профиля.
- Нужен ключ API выбранного провайдера, а у OpenAI Codex вход идет через аккаунт ChatGPT.
- Расширение работает с вашими сессиями и куки, поэтому на сайтах, где вы вошли, задача может выполнить любые доступные вам действия.
Как отключить. Отключите или удалите расширение qz на странице `chrome://extensions`. Скилл уберите, удалив его папку из каталога скиллов агента. Если CLI ставили глобально, выполните `npm uninstall --global qz-browser-agent`.
Частые вопросы
Как подключить qz к Claude Code или Codex?
Установите расширение в Chrome, затем выполните `npx skills add alibaba/qz-browser-agent -g` и `npx qz-browser-agent@latest connect`. После сопряжения скажите агенту: «Используй qz для этой задачи». Для клиентов MCP команда `npx qz-browser-agent@latest mcp` выдает HTTP-адрес сервера.
Куда уходят мои данные при работе qz?
По описанию проекта, данные задач хранятся локально, а содержимое страниц передается только выбранной вами модели. Провайдера и ключ вы задаете сами в настройках.
Можно ли поставить расширение без Chrome Web Store?
Да. Скачайте архив из последнего релиза, распакуйте, откройте `chrome://extensions`, включите режим разработчика и выберите папку `qz-browser-agent-extension` через Load unpacked.
Чем qz отличается от Playwright MCP?
Playwright MCP отдает агенту отдельные действия браузера, а в qz целую задачу ставят одной фразой, и она идет в вашем Chrome с вашими входами. Сравнительная таблица в README составлена самим автором.
Какие модели можно подключить?
Своих провайдеров, например DeepSeek, OpenAI и Claude, с ключом API. Для аккаунта ChatGPT есть вход через OpenAI Codex без ключа. Выбор делается в настройках расширения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыШесть скиллов к OpenCLI: агент читает, ищет и публикует на десятках сайтов через ваш Chrome и чинит адаптеры.
Агент работает в вашем настоящем Chrome с уже выполненными входами: CLI, MCP и расширение с отдельной группой вкладок
Скилл подключает агента к вашему Chrome через расширение и CLI для чтения страниц, управления вкладками и проверки действий.
MCP-сервер и расширение Chrome дают агенту 22 инструмента для вашего браузера с входами и проверкой каждого действия.
CLI и MCP-сервер, через которые агент управляет вашим настоящим Chrome с сохраненными входами: 103 команды к 36 сайтам и автоматизация браузера
Скилл и CLI от Browser Use: агент управляет вашим настоящим Chrome через DevTools Protocol, под вашей учетной записью, и сам дописывает недостающие функции
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| qz (эта карточка) | нет | 220 | ||
| Playwright MCP | да | не нужна | 39 570 | отдает агенту отдельные действия браузера, а qz принимает задачу целиком и выполняет ее в видимом Chrome пользователя |
| agent-browser | да | не нужна | 50 530 | быстрый CLI на Rust со снимками доступности, а qz работает как расширение с боковой панелью и своей моделью |
Коротко о README
README показывает расширение на примерах запросов со скриншотами: поездка, сравнение моделей, сохранение скилла, параллельное исследование и передача задачи из агента. Дальше быстрый старт из четырех шагов, ручная установка без Chrome Web Store, раздел про подключение внешних агентов через скилл и `connect`, а также сравнительная таблица с другими браузерными агентами.