AdsPower CLI & MCP

adspower-browserスキルの追加

adspower-browserスキルを使用すると、AIがMCPサーバーなしでCLI経由でAdsPowerを操作できるようになります。エディタに以下のように追加してください：

AdsPower LocalAPI MCPサーバー

AdsPowerブラウザのLocalAPIを操作するためのModel Context Protocolサーバーです。このサーバーにより、LLMはv2 APIを使用してAdsPowerブラウザプロファイルと対話でき、プロファイルの作成、更新、削除、グループ管理、ブラウザ操作の自動化が可能になります。

Claude Desktopでの使用方法

LLMに話しかけてブラウザを作成: Create an Android UA browser using Chrome 134

LLMに話しかけてブラウザを作成: Help me with random UA, random fingerprint, random cookie generation, create 3 browsers, use 134 cores, and open them

使用方法

要件

• AdsPower

• Nodeバージョン18以上

バージョンの互換性

一部のAPIはAdsPowerクライアントのバージョンアップに伴い段階的に導入されます。 特定のAPIを含むバージョンにクライアントがアップグレードされていない場合、リクエストが Not found を返すことがあります。

その場合は以下を行ってください：

• まずAdsPowerクライアントを最新のパッチバージョンにアップグレードしてください。

• その後、同じコマンド/APIを再試行してください。

インストール

Claude Desktopで使用するには、サーバー設定を追加します：

macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json

MacOS / Linux

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript"]
    }
  }
}

Windows

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "local-api-mcp-typescript"]
    }
  }
}

設定パラメータ

MCPサーバーは、コマンドライン引数または環境変数による設定をサポートしています。

ポート設定

ポートパラメータはAdsPower Local APIのポートを指定します。デフォルトは 50325 です。

優先順位:

1. コマンドライン引数 --port (最高優先度)

2. 環境変数 PORT (中優先度)

3. デフォルト値 50325 (最低優先度)

例:

コマンドライン引数を使用する場合:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript", "--port", "50325"]
    }
  }
}

環境変数を使用する場合:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript"],
      "env": {
        "PORT": "50325"
      }
    }
  }
}

APIキー設定

APIキーはAdsPower APIの認証に使用されます。リクエストの Authorization: Bearer <api-key> ヘッダーとして送信されます。

優先順位:

1. コマンドライン引数 --api-key (最高優先度)

2. 環境変数 API_KEY (中優先度)

3. デフォルト値なし (指定がない場合、リクエストにAPIキーヘッダーは含まれません)

例:

コマンドライン引数を使用する場合:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript", "--api-key", "your-api-key-here"]
    }
  }
}

環境変数を使用する場合:

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

組み合わせ設定

両方のパラメータを同時に使用できます。コマンドライン引数は環境変数を上書きします：

{
  "mcpServers": {
    "adspower-local-api": {
      "command": "npx",
      "args": ["-y", "local-api-mcp-typescript", "--port", "50326", "--api-key", "new-key"],
      "env": {
        "PORT": "50325",
        "API_KEY": "old-key"
      }
    }
  }
}

この例では、サーバーは port: 50326 および apiKey: new-key を使用します（コマンドライン引数が環境変数を上書きするため）。

またはCursorで使用

Related MCP server: Puppeteer MCP Server

開発

# clone
git clone https://github.com/AdsPower/adspower-browser.git
cd adspower-browser

# install (monorepo)
pnpm install

# build all packages
pnpm run build

ローカルでのMCP開発については、Claude DesktopでMCPパッケージを指定してください：

"mcpServers": {
  "adspower-local-api": {
    "command": "node",
    "args": ["<Replace Your Project Path>/adspower-browser/packages/local-api-mcp/build/index.js"]
  }
}