Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/adspower--adspower-browser/badge.svg)](/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

i

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)

  1. # AdsPower Skill & MCP & CLI
  2. ## adspower-browser Skill
  3. Claude Code/Codex/Cursor/OpenCode/Gemini GL
  4. ```bash
  5. npx skills add https://github.com/adspower/adspower-browser --skill adspower-browser
  6. ```
  7. OpenClaw(小龙虾)
  8. ```bash
  9. npx clawhub@latest install adspower-browser --force
  10. ```
  11. Hermes agent(爱马仕)
  12. ```bash
  13. hermes skills install https://github.com/AdsPower/adspower-browser/blob/main/skills/adspower-browser --force
  14. ```
  15. ## AdsPower CLI
  16. 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.
  17. ```bash
  18. npm install -g adspower-browser # 安装
  19. ads start -k <KEY> # 启动 adspower
  20. ads stop # 停止 adspower
  21. ads restart # 重启 adspower
  22. ads status # 查询 adspower 运行状态
  23. ads get-browser-list # 获取配置文件列表
  24. ... #查看 https://github.com/AdsPower/adspower-browser/blob/main/packages/adspower-browser/README.MD
  25. ```
  26. AdsPower client headless mode:
  27. ```bash
  28. AdsPower Global:
  29. Windows: "AdsPower Global.exe" --headless=true --api-key=your_api_key --api-port=50325
  30. MacOS:"/Applications/AdsPower Global.app/Contents/MacOS/AdsPower Global" --args --headless=true --api-key=your_api_key --api-port=50325
  31. Linux:adspower_global --headless=true --api-key=your_api_key --api-port=50325
  32. ```
  33. ### AdsPower MCP
  34. Claude Code:
  35. ```bash
  36. claude mcp add adspower-local-api -e PORT="50325" -e API_KEY="your_api_key" -- npx -y local-api-mcp-typescript
  37. ```
  38. Codex:
  39. ```bash
  40. codex mcp add --env PORT="50325" --env API_KEY="your_api_key" adspower-local-api -- npx -y local-api-mcp-typescript
  41. ```
  42. OpenClaw:
  43. ```bash
  44. openclaw mcp set adspower-local-api '{"command":"npx","args":["-y","local-api-mcp-typescript"],"env":{"PORT":"50325","API_KEY":"your_api_key"}}'
  45. ```
  46. Cursor: Go to Cursor Settings -> MCP -> Add New MCP Server, and then paste the following content:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "adspower-local-api": {
  51. "command": "npx",
  52. "args": ["-y", "local-api-mcp-typescript"],
  53. "env": {
  54. "PORT": "50325",
  55. "API_KEY": "your_api_key"
  56. }
  57. }
  58. }
  59. }
  60. ```
  61. OpenCode: update `~/.config/opencode/opencode.json`
  62. ```json
  63. {
  64. "$schema": "https://opencode.ai/config.json",
  65. "mcp": {
  66. "adspower-local-api": {
  67. "command": "npx",
  68. "args": ["-y", "local-api-mcp-typescript"],
  69. "env": {
  70. "PORT": "50325",
  71. "API_KEY": "your_api_key"
  72. }
  73. }
  74. }
  75. }
  76. ```
  77. ### How to use?
  78. #### Requirements
  79. - [AdsPower](https://www.adspower.com/?source=github)
  80. - Node version 18 or greater
  81. #### Version Compatibility
  82. Some APIs are introduced incrementally by AdsPower client version.
  83. If the client has not been upgraded to a version that includes a specific API, requests may return `Not found`.
  84. When this happens:
  85. - Upgrade AdsPower client to the latest patch version first.
  86. - Then retry the same command/API.
  87. #### Port Configuration
  88. The port parameter specifies the AdsPower Local API port. Default is `50325`.
  89. **Priority order:**
  90. 1. Command-line argument `--port` (highest priority)
  91. 2. Environment variable `PORT` (medium priority)
  92. 3. Default value `50325` (lowest priority)
  93. **Examples:**
  94. Using command-line argument:
  95. ```json
  96. {
  97. "mcpServers": {
  98. "adspower-local-api": {
  99. "command": "npx",
  100. "args": ["-y", "local-api-mcp-typescript", "--port", "50325"]
  101. }
  102. }
  103. }
  104. ```
  105. Using environment variable:
  106. ```json
  107. {
  108. "mcpServers": {
  109. "adspower-local-api": {
  110. "command": "npx",
  111. "args": ["-y", "local-api-mcp-typescript"],
  112. "env": {
  113. "PORT": "50325"
  114. }
  115. }
  116. }
  117. }
  118. ```
  119. ## Development
  120. ```bash
  121. # clone
  122. git clone https://github.com/AdsPower/adspower-browser.git
  123. cd adspower-browser
  124. # install (monorepo)
  125. pnpm install
  126. # build all packages
  127. pnpm run build
  128. ```
  129. For local MCP development, point Claude Desktop to the MCP package:
  130. ```json
  131. "mcpServers": {
  132. "adspower-local-api": {
  133. "command": "node",
  134. "args": ["<Replace Your Project Path>/adspower-browser/packages/local-api-mcp/build/index.js"]
  135. }
  136. }
  137. ```
  138. ### Use AdsPower Cli in Docker
  139. copy the [`/packages/adspower-browser/docker-compose.yml`](/packages/adspower-browser/docker-compose.yml)
  140. ```bash
  141. cd packages/adspower-browser
  142. docker-compose -f ./docker-compose.yml up -d
  143. docker-compose exec adspower-cli /bin/bash
  144. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.