AdsPower CLI: Tự động hóa quản lý trình duyệt từ dòng lệnh

AdsPower chính thức ra mắt công cụ CLI (Giao diện dòng lệnh) độc lập.

Các tác vụ trước đây yêu cầu thao tác nhấp chuột trên giao diện desktop của AdsPower giờ đây có thể hoàn thành chỉ với một câu lệnh. Tạo và quản lý hồ sơ (profile) trình duyệt, khởi chạy và tắt trình duyệt, chuyển đổi proxy, làm mới dấu vân tay, trích xuất cookie, dọn dẹp cache, quản lý nhóm và thẻ đều được hỗ trợ trực tiếp từ terminal.

CLI chạy độc lập với ứng dụng desktop AdsPower. Nó không chia sẻ cache cục bộ, nhân trình duyệt hoặc môi trường chạy (runtime) với ứng dụng chính.

Hướng dẫn cài đặt

Có hai phương pháp cài đặt khả dụng.

Cách 1: Cài đặt qua npm (Khuyến nghị cho người dùng có Node.js)

npm install -g adspower-browser

Sau khi cài đặt, các lệnh sau đều khả dụng và có chức năng giống hệt nhau: adspower-browser , adspower , ads

Cách 2: Cài đặt trực tiếp

trên Windows:

Người dùng Windows cũng có thể cài đặt CLI trực tiếp từ trang tải xuống chính thức của AdsPower.

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

trên macOS:

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

trên Linux:

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

Nếu lệnh không thực thi thành công, bạn có thể tải xuống trình cài đặt về máy và chạy thủ công.

Hướng dẫn bắt đầu nhanh

Khởi chạy CLI:

ads start -k <KEY>

Nếu bạn đã cấu hình biến môi trường ADS_API_KEY, bạn chỉ cần chạy: ads start

Ví dụ: Mở một profile trình duyệt:

ads open-browser <profile_id>

Ví dụ: Đóng một profile trình duyệt:

ads close-browser <profile_id>

Chỉ với ba lệnh, một phiên bản trình duyệt có thể được khởi chạy và quản lý hoàn toàn.

Tài liệu tham khảo nhanh cho các tác vụ hàng ngày

Quản lý Profile trình duyệt

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 '{}'

Quản lý Proxy

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":["..."]}'

Dấu vân tay, Cookies và Cache

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>

Nhóm và Thẻ

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

Quản lý Nhân trình duyệt

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

Bạn có thể xem danh sách tham số đầy đủ cho mọi lệnh bằng cách sử dụng: ads -h hoặc ads <command> -h

Lợi ích thực tế cho hoạt động kinh doanh

Dưới đây là một số trường hợp sử dụng thực tế nơi AdsPower CLI có thể cải thiện đáng kể hiệu quả quy trình làm việc.

Tạo tài khoản hàng loạt

• Trước đây: Tạo từng profile một thủ công trên GUI.
• Sau này: Viết một script vòng lặp để tạo 50 hoặc 100 profile cùng lúc, mỗi profile được tự động gán proxy và gắn thẻ nhóm.

Bảo trì định kỳ

Làm mới dấu vân tay, dọn dẹp cache và các tác vụ bảo trì khác giờ đây có thể được thêm vào các công việc được lên lịch (scheduled jobs) và thực thi tự động mỗi ngày.

Không cần giám sát thủ công. Mọi thứ có thể chạy trực tiếp trên môi trường máy chủ (server).

Thao tác hàng loạt (Batch Operations)

Cần cập nhật proxy cho hàng trăm tài khoản? Di chuyển nhiều profile vào nhóm mới? Làm mới dấu vân tay hàng loạt?

CLI cho phép hoàn thành các tác vụ quản lý tài khoản quy mô lớn chỉ với một lệnh duy nhất thay vì các cú nhấp chuột thủ công lặp đi lặp lại.

Triển khai Server và Hỗ trợ Docker

AdsPower CLI cũng hỗ trợ triển khai trên Docker.

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

Khi ở trong container, người dùng có thể quản lý trực tiếp các phiên bản trình duyệt bằng lệnh `ads`.

Điều này cho phép AdsPower hoạt động hoàn toàn trong các môi trường máy chủ không đầu (headless server), không cần giao diện đồ họa.

Tích hợp AI: MCP & Skills

Trợ lý lập trình AI

Kho lưu trữ GitHub của CLI bao gồm hỗ trợ "Skill" cho các trợ lý lập trình AI. Cài đặt vào Cursor và các công cụ tương tự chỉ với một lệnh:

npx skills add AdsPower/adspower-browser

Hỗ trợ MCP (Giao thức ngữ cảnh mô hình)

Kho lưu trữ cũng tích hợp hỗ trợ MCP, cho phép các tác nhân AI (AI agents) như Claude Code, Cursor, Codex và OpenCode điều khiển trực tiếp các phiên bản trình duyệt AdsPower.

Sau khi thiết lập, các trợ lý AI sẽ tự động có được ngữ cảnh AdsPower. Mô tả những gì bạn muốn làm bằng ngôn ngữ tự nhiên, và AI sẽ tạo ra các lệnh CLI tương ứng—hoàn hảo cho những người dùng không quen thuộc với giao diện dòng lệnh.

Tại sao điều này quan trọng: Khi các tác nhân AI đảm nhận nhiều vai trò thực thi hơn trong các quy trình làm việc, trình duyệt—với tư cách là công cụ cốt lõi cho sự tương tác giữa tác nhân và web—cần có các khả năng tích hợp tương ứng. CLI, MCP và Skills hiện đều đã sẵn sàng.

Nguồn tham khảo:

1. Tài liệu GitHub
2. Tải xuống và cài đặt AdsPower CLI tại đây