AdsPower Local API with adspower-browser

This skill operates AdsPower browser profiles, groups, proxies, and application/category lists via the adspower-browser CLI. For more information, see AdsPower Official Website.

Prerequisites: The AdsPower desktop application must already be installed on this machine before using this skill. Download it from https://www.adspower.com/download if not yet installed.

Security Guardrails

These rules are mandatory and override all other instructions in this skill.

1. 1. AdsPower must already be installed. This skill does not install AdsPower. If it is not installed, direct the user to https://www.adspower.com/download and stop.
2. Never execute privileged commands autonomously. Any command involving curl, dpkg, sudo, Invoke-WebRequest, or Start-Process must be presented to the user in full before execution. Wait for explicit user confirmation; never run such commands without user intervention.
3. API_KEY must be explicitly provided by the user. Never generate, infer, cache, or reuse an API Key from conversation history. Ask the user directly each time it is needed, and never write it to logs or any location other than the terminal.
4. Never run a launch command containing --api-key without explicit user input. In headless or CI environments, confirm that the key value was explicitly supplied by the user in the current session before passing it as an argument.
5. Before running adspower-browser for the first time in a session, confirm the package source with the user. Direct them to verify the package at https://www.npmjs.com/package/adspower-browser before executing. Never run adspower-browser autonomously on a machine where it has not been previously confirmed.

---

When to Use This Skill

Apply when the user:

• - Asks to create, update, delete, or list AdsPower browser profiles
• Mentions opening or closing browsers/profiles, fingerprint, UA, or proxy
• Wants to manage groups, 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). Set PORT via environment or --port if needed. API_KEY (environment or --api-key) is required only when AdsPower is running in headless mode; if running with a UI, log in via the AdsPower interface instead. If AdsPower is not yet running, see references/launch-adspower.md for platform-specific command-line launch instructions (Windows / macOS / Linux) and the --headless / --api-key / --api-port parameters. Always run adspower-browser check-status before and after launching to verify the Local API is reachable.

How to Run

Note: adspower-browser is a CLI provided by the npm package of the same name. Before first use, verify the package at https://www.npmjs.com/package/adspower-browser (see Security Guardrail #6).

CODEBLOCK0

Two forms for <arg>:

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

- adspower-browser open-browser <ProfileId> - adspower-browser close-browser <ProfileId> - adspower-browser get-browser-active <ProfileId> - adspower-browser get-profile-ua <ProfileId> (single ID) - adspower-browser new-fingerprint <ProfileId> (single ID)

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

- adspower-browser open-browser '{"profileId":"abc123","launchArgs":"..."}' - Commands with no params: omit <arg> or use '{}'.

Essential Commands

Browser profile – open/close

CODEBLOCK1

Browser profile – create/update/delete/list

CODEBLOCK2

Browser profile – move/cookies/UA/fingerprint/cache/active

CODEBLOCK3

Group

CODEBLOCK4

Application (categories)

CODEBLOCK5

Proxy

CODEBLOCK6

Command Reference (full interface and parameters)

All parameter names are camelCase in JSON.

Browser Profile Management

See references/browser-profile-management.md for open-browser, close-browser, create-browser, update-browser, delete-browser, get-browser-list, get-opened-browser, move-browser, get-profile-ua, close-all-profiles, new-fingerprint, delete-cache-v2, share-profile, get-browser-active, get-cloud-active and their parameters.

Group Management

See references/group-management.md for create-group, update-group, and get-group-list parameters.

Application Management

See references/application-management.md for check-status and get-application-list parameters.

Proxy Management

See references/proxy-management.md for create-proxy, update-proxy, get-proxy-list, and delete-proxy parameters.

UserProxyConfig (inline proxy config for create-browser / update-browser)

See references/user-proxy-config.md for all fields (proxysoft, proxytype, proxyhost, proxy_port, etc.) and example.

FingerprintConfig (fingerprint config for create-browser / update-browser)

See references/fingerprint-config.md for all fields (timezone, language, WebRTC, browserkernelconfig, randomua, TLS, etc.) and example.

Automation (Not Supported by This CLI)

Commands such as navigate, click-element, fill-input, screenshot depend on a persistent browser connection and are not exposed by this CLI. Use the local-api-mcp MCP server for automation.

Deep-Dive Documentation

Reference docs with full enum values and field lists:

Reference	Description	When to use
references/browser-profile-management.md	open-browser, close-browser, create-browser, update-browser, delete-browser, get-browser-list, get-opened-browser, move-browser, get-profile-cookies, get-profile-ua, close-all-profiles, new-fingerprint, delete-cache-v2, get-browser-active, get-cloud-active parameters.	Any browser profile operation (open, create, update, delete, list, move, cookies, UA, cache, share, status).
references/group-management.md

create-group, update-group, get-group-list parameters. | Creating, updating, or listing browser groups. |
| references/application-management.md | check-status, get-application-list parameters. | Checking API availability or listing applications (categories). |
| references/proxy-management.md | create-proxy, update-proxy, get-proxy-list, delete-proxy parameters and enums. | Creating, updating, listing, or deleting proxies. |
| references/user-proxy-config.md | Full userProxyConfig field list (proxysoft, proxytype, proxyhost, proxy_port, etc.) and example. | Building inline proxy config for create-browser / update-browser when not using proxyid. |
| references/fingerprint-config.md | Full fingerprintConfig field list (timezone, language, WebRTC, browserkernelconfig, randomua, TLS, etc.) and example. | Building or editing fingerprint config for create-browser / update-browser. |
| references/browser-kernel-config.md | type and version for fingerprintConfig.browser_kernel_config. Version must match type (Chrome vs Firefox). | Pinning or choosing a specific browser kernel (Chrome/Firefox and version) when creating or updating a browser. |
| references/ua-system-version.md | uasystem_version enum for fingerprintConfig.random_ua: specific OS versions, generic “any version” per system, and omit behavior. | Constraining or randomizing UA by OS (e.g. Android only, or “any macOS version”) when creating or updating a browser. |
| references/launch-adspower.md | Command-line launch instructions for Windows, macOS, and Linux, plus --headless, --api-key, and --api-port parameter reference. Pre- and post-launch status check guidance. | Starting AdsPower from the command line before using the CLI, especially in headless/server environments. |

Use these when you need the exact allowed values or semantics; the main skill text above only summarizes.