CLI y MCP de AdsPower

Añadir la habilidad adspower-browser

Utiliza la habilidad adspower-browser para que la IA pueda operar AdsPower a través de la CLI sin el servidor MCP. Añádela en tu editor de la siguiente manera:

Servidor MCP de AdsPower LocalAPI

Un servidor de Protocolo de Contexto de Modelo para la LocalAPI del navegador AdsPower. Este servidor permite a los LLM interactuar con los perfiles del navegador AdsPower utilizando la API v2, incluyendo la creación, actualización y eliminación de perfiles, la gestión de grupos y la automatización de operaciones del navegador.

Uso con Claude Desktop

Habla con los LLM para crear un navegador: Create an Android UA browser using Chrome 134

Habla con los LLM para crear un navegador: Help me with random UA, random fingerprint, random cookie generation, create 3 browsers, use 134 cores, and open them

¿Cómo usarlo?

Requisitos

• AdsPower

• Node versión 18 o superior

Compatibilidad de versiones

Algunas API se introducen de forma incremental según la versión del cliente de AdsPower. Si el cliente no se ha actualizado a una versión que incluya una API específica, las solicitudes pueden devolver Not found.

Cuando esto ocurra:

• Primero, actualiza el cliente de AdsPower a la última versión de parche.

• Luego, vuelve a intentar el mismo comando/API.

Instalación

Para usarlo con Claude Desktop, añade la configuración del servidor:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json En 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"]
    }
  }
}

Parámetros de configuración

El servidor MCP admite la configuración a través de argumentos de línea de comandos o variables de entorno.

Configuración del puerto

El parámetro de puerto especifica el puerto de la API local de AdsPower. El valor predeterminado es 50325.

Orden de prioridad:

1. Argumento de línea de comandos --port (prioridad más alta)

2. Variable de entorno PORT (prioridad media)

3. Valor predeterminado 50325 (prioridad más baja)

Ejemplos:

Usando el argumento de línea de comandos:

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

Usando la variable de entorno:

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

Configuración de la clave API

La clave API se utiliza para la autenticación con la API de AdsPower. Se enviará como encabezado Authorization: Bearer <api-key> en las solicitudes.

Orden de prioridad:

1. Argumento de línea de comandos --api-key (prioridad más alta)

2. Variable de entorno API_KEY (prioridad media)

3. Sin valor predeterminado (si no se proporciona, las solicitudes no incluirán el encabezado de clave API)

Ejemplos:

Usando el argumento de línea de comandos:

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

Usando la variable de entorno:

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

Configuración combinada

Puedes usar ambos parámetros juntos. Los argumentos de línea de comandos anularán las variables de entorno:

{
  "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"
      }
    }
  }
}

En este ejemplo, el servidor utilizará port: 50326 y apiKey: new-key (los argumentos de línea de comandos anulan las variables de entorno).

o úsalo en Cursor

Related MCP server: Puppeteer MCP Server

Desarrollo

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

# install (monorepo)
pnpm install

# build all packages
pnpm run build

Para el desarrollo local de MCP, apunta Claude Desktop al paquete MCP:

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