AdsPower CLI: Gestión automatizada de navegadores desde la línea de comandos

AdsPower ha lanzado oficialmente una herramienta independiente: la CLI (Interfaz de Línea de Comandos).

Las tareas que anteriormente requerían hacer clics en la interfaz de escritorio de AdsPower ahora pueden completarse con una sola instrucción de línea de comandos. La creación y gestión de perfiles de navegador, el lanzamiento y cierre del navegador, el cambio de proxy, la actualización de huellas digitales (fingerprints), la recuperación de cookies, la limpieza de caché, la gestión de grupos y las etiquetas son todas acciones soportadas directamente desde la terminal.

La CLI funciona de forma independiente al cliente de escritorio de AdsPower. No comparte la caché local, los núcleos del navegador ni los entornos de ejecución con la aplicación principal.

Instalación

Existen dos métodos de instalación disponibles.

Método 1: Instalación vía npm (Recomendado para usuarios de Node.js)

npm install -g adspower-browser

Tras la instalación, los siguientes comandos estarán disponibles y funcionarán de forma idéntica: adspower-browser , adspower , ads

Método 2: Instalación directa

En Windows:

Los usuarios de Windows también pueden instalar la CLI directamente desde la página oficial de descargas de AdsPower.

irm https://www.adspower.com/install.ps1 | iex

En macOS:

curl -fsSL https://www.adspower.com/install.sh | bash

En Linux:

curl -fsSL https://www.adspower.com/install.sh | bash

Si el comando no se ejecuta correctamente, puedes descargar el instalador localmente y ejecutarlo de forma manual.

Cómo empezar

Iniciar la CLI:

ads start -k <CLAVE>

Si ya has configurado la variable de entorno ADS_API_KEY, simplemente puedes ejecutar: ads start

Ejemplo: Abrir un perfil de navegador:

ads open-browser <id_del_perfil>

Ejemplo: Cerrar un perfil de navegador:

ads close-browser <id_del_perfil>

Con solo tres comandos, se puede lanzar y gestionar completamente una instancia del navegador.

Referencia rápida para operaciones diarias

Gestión de perfiles de navegador

ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"}}'
ads update-browser '{"profile_id":"..."}'
ads delete-browser '{"profile_id":["..."]}'
ads get-browser-list '{}'

Gestión de proxies

ads create-proxy '[{"type":"http","host":"127.0.0.1","port":"8080"}]'
ads get-proxy-list '{}'
ads update-proxy '{"proxy_id":"proxy-1","proxy_url":"https://refresh.example.com"}'
ads delete-proxy '{"proxy_id":["..."]}'

Huellas digitales, cookies y caché

ads new-fingerprint <profile_id>
ads get-profile-cookies <profile_id>
ads delete-cache-v2 '{"profile_id":["..."],"type":["cookie","history"]}'
ads get-profile-ua <profile_id>

Grupos y etiquetas

ads create-group '{"group_name":"Mi Grupo"}'
ads get-group-list '{}'
ads create-tag '{"tags":[{"name":"prueba","color":"darkBlue"}]}'

Gestión del núcleo del navegador

ads get-kernel-list '{"kernel_type":"Chrome"}'
ads download-kernel '{"kernel_type":"Chrome","kernel_version":"..."}'

Puedes ver la lista completa de parámetros para cada comando usando: ads -h

Beneficios prácticos en operaciones reales

Aquí hay varios casos de uso prácticos donde la CLI de AdsPower puede mejorar significativamente la eficiencia del flujo de trabajo.

Creación masiva de cuentas

• Antes: Crear perfiles uno por uno en la interfaz gráfica (GUI).
• Después: Escribir un script en bucle para crear 50 o 100 perfiles de una vez, cada uno con asignación automática de proxy y etiquetado de grupo.

Mantenimiento programado

La actualización de huellas digitales, la limpieza de caché y otras tareas de mantenimiento ahora pueden añadirse a trabajos programados (cron jobs) y ejecutarse automáticamente todos los días.

No se requiere monitorización manual. Todo puede ejecutarse directamente en un entorno de servidor.

Operaciones por lotes

¿Necesitas actualizar proxies para cientos de cuentas? ¿Mover múltiples perfiles a un nuevo grupo? ¿Actualizar huellas digitales de forma masiva?

La CLI hace posible completar tareas de gestión de cuentas a gran escala con un solo comando, en lugar de clics manuales repetitivos.

Despliegue en servidor y soporte Docker

La CLI de AdsPower también soporta el despliegue con Docker.

docker-compose -f ./docker-compose.yml up -d
docker-compose exec adspower-cli /bin/bash

Una vez dentro del contenedor, los usuarios pueden gestionar directamente las instancias del navegador usando el comando 'ads'.

Esto permite que AdsPower opere completamente en entornos de servidor sin interfaz gráfica (headless).

Integración con IA: MCP y Skills

Asistentes de programación con IA

El repositorio de GitHub de la CLI incluye soporte de 'Skills' para asistentes de codificación de IA. Instálalo en Cursor y herramientas similares con un solo comando:

npx skills add AdsPower/adspower-browser

Soporte MCP (Protocolo de Contexto de Modelo)

El repositorio también integra soporte MCP, permitiendo que agentes de IA como Claude Code, Cursor, Codex y OpenCode controlen directamente las instancias del navegador AdsPower.

Después de la configuración, los asistentes de IA obtienen automáticamente el contexto de AdsPower. Describe lo que quieres hacer en lenguaje natural, y la IA genera los comandos CLI correspondientes; perfecto para usuarios no familiarizados con interfaces de línea de comandos.

Por qué es importante: A medida que los agentes de IA asumen más roles de ejecución en los flujos de trabajo, el navegador, como herramienta central para la interacción entre el agente y la web, necesita capacidades de integración correspondientes. CLI, MCP y Skills ya están disponibles para esto.

Fuentes:

1. Documentación en GitHub
2. Descarga e instala la CLI de AdsPower aquí