AdsPower Local API with adspower-browser

The Skills CLI (npx adspower-browser) is the package manager for operate AdsPower browser profiles, groups, proxies, and application/category lists via the adspower-browser CLI. For more infomation about out product and services, visit AdsPower Official Website.

Install CLI

npm install -g adspower-browser

After installation, you can use any of these equivalent commands:

adspower-browser
adspower
ads

adspower-browser is the original command name. adspower and ads are aliases that point to the same CLI entry.

When to Use This Skill

Apply when the user:

• Asks to create, update, delete, or list AdsPower browser profiles
• Says 打开环境、配置文件、profile、AdsPower 等意指启动已有浏览器环境 → 使用 open-browser（CLI 或 MCP）；完整说法与工具映射见 references/tool-intent-map.md
• Mentions opening or closing browsers/profiles, fingerprint, UA, or proxy
• Wants to manage groups, tags, proxies, or check API status
• Refers to AdsPower or adspower-browser (and MCP is not running or not desired)

Ensure AdsPower is running (default port 50325). Pass --port / --api-key when needed, or set the ADS_API_KEY environment variable before running start.

The CLI itself supports launching the AdsPower application via API key. If the AdsPower client is installed, AdsPower headless mode can also be launched via API key.

How to Run

The examples below use ads for brevity, but adspower-browser and adspower work the same way.

ads start -k <KEY>

If the ADS_API_KEY environment variable is set, you can start the CLI directly with:

ads start

General command form:

ads <command> [<arg>] [--port PORT] [--api-key KEY]

AdsPower client headless mode:

AdsPower Global：
Windows设备下： "AdsPower Global.exe" --headless=true --api-key=your_api_key --api-port=50325
MacOS设备下："/Applications/AdsPower Global.app/Contents/MacOS/AdsPower Global" --args --headless=true --api-key=your_api_key --api-port=50325
Linux设备下：adspower_global --headless=true --api-key=your_api_key --api-port=50325

Two forms for <arg>:

1. Single value (shorthand) — for profile-related commands, pass one profile ID or number:

   • ads open-browser <profile_id>
   • ads close-browser <profile_id>
   • ads get-profile-cookies <profile_id>
   • ads get-browser-active <profile_id>
   • ads get-profile-ua <profile_id> (single ID; a numeric token is treated as profile_no)
   • ads new-fingerprint <profile_id> (single ID; a numeric token is treated as profile_no)

2. JSON string — full parameters for any command (see Command Reference below):

   • ads open-browser '{"profile_id":"abc123","launch_args":"..."}'
   • Commands with no params: omit <arg> or use '{}'.

Essential Commands With AI Agents

You can use ads -h or ads <command> -h to view the specific parameters.

Start and stop CLI