adspower-browser
AdsPower Skill & MCP & CLI for using the AdsPower LocalAPI
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/adspower/adspower-browser with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/adspower/adspower-browser'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/adspower--adspower-browser)HTML
<a href="/listings/adspower--adspower-browser"><img src="/api/listings/adspower--adspower-browser/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.MD · README · 189 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # AdsPower Skill & MCP & CLI
- ## adspower-browser Skill
- Claude Code/Codex/Cursor/OpenCode/Gemini GL
- ```bash
- npx skills add https://github.com/adspower/adspower-browser --skill adspower-browser
- ```
- OpenClaw(小龙虾)
- ```bash
- npx clawhub@latest install adspower-browser --force
- ```
- Hermes agent(爱马仕)
- ```bash
- hermes skills install https://github.com/AdsPower/adspower-browser/blob/main/skills/adspower-browser --force
- ```
- ## AdsPower CLI
- The AdsPower CLI is completely isolated from the AdsPower client, runs independently, and does not share local caches/kernels, etc. However, the CLI also supports headless mode for operating the AdsPower client.
- ```bash
- npm install -g adspower-browser # 安装
- ads start -k <KEY> # 启动 adspower
- ads stop # 停止 adspower
- ads restart # 重启 adspower
- ads status # 查询 adspower 运行状态
- ads get-browser-list # 获取配置文件列表
- ... #查看 https://github.com/AdsPower/adspower-browser/blob/main/packages/adspower-browser/README.MD
- ```
- 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
- ```
- ### AdsPower MCP
- Claude Code:
- ```bash
- claude mcp add adspower-local-api -e PORT="50325" -e API_KEY="your_api_key" -- npx -y local-api-mcp-typescript
- ```
- Codex:
- ```bash
- codex mcp add --env PORT="50325" --env API_KEY="your_api_key" adspower-local-api -- npx -y local-api-mcp-typescript
- ```
- OpenClaw:
- ```bash
- openclaw mcp set adspower-local-api '{"command":"npx","args":["-y","local-api-mcp-typescript"],"env":{"PORT":"50325","API_KEY":"your_api_key"}}'
- ```
- Cursor: Go to Cursor Settings -> MCP -> Add New MCP Server, and then paste the following content:
- ```json
- {
- "mcpServers": {
- "adspower-local-api": {
- "command": "npx",
- "args": ["-y", "local-api-mcp-typescript"],
- "env": {
- "PORT": "50325",
- "API_KEY": "your_api_key"
- }
- }
- }
- }
- ```
- OpenCode: update `~/.config/opencode/opencode.json`
- ```json
- {
- "$schema": "https://opencode.ai/config.json",
- "mcp": {
- "adspower-local-api": {
- "command": "npx",
- "args": ["-y", "local-api-mcp-typescript"],
- "env": {
- "PORT": "50325",
- "API_KEY": "your_api_key"
- }
- }
- }
- }
- ```
- ### How to use?
- #### Requirements
- - [AdsPower](https://www.adspower.com/?source=github)
- - Node version 18 or greater
- #### Version Compatibility
- Some APIs are introduced incrementally by AdsPower client version.
- If the client has not been upgraded to a version that includes a specific API, requests may return `Not found`.
- When this happens:
- - Upgrade AdsPower client to the latest patch version first.
- - Then retry the same command/API.
- #### Port Configuration
- The port parameter specifies the AdsPower Local API port. Default is `50325`.
- **Priority order:**
- 1. Command-line argument `--port` (highest priority)
- 2. Environment variable `PORT` (medium priority)
- 3. Default value `50325` (lowest priority)
- **Examples:**
- Using command-line argument:
- ```json
- {
- "mcpServers": {
- "adspower-local-api": {
- "command": "npx",
- "args": ["-y", "local-api-mcp-typescript", "--port", "50325"]
- }
- }
- }
- ```
- Using environment variable:
- ```json
- {
- "mcpServers": {
- "adspower-local-api": {
- "command": "npx",
- "args": ["-y", "local-api-mcp-typescript"],
- "env": {
- "PORT": "50325"
- }
- }
- }
- }
- ```
- ## Development
- ```bash
- # clone
- git clone https://github.com/AdsPower/adspower-browser.git
- cd adspower-browser
- # install (monorepo)
- pnpm install
- # build all packages
- pnpm run build
- ```
- For local MCP development, point Claude Desktop to the MCP package:
- ```json
- "mcpServers": {
- "adspower-local-api": {
- "command": "node",
- "args": ["<Replace Your Project Path>/adspower-browser/packages/local-api-mcp/build/index.js"]
- }
- }
- ```
- ### Use AdsPower Cli in Docker
- copy the [`/packages/adspower-browser/docker-compose.yml`](/packages/adspower-browser/docker-compose.yml)
- ```bash
- cd packages/adspower-browser
- docker-compose -f ./docker-compose.yml up -d
- docker-compose exec adspower-cli /bin/bash
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.