adspower-browser skill
Official AdsPower skill, CLI and MCP: an agent opens anti-detect browser profiles and manages proxies, groups and tags
- 155 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent reads profile cookies, manages proxies and can delete profiles, while `delete-member` removes a member irreversibly.
- Fingerprint-substituting profiles are used for multi-account work, and a platform may block accounts if this breaks its rules.
- The API key gives control over the whole AdsPower account, including team member passwords.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/adspower-browserDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent reads profile cookies, manages proxies and can delete profiles, while `delete-member` removes a member irreversibly.
- Fingerprint-substituting profiles are used for multi-account work, and a platform may block accounts if this breaks its rules.
- The API key gives control over the whole AdsPower account, including team member passwords.
This is third-party code. Review the repository files before installing.
What it does
adspower-browser is an AdsPower repository with three ways to drive the local browser API: a skill, the `ads` console utility and the `local-api-mcp-typescript` MCP server. An agent creates, updates, opens and closes browser profiles, reads their cookies and User-Agent, rotates the fingerprint with `new-fingerprint` and clears cache by type: cookies, history, localStorage and others. Separate commands handle groups, tags, proxies, browser kernels and team members. A profile can be created at once with proxy and fingerprint settings, and the utility lists profiles in pages of 200. For automation there is a headless client start and an update of the client to a stable or beta version. The skill tells the agent which command to call when, so an 'open the environment' request becomes `open-browser`. The `ads` utility is installed separately through npm and can launch AdsPower from an API key, so it also runs without an installed client, but in an isolated mode with its own caches and kernels.
Who it is for. Teams running many advertising and e-commerce accounts through AdsPower who want an agent to take over profile routine.
Good fit when
- A group holds hundreds of profiles, and the agent is asked to bulk-update proxies, tags or move them between groups.
- A QA engineer runs the same test in several environments with different fingerprints and closes them after the run.
- On a request like 'open environment 123' the agent starts the right profile with `open-browser`.
- You need the remaining dynamic proxy traffic and the package expiry through `get-dynamic-proxy-traffic`.
- An administrator adds team members and gives them profile groups without manual work in the interface.
Not a fit when
- You have no AdsPower account and client: the utility works only with its local API.
- An ordinary browser for automated tests without fingerprint substitution is enough: Playwright or Puppeteer will do.
- The task breaks a platform's rules, such as bulk registration of fake accounts. Profiles must serve your own or client accounts.
Example request
Open environment 123 in AdsPower, check its cookies and close the profile when you are done.Limitations
A running AdsPower client with the local API (default port 50325) or the `ads` utility started with an API key is required, along with Node.js 18 or newer. Some API methods arrive in newer client versions, and an older one answers Not found, in which case the client must be updated. The `delete-member` command removes a member permanently, and `reset-member-password` returns the new password in its response. The skill and the MCP are distributed with separate commands, and port and key are set with flags or the `PORT` and `API_KEY` variables.
How to disable. Delete the skill from the agent skills directory, run `npm uninstall -g adspower-browser` and remove the `adspower-local-api` MCP server from the agent configuration. The API key can be reissued in AdsPower.
FAQ
How do I connect AdsPower to Claude Code?
Add the MCP server with `claude mcp add adspower-local-api -e PORT="50325" -e API_KEY="your_api_key" -- npx -y local-api-mcp-typescript` or install the skill through `npx skills add`. In both cases the AdsPower client must be running.
How does the ads utility differ from the AdsPower client?
The utility runs independently of the client and shares no caches or browser kernels with it. It starts AdsPower from an API key and suits servers without a graphical environment.
What if the API answers Not found?
The method arrived in a newer client version. Update the client to the latest patch and repeat the command; `ads check-status` checks API availability.
Can the client run without a window?
Yes. Start the client with `--headless=true --api-key=... --api-port=50325`; the program paths for Windows, macOS and Linux are in the documentation.
How do I change the API port?
Pass `--port` on the command line or set the `PORT` environment variable. The flag wins over the variable, and without both port 50325 is used.
Discussion
No questions or reviews yet.
Related
SkillsAnti-Detect Browser Skills (AntiBrow)
Anti-Detect Browser Skills
Four AntiBrow skills: browser profiles with a device fingerprint, an MCP mode for agents and data collection with ready recipes
A CLI and MCP server that lets an agent drive your real Chrome with its logged-in sessions: 103 commands across 36 platforms plus browser automation
Browserless.io MCP server: a cloud browser for the agent with page reads, site crawls, Lighthouse audits and click-driven sessions
A separate browser for agents with a skill and MCP: Claude Code and Codex work in your logged-in accounts, and every session is recorded for replay
An MCP wrapper over the browser-use engine: a single tool drives a browser from a natural-language task.
An MCP bridge to control your browser from a coding agent: a Chrome extension and a set of tab and page automation tools
README in short
The documentation gives skill install commands for different agents, the list of `ads` commands and ready MCP settings for Claude Code, Codex, OpenClaw, Cursor and OpenCode. Separate sections explain the port setting priority, client version compatibility and running the utility in Docker.