Agent skill

AdsPower Browser Profiles

by AdsPower in AdsPower/adspower-browser

Manages AdsPower browser profiles, groups, proxies and the AdsPower client itself through the adspower-browser command line or its shorter aliases.

MITAuto-check passedProductivity & Automation

Install AdsPower Browser Profiles

skills CLI
$ npx skills add AdsPower/adspower-browser --skill adspower-browser -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AdsPower/adspower-browser adspower-browser --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AdsPower/adspower-browser.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/adspower-browser .claude/skills/adspower-browser && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
adspower-browser
GitHub stars
142
Token cost
~3.5k tokens
SKILL.md length
866 words
Files
16 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Manages AdsPower browser profiles, groups, proxies and the AdsPower client itself through the adspower-browser command line or its shorter aliases.

  • Works in 2 steps: Single value (shorthand) — for… → JSON string — full parameters for any…
  • Opening or closing an AdsPower browser profile from the command line
  • SKILL.md covers Install CLI, When to Use This Skill, How to Run and Essential Commands With AI…, plus 3 more sections
  • Calls npm; needs ADS_API_KEY

What it does

The CLI, also callable under two shorter alias names, is a package-manager-style tool for AdsPower's local API, covering creating, updating, deleting and listing browser profiles plus their groups, tags and proxies, downloading and listing browser kernels, patching the client, and checking API status. It is triggered by requests to open, launch or configure an AdsPower environment or profile, and a reference file maps common phrasings, including Chinese ones for opening an existing environment, to the matching command.

The CLI assumes AdsPower is running on its default port, with port and API-key flags or an environment variable supplying credentials, and it can also start the AdsPower client itself through an API key, including in headless mode on Windows or macOS. Commands follow a fixed form of a command name, an optional argument, and the port and key flags, and profile-related commands such as opening or closing a browser or reading its cookies take a single profile id or number. Reference files cover application, kernel, tag, group and proxy management, fingerprint configuration, and TLS cipher and user-agent details in more depth.

When your agent uses it

  • Opening or closing an AdsPower browser profile from the command line
  • Creating, updating or listing AdsPower profiles, groups or tags
  • Configuring a profile's proxy or fingerprint settings
  • Checking AdsPower's API status or downloading a browser kernel

Example prompts

  • “Open this AdsPower profile and check that it's active.”
  • “Create a new AdsPower profile in the US proxy group.”
  • “List every browser kernel available for download.”

Requirements

  • Node.js and npm, to install the CLI
  • The AdsPower client running locally
  • An AdsPower API key

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Single value (shorthand) — for profile-related commands, pass one profile ID or number
  2. JSON string — full parameters for any command (see Command Reference below)

What it can do on your machine

Read from SKILL.md and the folder at commit 06dc59d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • adspower.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ADS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

AdsPower Browser Profiles loads about 3.5k tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 84 tokens; SKILL.md has 866 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~3.5k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AdsPower/adspower-browser at commit 06dc59d, republished under its MIT licence (© AdsPower). 866 words, ~3,502 tokens.

Download SKILL.mdSave it as .claude/skills/adspower-browser/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
adspower-browser
description
AdsPower profile operation via adspower-browser CLI. open/launch/start browser or profile, environment, config profile, AdsPower; create/update/delete/list profiles; groups, tags, proxies; kernel download/list; client patch; API check-status. User phrases like open environment or map to commands such as open-browser.

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

bash
npm install -g adspower-browser

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

bash
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.

bash
ads start -k <KEY>

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

bash
ads start

General command form:

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

AdsPower client headless mode:

bash
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
bash
ads start -k <KEY>                    # Start the adspower runtime
ads stop                              # Stop the adspower runtime
ads restart                           # Restart the adspower runtime
ads status                            # Get the status of the adspower runtime
Browser profile – open/close
bash
ads open-browser <profile_id>                    # Or JSON: profile_id, profile_no?, ip_tab?, launch_args?, headless?, last_opened_tabs?, proxy_detection?, password_filling?, password_saving?, cdp_mask?, delete_cache?, device_scale?
ads close-browser <profile_id>                   # Or JSON: profile_id? | profile_no? (one required)
Browser profile – create/update/delete/list
bash
ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"},...}'  # group_id required: always include it; use "0" for Ungrouped; if given a group name, call get-group-list first; include either proxyid or user_proxy_config
ads update-browser '{"profile_id":"...",...}'    # profile_id required
ads delete-browser '{"profile_id":["..."]}'     # profile_id required
ads get-browser-list '{}'                       # CLI defaults to page=1,limit=200 (Local API itself returns only 1). Or group_id?, limit?, page?, profile_id[]?, profile_no[]?, sort_type?, sort_order?, tag_ids?, tags_filter?, name?, name_filter?
ads get-opened-browser                          # No params

Listing all environments: get-browser-list returns total_count / total_pages. The CLI sends page=1,limit=200 by default, so one call covers up to 200 profiles. If total_pages > 1, keep calling with the same filters and page + 1 until every page is collected. For "operate on all environments in a group" tasks, gather all pages first, then act on every returned profile_id — never just the first.

Browser profile – move/cookies/UA/fingerprint/cache/share/active
bash
ads move-browser '{"group_id":"1","user_ids":["..."]}'   # group_id + user_ids required
ads get-profile-cookies <profile_id>             # Or JSON: profile_id? | profile_no?
ads get-profile-ua <profile_id>                  # Or JSON: profile_id[]? | profile_no[]? (up to 10); numeric shorthand maps to profile_no[]
ads close-all-profiles                          # No params
ads new-fingerprint <profile_id>                 # Or JSON: profile_id[]? | profile_no[]? (up to 10); numeric shorthand maps to profile_no[]
ads delete-cache-v2 '{"profile_id":["..."],"type":["cookie","history"]}'  # type: local_storage|indexeddb|extension_cache|cookie|history|image_file
ads share-profile '{"profile_id":["..."],"receiver":"email@example.com"}' # receiver required; share_type?, content?
ads get-browser-active <profile_id>              # Or JSON: profile_id? | profile_no?
ads get-cloud-active '{"user_ids":"id1,id2"}'    # user_ids comma-separated, max 100
Kernel
bash
ads download-kernel '{"kernel_type":"Chrome","kernel_version":"141"}'
ads get-kernel-list '{}'                         # kernel_type?: Chrome | Firefox (omit to get all)
Patch
bash
ads update-patch '{}'                            # version_type?: stable | beta (default stable)
Tag
bash
ads get-tag-list '{}'                              # ids?, limit?, page?
ads create-tag '{"tags":[{"name":"My tag","color":"blue"}]}'   # name required per item; color optional
ads update-tag '{"tags":[{"id":"1","name":"Renamed"}]}'        # id required per item; name?, color?
ads delete-tag '{"ids":["tagId1","tagId2"]}'                   # ids required
Group
bash
ads create-group '{"group_name":"My Group","remark":"..."}'   # group_name required
ads update-group '{"group_id":"1","group_name":"New Name"}'    # group_id + group_name required; remark? (null to clear)
ads get-group-list '{}'                         # group_name?, page_size?, page?
Application (categories)
bash
ads check-status                                # No params – API availability
ads get-application-list '{"category_id":"123","page":1,"limit":20}'
Proxy
bash
ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'  # top-level array; type, host, port required per item
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads get-proxy-list '{}'                         # limit?, page?, proxy_id[]?
ads delete-proxy '{"proxy_id":["..."]}'        # proxy_id required, max 100

Command Reference (full interface and parameters)

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.

user_proxy_config (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. For create-browser, include either proxyid or user_proxy_config. If the user does not specify a proxy when creating a browser profile, set user_proxy_config to {"proxy_soft":"no_proxy"}. For update-browser, include proxyid or user_proxy_config only when changing the profile proxy.

Show full SKILL.md (331 more words)Show less
fingerprint_config (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:

ReferenceDescriptionWhen to use
references/tool-intent-map.mdMCP/CLI 工具名与中英 intent、triggers 对照表(与 toolIntentMetadata.ts 同源)。根据用户自然语言选择对应 CLI 命令或 MCP 工具(尤其 open-browser)。
references/browser-profile-management.mdopen-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 parameters.Any browser profile operation (open, create, update, delete, list, move, cookies, UA, cache, share, status).
references/group-management.mdcreate-group, update-group, get-group-list parameters.Creating, updating, or listing browser groups.
references/application-management.mdcheck-status, get-application-list parameters.Checking API availability or listing applications (categories).
references/proxy-management.mdcreate-proxy, update-proxy, get-proxy-list, delete-proxy parameters and enums.Creating, updating, listing, or deleting proxies.
references/browser-tag-management.mdget-tag-list, create-tag, update-tag, delete-tag parameters.Listing, creating, updating, or deleting browser tags.
references/browser-kernel-management.mddownload-kernel, get-kernel-list parameters.Downloading a specific kernel and querying supported kernel versions.
references/client-patch-management.mdupdate-patch parameters.Updating AdsPower client to latest patch channel (stable/beta).
references/user-proxy-config.mdFull user_proxy_config field list (proxy_soft, proxy_type, proxy_host, proxy_port, etc.) and example.Building inline proxy config for create-browser / update-browser when not using proxyid.
references/fingerprint-config.mdFull fingerprint_config field list (timezone, language, WebRTC, browser_kernel_config, random_ua, TLS, etc.) and example.Building or editing fingerprint config for create-browser / update-browser.
references/browser-kernel-config.mdtype and version for fingerprint_config.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/browser-kernel-download-management.mddownload-kernel parameters (kernel_type, kernel_version).Downloading or updating a specific browser kernel version and polling progress/status.
references/ua-system-version.mdua_system_version enum for fingerprint_config.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.

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

© AdsPower, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (references) in skills/adspower-browser of AdsPower/adspower-browser.

  • SKILL.md
  • references/application-management.md
  • references/browser-kernel-config.md
  • references/browser-kernel-download-management.md
  • references/browser-kernel-management.md
  • references/browser-profile-management.md
  • references/browser-tag-management.md
  • references/chrome-tls-cipher.md
  • references/client-patch-management.md
  • references/country-code.md
  • references/fingerprint-config.md
  • references/group-management.md
  • references/proxy-management.md
  • references/tool-intent-map.md
  • references/ua-system-version.md
  • references/user-proxy-config.md

Open the folder on GitHubat commit 06dc59d

Compare with similar skills

AdsPower Browser Profiles next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

AdsPower Browser Profiles compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AdsPower Browser Profiles this skillAdsPower/adspower-browser142—~3.5kAutomated safety check: PassMIT
Agent Browser CLIvercel-labs/agent-browser44k24 repos~864Automated safety check: PassApache-2.0
Agent Browserquran/quran.com-frontend-next1.9k42 repos~3.3kAutomated safety check: PassNone
Web Access via Browser CDPeze-is/web-access9.1k4 repos~2.2kAutomated safety check: PassMIT
Dev Browser AutomationMemTensor/MemOS12k3 repos~1.7kAutomated safety check: PassApache-2.0
Browser Control with Omowrightcode-yeongyu/oh-my-openagent70k1 repos~2.2kAutomated safety check: PassCustom licence

Similar skills

  • Agent Browser CLI

    vercel-labs/agent-browser

    Official

    Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking…

    44k GitHub starsUsed in 24 repos~864 tokens
    Productivity & AutomationAuto-check passed
  • Agent Browser

    quran/quran.com-frontend-next

    Automates browser interactions for web testing, form filling, screenshots, and data extraction.

    1.9k GitHub starsUsed in 42 repos~3.3k tokens
    Productivity & AutomationAuto-check passed
  • Routes every web task, from searching to logged-in browsing, through a tiered choice of search, fetch, curl or a real Chrome or Edge session driven over CDP.

    9.1k GitHub starsUsed in 4 repos~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Dev Browser Automation

    MemTensor/MemOS

    Automates a real browser through short TypeScript scripts that keep page state between runs, for navigating, filling forms, taking screenshots and extracting data.

    12k GitHub starsUsed in 3 repos~1.7k tokens
    Productivity & AutomationAuto-check passed
  • Browser Control with Omowright

    code-yeongyu/oh-my-openagent

    Drives a real browser through the omowright library, either the user's own signed-in browser or a separate browser the code launches, for forms, QA, screenshots and scraping.

    70k GitHub starsUsed in 1 repo~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Electron App Automation

    vercel-labs/agent-browser

    Official

    Automates Electron desktop apps such as VS Code, Slack or Discord by connecting agent-browser to their Chrome DevTools Protocol port.

    44k GitHub starsUsed in 5 repos~1.7k tokens
    Productivity & AutomationAuto-check passed

Questions about AdsPower Browser Profiles

What does AdsPower Browser Profiles do?

Manages AdsPower browser profiles, groups, proxies and the AdsPower client itself through the adspower-browser command line or its shorter aliases. The CLI, also callable under two shorter alias names, is a package-manager-style tool for AdsPower's local API, covering creating, updating, deleting and listing browser profiles plus their groups, tags and proxies, downloading and listing browser kernels, patching the client, and checking API status. It is triggered by requests to open, launch or configure an AdsPower environment or profile, and a reference file maps common phrasings, including Chinese ones for opening an existing environment, to the matching command.

When should I use AdsPower Browser Profiles?

AdsPower Browser Profiles fits situations like: opening or closing an AdsPower browser profile from the command line; creating, updating or listing AdsPower profiles, groups or tags; configuring a profile's proxy or fingerprint settings; checking AdsPower's API status or downloading a browser kernel.

How do I install AdsPower Browser Profiles in Claude Code?

Run `npx skills add AdsPower/adspower-browser --skill adspower-browser -a claude-code`. Or copy the skill folder (skills/adspower-browser in AdsPower/adspower-browser) into .claude/skills/adspower-browser in your project. Claude Code loads it when a task matches its description.

How do I install AdsPower Browser Profiles in Codex?

Run `npx skills add AdsPower/adspower-browser --skill adspower-browser -a codex`. Or copy the skill folder (skills/adspower-browser in AdsPower/adspower-browser) into .agents/skills/adspower-browser in your project. Codex loads it when a task matches its description.

Can I use AdsPower Browser Profiles in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AdsPower/adspower-browser --skill adspower-browser -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adspower-browser, .gemini/skills/adspower-browser, .github/skills/adspower-browser and .opencode/skills/adspower-browser in your project.

What does AdsPower Browser Profiles need to run?

Going by SKILL.md and its folder, AdsPower Browser Profiles needs the command-line tools its instructions call (npm) and credentials named ADS_API_KEY. Our summary lists: Node.js and npm, to install the CLI; The AdsPower client running locally; An AdsPower API key.

Does AdsPower Browser Profiles access the network?

SKILL.md names 1 domain. As links in the text: adspower.com. This is read from the text; nothing was executed.

Is AdsPower Browser Profiles safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does AdsPower Browser Profiles use?

AdsPower Browser Profiles is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does AdsPower Browser Profiles use?

About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.2k tokens, read only when the agent opens those files.

What are the alternatives to AdsPower Browser Profiles?

Skills that share tags, products or a category with AdsPower Browser Profiles: Agent Browser CLI (vercel-labs/agent-browser, 44k stars), Agent Browser (quran/quran.com-frontend-next, 1.9k stars), Web Access via Browser CDP (eze-is/web-access, 9.1k stars) and Dev Browser Automation (MemTensor/MemOS, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AdsPower Browser Profiles?

AdsPower (a GitHub user) maintains it in AdsPower/adspower-browser, which has 142 GitHub stars. The repository was last updated on July 20, 2026.

Source: AdsPower/adspower-browser on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.