AdsPower CLI: Автоматизація керування браузером з командного рядка

AdsPower офіційно запустив окремий інструмент CLI (інтерфейс командного рядка) .

Завдання, які раніше вимагали натискання клавіш через інтерфейс AdsPower на робочому столі, тепер можна виконати за допомогою однієї інструкції командного рядка. Створення та керування профілем браузера, запуск та завершення роботи браузера, перемикання проксі-сервера, оновлення відбитків пальців, отримання файлів cookie, очищення кешу, керування групами та тегами – все це підтримується безпосередньо з терміналу.

Інтерфейс командного рядка (CLI) працює незалежно від клієнта AdsPower для робочого столу. Він не використовує спільний локальний кеш, ядра браузера чи середовища виконання з основною програмою.

Як встановити

Існує два доступні способи встановлення.

Спосіб 1: Встановлення через npm (рекомендовано для користувачів Node.js)

npm install -g adspower-browser

Після встановлення всі наступні команди доступні та функціонують однаково: adspower-browser , adspower , ads

Спосіб 2: Встановлення безпосередньо

у Windows:

Користувачі Windows також можуть встановити CLI безпосередньо з офіційної сторінки завантаження AdsPower .

irm https://www.adspower.com/install.ps1 | iex

на macOS:

curl -fsSL https://www.adspower.com/install.sh | bash

на Linux:

curl -fsSL https://www.adspower.com/install.sh | bash

Якщо команда не виконується успішно, ви можете завантажити інсталятор локально та запустити його вручну.

Як розпочати

Запустіть командний рядок:

ads start -k <KEY>

Якщо ви вже налаштували змінну середовища ADS_API_KEY, ви можете просто виконати команду: ads start

Приклад: Відкрийте профіль браузера:

ads open-browser <profile_id>

Приклад: Закриття профілю браузера:

ads close-browser <profile_id>

Всього за допомогою трьох команд екземпляр браузера можна повністю запустити та керувати ним.

Короткий довідник для щоденних операцій

Керування профілями браузера

ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"}}'
ads update-browser '{"profile_id":"..."}'
ads delete-browser '{"profile_id":["..."]}'
ads get-browser-list '{}'

Керування проксі-серверами

ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'
ads get-proxy-list '{}'
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads delete-proxy '{"proxy_id":["..."]}'

Відбитки пальців, файли cookie та кеш

ads new-fingerprint <profile_id>
ads get-profile-cookies <profile_id>
ads delete-cache-v2 '{"profile_id":["..."],"type":["cookie","history"]}'
ads get-profile-ua <profile_id>

Групи та теги

ads create-group '{"group_name":"My Group"}'
ads get-group-list '{}'
ads create-tag '{"tags":[{"name":"test","color":"darkBlue"}]}'

Керування ядром браузера

ads get-kernel-list '{"kernel_type":"Chrome"}'
ads download-kernel '{"kernel_type":"Chrome","kernel_version":"..."}'

Ви можете переглянути повний список параметрів для кожної команди, використовуючи: ads -h або ads -h

Як це допомагає реальним бізнес-операціям

Ось кілька практичних випадків використання, де AdsPower CLI може значно підвищити ефективність робочого процесу.

Масове створення облікових записів

• Раніше: Створюйте профілі один за одним у графічному інтерфейсі.
• Після: Напишіть циклічний скрипт для створення 50 або 100 профілів одночасно, кожен з автоматичним призначенням проксі-сервера та груповим тегом.

Планове технічне обслуговування

Оновлення відбитків пальців, очищення кешу та інші завдання обслуговування тепер можна додавати до запланованих завдань і виконувати автоматично щодня.

Ручний моніторинг не потрібен. Все може працювати безпосередньо на серверному середовищі.

Пакетні операції

Потрібно оновити проксі-сервери для сотень облікових записів ? Перемістити кілька профілів у нову групу? Оновити відбитки пальців масово?

CLI дозволяє виконувати масштабні завдання управління обліковими записами за допомогою однієї команди замість повторюваних ручних кліків.

Розгортання сервера та підтримка Docker

Інтерфейс командного рядка AdsPower також підтримує розгортання Docker.

docker-compose -f ./docker-compose.yml up -d
docker-compose exec adspower-cli /bin/bash

Опинившись у контейнері, користувачі можуть безпосередньо керувати екземплярами браузера за допомогою команди ads.

Це дозволяє AdsPower повноцінно працювати в середовищах безголових серверів без графічного інтерфейсу.

Інтеграція ШІ: MCP та навички

Помічники ШІ-кодування

Репозиторій GitHub інтерфейсу командного рядка містить підтримку навичок для асистентів кодування штучного інтелекту. Встановіть у Cursor та подібні інструменти однією командою:

npx skills add AdsPower/adspower-browser

Підтримка MCP (протоколу контексту моделі)

Репозиторій також інтегрує підтримку MCP , що дозволяє агентам штучного інтелекту, таким як Claude Code, Cursor, Codex та OpenCode, безпосередньо керувати екземплярами браузера AdsPower.

Після налаштування, помічники зі штучним інтелектом автоматично отримують контекст AdsPower. Опишіть, що ви хочете зробити, природною мовою, і штучний інтелект згенерує відповідні команди CLI — ідеально підходить для користувачів, не знайомих з інтерфейсами командного рядка.

Чому це важливо : Оскільки агенти штучного інтелекту беруть на себе все більше виконавчих ролей у робочих процесах, браузер, як основний інструмент для взаємодії агента та веб-сторінок, потребує відповідних можливостей інтеграції. CLI, MCP та навички доступні вже зараз.

Джерело:

1. Документація GitHub
2. Завантажте та встановіть AdsPower CLI тут