CLI do AdsPower: Automatize o Gerenciamento de Navegadores via Linha de Comando

O AdsPower lançou oficialmente uma ferramenta CLI (Interface de Linha de Comando) independente.

Tarefas que antes exigiam cliques na interface de desktop do AdsPower agora podem ser concluídas com uma única instrução de linha de comando. Criação e gerenciamento de perfis de navegador, inicialização e encerramento do navegador, troca de proxy, atualização de impressões digitais (fingerprint), recuperação de cookies, limpeza de cache, gerenciamento de grupos e tags são todos suportados diretamente do terminal.

A CLI opera de forma independente do cliente de desktop AdsPower. Ela não compartilha cache local, kernels de navegador ou ambientes de execução com o aplicativo principal.

Como Instalar

Existem dois métodos de instalação disponíveis.

Método 1: Instalar via npm (Recomendado para usuários com Node.js)

npm install -g adspower-browser

Após a instalação, os seguintes comandos estão disponíveis e funcionam de forma idêntica: adspower-browser , adspower , ads

Método 2: Instalar Diretamente

no Windows:

Usuários do Windows também podem instalar a CLI diretamente da página oficial de download do AdsPower.

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

no macOS:

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

no Linux:

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

Se o comando não for executado com sucesso, você pode baixar o instalador localmente e executá-lo manualmente.

Primeiros Passos

Iniciar a CLI:

ads start -k <KEY>

Se você já configurou a variável de ambiente ADS_API_KEY, pode simplesmente executar: ads start

Exemplo: Abrir um perfil de navegador:

ads open-browser <profile_id>

Exemplo: Fechar um perfil de navegador:

ads close-browser <profile_id>

Com apenas três comandos, uma instância de navegador pode ser totalmente iniciada e gerenciada.

Referência Rápida para Operações Diárias

Gerenciamento de Perfil 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 '{}'

Gerenciamento de Proxy

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":["..."]}'

Impressões Digitais, Cookies e Cache

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 e Tags

ads create-group '{"group_name":"My Group"}'
ads get-group-list '{}'
ads create-tag '{"tags":[{"name":"test","color":"darkBlue"}]}'

Gerenciamento do Kernel do Navegador

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

Você pode visualizar a lista completa de parâmetros para cada comando usando: ads -h

Como Isso Ajuda nas Operações de Negócios Reais

Aqui estão vários casos de uso práticos onde a CLI do AdsPower pode melhorar significativamente a eficiência do fluxo de trabalho.

Criação de Contas em Massa

• Antes: Criar perfis um por um na GUI.
• Depois: Escrever um script de loop para criar 50 ou 100 perfis de uma só vez, cada um com atribuição automática de proxy e marcação de grupo.

Manutenção Agendada

Atualizações de impressão digital (fingerprint), limpeza de cache e outras tarefas de manutenção agora podem ser adicionadas a tarefas agendadas e executadas automaticamente todos os dias.

Nenhuma monitoração manual é necessária. Tudo pode ser executado diretamente em um ambiente de servidor.

Operações em Lote

Precisa atualizar proxies para centenas de contas? Mover vários perfis para um novo grupo? Atualizar impressões digitais em massa?

A CLI possibilita a conclusão de tarefas de gerenciamento de contas em larga escala com um único comando, em vez de cliques manuais repetitivos.

Implantação em Servidor e Suporte Docker

A CLI do AdsPower também suporta implantação via Docker.

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

Uma vez dentro do contêiner, os usuários podem gerenciar diretamente instâncias de navegador usando o comando ads.

Isso permite que o AdsPower opere totalmente em ambientes de servidor headless (sem interface gráfica).

Integração com IA: MCP e Skills

Assistentes de Codificação de IA

O repositório GitHub da CLI inclui suporte a "Skills" para assistentes de codificação de IA. Instale no Cursor e ferramentas similares com um comando:

npx skills add AdsPower/adspower-browser

Suporte a MCP (Protocolo de Contexto de Modelo)

O repositório também integra suporte a MCP, permitindo que agentes de IA como Claude Code, Cursor, Codex e OpenCode controlem instâncias do navegador AdsPower diretamente.

Após a configuração, os assistentes de IA ganham automaticamente o contexto do AdsPower. Descreva o que você deseja fazer em linguagem natural, e a IA gera os comandos CLI correspondentes—perfeito para usuários não familiarizados com interfaces de linha de comando.

Por que isso importa: À medida que os agentes de IA assumem mais funções de execução nos fluxos de trabalho, o navegador, como a ferramenta central para a interação entre o agente e a web, precisa de capacidades de integração correspondentes. CLI, MCP e Skills estão todos disponíveis agora.

Fonte:

1. Documentação do GitHub
2. Baixe e instale a CLI do AdsPower aqui