Como Usar o AdsPower com Python: Guia de Automação

Como Usar o AdsPower com Python: Guia de Automação
30 de setembro de 2026
18 min de leitura

Como Usar o AdsPower com Python: Guia de Automação

O AdsPower é um navegador anti-detect que cria perfis de navegador isolados com impressões digitais únicas, para que cada sessão pareça um dispositivo real separado. Python é uma linguagem de programação de uso geral com um rico ecossistema para requisições HTTP e automação de navegador. Juntos, eles permitem controlar dezenas ou centenas de perfis isolados programaticamente — sem necessidade de cliques manuais.

Este guia explica como os dois produtos funcionam juntos, como configurar a conexão e como escrever scripts Python práticos usando Selenium e Playwright. Também aborda os problemas que essa combinação resolve e as armadilhas a evitar.

Por que combinar o AdsPower com Python?

Gerenciar várias contas manualmente é lento e propenso a erros. O AdsPower resolve o problema de identidade: cada perfil tem sua própria configuração de Canvas, WebGL, User Agent e IP, para que as contas não sejam vinculadas. O Python resolve o problema de escala: ele pode iniciar perfis, anexar drivers de automação, executar tarefas e fechar perfis em um loop.

A combinação é útil para:

  • Operações de e-commerce — atualizações em massa de listagens, verificação de preços e monitoramento de pedidos em contas de vendedores.
  • Marketing em redes sociais — postagens agendadas e engajamento em vários perfis.
  • Marketing de afiliados — execução de campanhas de CPA sem acionar banimentos de plataformas.
  • Web scraping — coleta de dados de sites que bloqueiam requisições repetidas de uma única impressão digital.
  • QA e testes — verificação de como um site se comporta sob diferentes impressões digitais de dispositivos.

Como o AdsPower e o Python se conectam

O AdsPower executa uma API Local na sua máquina. Por padrão, ela escuta em http://local.adspower.net:50325 (ou http://127.0.0.1:50325). Scripts Python enviam requisições HTTP para essa API para iniciar e parar perfis de navegador. Quando um perfil é iniciado, a API retorna detalhes de conexão — um caminho do WebDriver e um endereço de depurador para Selenium, ou um endpoint WebSocket para Playwright e Puppeteer.

Seu script Python então anexa um driver de automação a esse navegador já em execução. Essa é a principal diferença em relação a iniciar um navegador normal: você não está criando uma nova instância de navegador, está se conectando à que o AdsPower abriu com a impressão digital e o proxy corretos.

Pré-requisitos

Como Usar o AdsPower com Python: Guia de Automação - Pré-requisitos

Como Usar o AdsPower com Python: Guia de Automação - Pré-requisitos.

Antes de escrever código, certifique-se de ter:

  1. AdsPower instalado e em execução na mesma máquina que seu script Python (ou acessível pela rede).
  2. API Local habilitada nas configurações do AdsPower.
  3. Uma chave de API se sua instalação da API Local exigir uma. Você pode encontrá-la na seção de API do cliente AdsPower.
  4. Um perfil criado no AdsPower. Anote seu user_id (também chamado de profile_id em versões mais recentes da API).
  5. Python 3.10 ou mais recente instalado.
  6. Pacotes necessários instalados:
pip install requests selenium
# ou para Playwright
pip install requests playwright
playwright install chromium

Se você preferir um SDK tipado, também há um pacote adspower mantido pela comunidade no PyPI que envolve a API Local com clientes síncronos e assíncronos. Ele não é obrigatório, mas pode reduzir o código repetitivo para gerenciamento de perfis e proxies.

Passo a passo: AdsPower com Python Selenium

A configuração mais comum usa requests para chamar a API Local e selenium para controlar o navegador.

1. Inicie um perfil via API Local

import requests

ads_id = "your_profile_id"
api_key = "your_api_key"

open_url = f"http://local.adspower.net:50325/api/v1/browser/start?user_id={ads_id}"
headers = {"Authorization": f"Bearer {api_key}"}

resp = requests.get(open_url, headers=headers).json()

if resp["code"] != 0:
    raise RuntimeError(f"Failed to start profile: {resp['msg']}")

print("Profile started")

2. Anexe o Selenium ao navegador em execução

A resposta da API contém data.webdriver (o caminho do ChromeDriver) e data.ws.selenium (o endereço do depurador). Para o Selenium 4, use a classe Service:

from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.chrome.service import Service

chrome_driver = resp["data"]["webdriver"]
debugger_address = resp["data"]["ws"]["selenium"]

service = Service(executable_path=chrome_driver)
options = Options()
options.add_experimental_option("debuggerAddress", debugger_address)

driver = webdriver.Chrome(service=service, options=options)
driver.get("https://www.browserscan.net/")
print(driver.title)

3. Feche o perfil

Sempre pare o perfil quando terminar, caso contrário ele permanece aberto e consome recursos:

driver.quit()
close_url = f"http://local.adspower.net:50325/api/v1/browser/stop?user_id={ads_id}"
requests.get(close_url, headers=headers)

Passo a passo: AdsPower com Python Playwright

O Playwright usa um endpoint WebSocket em vez de um endereço de depurador. O fluxo é semelhante, mas você se conecta via CDP.

import requests
from playwright.sync_api import sync_playwright

ads_id = "your_profile_id"
api_key = "your_api_key"

open_url = f"http://local.adspower.net:50325/api/v1/browser/start?user_id={ads_id}"
headers = {"Authorization": f"Bearer {api_key}"}

resp = requests.get(open_url, headers=headers).json()
ws_endpoint = resp["data"]["ws"]["puppeteer"]

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(ws_endpoint)
    context = browser.contexts[0]
    page = context.pages[0] if context.pages else context.new_page()
    page.goto("https://example.com")
    print(page.title())
    browser.close()

requests.get(f"http://local.adspower.net:50325/api/v1/browser/stop?user_id={ads_id}", headers=headers)

Observe que a chave do WebSocket é chamada puppeteer mesmo quando você usa o Playwright. Isso ocorre porque o AdsPower expõe um endpoint do Chrome DevTools Protocol que ambas as ferramentas podem consumir.

Exemplo prático: rotacionando perfis para scraping

Um padrão comum é percorrer uma lista de IDs de perfis, fazer scraping de uma página por perfil e fechar cada perfil antes de passar para o próximo. Isso mantém o uso de recursos previsível e evita a mistura de impressões digitais.

import requests, time
from selenium import webdriver
from selenium.webdriver.chrome.options import Options
from selenium.webdriver.chrome.service import Service

API = "http://local.adspower.net:50325"
API_KEY = "your_api_key"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
PROFILES = ["profile_1", "profile_2", "profile_3"]

def scrape(profile_id, url):
    start = requests.get(f"{API}/api/v1/browser/start?user_id={profile_id}", headers=HEADERS).json()
    if start["code"] != 0:
        print(f"Skip {profile_id}: {start['msg']}")
        return None

    service = Service(executable_path=start["data"]["webdriver"])
    options = Options()
    options.add_experimental_option("debuggerAddress", start["data"]["ws"]["selenium"])
    driver = webdriver.Chrome(service=service, options=options)

    try:
        driver.get(url)
        time.sleep(2)
        return driver.title
    finally:
        driver.quit()
        requests.get(f"{API}/api/v1/browser/stop?user_id={profile_id}", headers=HEADERS)

for pid in PROFILES:
    title = scrape(pid, "https://example.com")
    print(pid, title)

Para trabalhos maiores, você pode executar vários perfis em paralelo usando threads ou asyncio com Playwright. Fique de olho na CPU e na memória, e respeite os limites de taxa da API Local (o AdsPower documenta um limite global e limites mais rígidos em certos endpoints, como listagens de perfis).

Armadilhas comuns e como evitá-las

  • Esquecer de parar os perfis. Se seu script travar, os perfis podem permanecer abertos. Envolva o trabalho do navegador em try/finally e sempre chame o endpoint de parada.
  • Usar a versão errada da API. O AdsPower tem endpoints v1 e v2. Os endpoints de start/stop v1 são amplamente usados e estáveis, mas SDKs mais recentes usam v2. Consulte a documentação oficial da API Local para sua versão.
  • Codificar chaves de API diretamente. Armazene chaves em variáveis de ambiente ou em um gerenciador de segredos, especialmente se os scripts forem executados em máquinas compartilhadas.
  • Ignorar limites de taxa. Enviar muitas requisições para a API Local pode causar erros. Adicione pequenos atrasos ou use um cliente ciente de limites de taxa.
  • Misturar perfis em uma sessão de navegador. Cada perfil deve ter sua própria instância de driver. Não reutilize um driver entre perfis.
  • Presumir que o navegador é headless. Os perfis do AdsPower abrem no modo normal por padrão. Se você precisar de operação headless, configure isso nas configurações do perfil ou na requisição de inicialização.

Quando usar o AdsPower com Python vs. outras ferramentas

Se seu objetivo principal é a coleta simples de dados de sites sem medidas anti-bot rigorosas, uma biblioteca padrão de scraping pode ser suficiente. O AdsPower com Python se torna valioso quando você precisa de isolamento de impressão digital, rotação de proxy e persistência de conta ao mesmo tempo.

Para uma visão mais ampla dos métodos de coleta de dados, consulte Coleta Automatizada de Dados: Ferramentas, Métodos e Melhores Práticas. Se você está comparando navegadores anti-detect antes de se comprometer, a comparação AdsPower vs Undetectable vs Genlogin aborda qualidade de impressão digital, suporte à automação e preços.

Leitura relacionada

Fontes e leitura adicional

  • Exemplos de Código - Exemplos de código para automatizar o AdsPower com Python, Javascript e Java. Exemplos de código Chrome Python Selenium A demonstração passou no teste na versão 3.141.0 do selenium import requests,time from selenium import webdriver fro
  • adspower - SDK Python síncrono e assíncrono tipado para a API Local do AdsPower.
  • Proxy-Seller × AdsPower: Tutorial de Web Scraping - Aproveite os vídeos e músicas que você ama, faça upload de conteúdo original e compartilhe tudo com amigos, familiares e o mundo no YouTube.

FAQ

Preciso de uma chave de API para usar o AdsPower com Python?

Depende da configuração da sua API Local. Algumas instalações permitem requisições locais não autenticadas, enquanto outras exigem um token Bearer. Se suas requisições retornarem um erro de autorização, adicione o cabeçalho Authorization: Bearer <api_key>.

Posso usar o AdsPower com Python em um servidor remoto?

Sim, mas a API Local deve ser acessível a partir do servidor. Por padrão, ela se vincula ao localhost. Para configurações remotas, talvez seja necessário expor a API com segurança ou usar uma solução de tunelamento. Alguns SDKs oferecem uma opção de reescrita de endpoint para Docker ou topologias remotas.

Qual biblioteca de automação Python funciona melhor com o AdsPower?

Selenium e Playwright são ambos oficialmente suportados. O Selenium é mais comum em scripts existentes; o Playwright oferece execução mais rápida e suporte assíncrono integrado. Escolha com base na familiaridade da sua equipe e se você precisa de execução paralela.

Quantos perfis posso executar ao mesmo tempo?

O limite depende da CPU, RAM e do número de proxies da sua máquina. Um desktop típico pode lidar com 5–20 perfis simultâneos para tarefas leves. Para cargas de trabalho mais pesadas, distribua entre várias máquinas ou use uma configuração baseada em nuvem.

O AdsPower fornece um SDK Python?

O AdsPower fornece exemplos de código e uma API Local. Existe um SDK tipado mantido pela comunidade no PyPI, mas não é um produto oficial do AdsPower. Você sempre pode chamar a API diretamente com requests.

Conclusão

AdsPower e Python são um par prático para qualquer pessoa que gerencia múltiplas identidades online. O AdsPower cuida do isolamento de impressão digital e da atribuição de proxy; o Python cuida da orquestração, processamento de dados e escala. Comece com um único perfil e um script Selenium simples, depois expanda para workers Playwright paralelos conforme suas necessidades crescerem. Mantenha suas chaves de API seguras, sempre feche os perfis e respeite os limites de taxa — e você terá um pipeline de automação confiável para e-commerce, marketing, scraping e testes.

Drive revenue with AdsPower

Start free