Adspower Browser

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

Two forms for <arg>:

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-profile-cookies <ProfileId>
   • adspower-browser get-browser-active <ProfileId>
   • adspower-browser get-profile-ua <ProfileId> (single ID)
   • adspower-browser new-fingerprint <ProfileId> (single ID)

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

adspower-browser open-browser <profileId>                    # Or JSON: profileId, profileNo?, ipTab?, launchArgs?, clearCacheAfterClosing?, cdpMask?
adspower-browser close-browser <profileId>                   # Or JSON: profileId? | profileNo? (one required)

Browser profile – create/update/delete/list

adspower-browser create-browser '{"groupId":"0","userProxyConfig":{"proxy_soft":"no_proxy"},...}'  # groupId + account field required; proxy optional (defaults to no_proxy; proxyid takes priority over userProxyConfig when both given)
adspower-browser update-browser '{"profileId":"...",...}'    # profileId required
adspower-browser delete-browser '{"profileIds":["..."]}'     # profileIds required
adspower-browser get-browser-list '{}'                       # Or groupId?, limit?, page?, profileId?, profileNo?, sortType?, sortOrder?, tag_ids?, tags_filter?, name?, name_filter?
adspower-browser get-opened-browser                          # No params

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

adspower-browser move-browser '{"groupId":"1","userIds":["..."]}'   # groupId + userIds required
adspower-browser get-profile-cookies <profileId>             # Or JSON: profileId? | profileNo?
adspower-browser get-profile-ua <profileId>                  # Or JSON: profileId[]? | profileNo[]? (up to 10)
adspower-browser close-all-profiles                          # No params
adspower-browser new-fingerprint <profileId>                 # Or JSON: profileId[]? | profileNo[]? (up to 10)
adspower-browser delete-cache-v2 '{"profileIds":["..."],"type":["cookie","history"]}'  # type: local_storage|indexeddb|extension_cache|cookie|history|image_file
adspower-browser share-profile '{"profileIds":["..."],"receiver":"[email protected]"}' # receiver required; shareType?, content?
adspower-browser get-browser-active <profileId>              # Or JSON: profileId? | profileNo?
adspower-browser get-cloud-active '{"userIds":"id1,id2"}'    # userIds comma-separated, max 100

Kernel

adspower-browser download-kernel '{"kernel_type":"Chrome","kernel_version":"141"}'
adspower-browser get-kernel-list '{}'                         # kernel_type?: Chrome | Firefox (omit to get all)

Patch

adspower-browser update-patch '{}'                            # version_type?: stable | beta (default stable)

Tag

adspower-browser get-tag-list '{}'                              # ids?, limit?, page?
adspower-browser create-tag '{"tags":[{"name":"My tag","color":"blue"}]}'   # name required per item; color optional
adspower-browser update-tag '{"tags":[{"id":"1","name":"Renamed"}]}'        # id required per item; name?, color?
adspower-browser delete-tag '{"ids":["tagId1","tagId2"]}'                   # ids required

Group

adspower-browser create-group '{"groupName":"My Group","remark":"..."}'   # groupName required
adspower-browser update-group '{"groupId":"1","groupName":"New Name"}'    # groupId + groupName required; remark? (null to clear)
adspower-browser get-group-list '{}'                         # groupName?, size?, page?

Application (categories)

adspower-browser check-status                                # No params – API availability
adspower-browser get-application-list '{}'                   # category_id?, page?, limit?

Proxy

adspower-browser create-proxy '{"proxies":[{"type":"http","host":"127.0.0.1","port":"8080"}]}'  # type, host, port required per item
adspower-browser update-proxy '{"proxyId":"...","host":"..."}'   # proxyId required
adspower-browser get-proxy-list '{}'                         # limit?, page?, proxyId?
adspower-browser delete-proxy '{"proxyIds":["..."]}'        # proxyIds required, max 100

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-cookies, 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.

Tag Management

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

Kernel Management

See references/browser-kernel-management.md for download-kernel and get-kernel-list parameters.

Patch Management

See references/client-patch-management.md for update-patch parameters.

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

See references/user-proxy-config.md for all fields (proxy_soft, proxy_type, proxy_host, proxy_port, etc.) and example. Defaults to {"proxy_soft":"no_proxy"} when omitted. If proxyid is also provided, proxyid takes priority and userProxyConfig is ignored.

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

See references/fingerprint-config.md for all fields (timezone, language, WebRTC, browser_kernel_config, random_ua, 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:

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