AdsPower cli & MCP

Добавление навыка adspower-browser

Используйте навык adspower-browser, чтобы ИИ мог управлять AdsPower через CLI без использования MCP-сервера. Добавьте его в свой редактор следующим образом:

AdsPower LocalAPI MCP Server

Сервер протокола контекста модели (MCP) для LocalAPI браузера AdsPower. Этот сервер позволяет LLM взаимодействовать с профилями браузера AdsPower с использованием API v2, включая создание, обновление, удаление профилей, управление группами и автоматизацию операций в браузере.

Использование с 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-сервер поддерживает настройку через аргументы командной строки или переменные окружения.

Настройка порта

Параметр порта определяет порт локального API AdsPower. По умолчанию используется 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 используется для аутентификации в API AdsPower. Он будет отправляться в запросах в заголовке 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"]
  }
}