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

👁 Claude desktop

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

👁 Claude desktop

¿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).

👁 Claude desktop MCP

o úsalo en Cursor 👁 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"]
 }
}

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• click-elementC
• close-browserC
• connect-browser-with-wsC
• create-browserD
• create-groupC
• delete-browserC
• drag-elementD
• evaluate-scriptD