AdsPower SOP

Appearance

Install ​

AdsPower ships two install paths: a desktop GUI client (the primary product) and an npm CLI package (adspower-browser) for headless and agent-driven use. The CLI is completely isolated from the GUI client and does not share cache or browser kernel with it.

Option 1: Desktop GUI Client (Primary) ​

Download and install the platform-specific binary from the official download page.

Download page: https://www.adspower.com/download

Windows (PowerShell one-liner) ​

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

If the script execution policy blocks this, download the installer from the download page and run it manually.

Minimum system requirements (Windows): Windows 10+, dual-core CPU, 2 GB RAM, 2 GB disk space.

macOS ​

Download the .dmg from the download page.

Minimum: macOS 11 (Big Sur) or later.

Linux ​

Minimum: Ubuntu Desktop 22.04 or later. Download the .deb or AppImage from the download page.

Option 2: npm CLI Package (Headless / Agent Use) ​

The CLI package exposes profile and browser management over a terminal interface. Requires Node.js.

bash
npm install -g adspower-browser

After install, three command aliases are available: adspower-browser, adspower, and ads.

API Key ​

The CLI requires an AdsPower API key. Set it as an environment variable or pass it with the -k flag on every command:

bash
export ADS_API_KEY=your_api_key_here

Get the key from your AdsPower account dashboard after signing up at https://www.adspower.com.

Option 3: Use as a Cursor / Agent Skill ​

bash
npx skills add AdsPower/adspower-browser

Docker ​

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

The docker-compose.yml is included in the GitHub repository: https://github.com/AdsPower/adspower-browser.