AdsPower Skill & MCP & CLI
adspower-browser Skill
Claude Code/Codex/Cursor/OpenCode/Gemini GL
npx skills add https://github.com/adspower/adspower-browser --skill adspower-browser
OpenClaw(小龙虾)
npx clawhub@latest install adspower-browser --force
Hermes agent(爱马仕)
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.
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:
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:
claude mcp add adspower-local-api -e PORT="50325" -e API_KEY="your_api_key" -- npx -y local-api-mcp-typescript
Codex:
codex mcp add --env PORT="50325" --env API_KEY="your_api_key" adspower-local-api -- npx -y local-api-mcp-typescript
OpenClaw:
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:
{
"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
{
"$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
-
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:
- Command-line argument
--port(highest priority) - Environment variable
PORT(medium priority) - Default value
50325(lowest priority)
Examples:
Using command-line argument:
{
"mcpServers": {
"adspower-local-api": {
"command": "npx",
"args": ["-y", "local-api-mcp-typescript", "--port", "50325"]
}
}
}
Using environment variable:
{
"mcpServers": {
"adspower-local-api": {
"command": "npx",
"args": ["-y", "local-api-mcp-typescript"],
"env": {
"PORT": "50325"
}
}
}
}
Development
# 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:
"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
cd packages/adspower-browser
docker-compose -f ./docker-compose.yml up -d
docker-compose exec adspower-cli /bin/bash
