Як використовувати AdsPower з Python: посібник з автоматизації

Як використовувати AdsPower з Python: посібник з автоматизації
30 вересня 2026 р.
17 хв читання

Як використовувати AdsPower з Python: посібник з автоматизації

AdsPower — це антидетект-браузер, який створює ізольовані браузерні профілі з унікальними відбитками, завдяки чому кожна сесія виглядає як окремий реальний пристрій. Python — це мова програмування загального призначення з багатою екосистемою для HTTP-запитів і автоматизації браузера. Разом вони дозволяють програмно керувати десятками або сотнями ізольованих профілів — без ручних кліків.

Цей посібник пояснює, як ці два продукти працюють разом, як налаштувати з'єднання та як писати практичні скрипти Python з використанням Selenium і Playwright. Він також охоплює проблеми, які вирішує це поєднання, та підводні камені, яких слід уникати.

Чому варто поєднувати AdsPower з Python?

Ручне керування кількома акаунтами — повільне й схильне до помилок. AdsPower вирішує проблему ідентичності: кожен профіль має власні налаштування Canvas, WebGL, User Agent та IP, тому акаунти не зв'язуються між собою. Python вирішує проблему масштабу: він може запускати профілі, підключати драйвери автоматизації, виконувати завдання та закривати профілі в циклі.

Це поєднання корисне для:

  • Операцій в електронній комерції — масове оновлення лістингів, перевірка цін і моніторинг замовлень через акаунти продавців.
  • Маркетингу в соціальних мережах — заплановані публікації та взаємодія через багато профілів.
  • Партнерського маркетингу — запуск CPA-кампаній без спрацьовування банів платформ.
  • Веб-скрейпінгу — збір даних із сайтів, які блокують повторні запити з одного відбитка.
  • QA та тестування — перевірка поведінки сайту за різних відбитків пристроїв.

Як AdsPower і Python з'єднуються

AdsPower запускає Local API на вашій машині. За замовчуванням він слухає на http://local.adspower.net:50325 (або http://127.0.0.1:50325). Скрипти Python надсилають HTTP-запити до цього API, щоб запускати та зупиняти браузерні профілі. Коли профіль запускається, API повертає деталі підключення — шлях до WebDriver і адресу налагоджувача для Selenium або WebSocket-ендпоінт для Playwright і Puppeteer.

Потім ваш скрипт Python підключає драйвер автоматизації до вже запущеного браузера. Це ключова відмінність від запуску звичайного браузера: ви не створюєте новий екземпляр браузера, а підключаєтеся до того, який AdsPower відкрив із правильним відбитком і проксі.

Попередні вимоги

Перш ніж писати код, переконайтеся, що у вас є:

  1. AdsPower встановлено та запущено на тій самій машині, що й ваш скрипт Python (або доступний через мережу).
  2. Local API увімкнено в налаштуваннях AdsPower.
  3. API-ключ, якщо ваша інсталяція Local API його вимагає. Ви можете знайти його в розділі API клієнта AdsPower.
  4. Створений профіль в AdsPower. Запам'ятайте його user_id (також називається profile_id у новіших версіях API).
  5. Python 3.10 або новіший встановлено.
  6. Необхідні пакети встановлено:
pip install requests selenium
# або для Playwright
pip install requests playwright
playwright install chromium

Якщо ви віддаєте перевагу типізованому SDK, на PyPI також є підтримуваний спільнотою пакет adspower, який обгортає Local API синхронними та асинхронними клієнтами. Він не обов'язковий, але може зменшити шаблонний код для керування профілями та проксі.

Покроково: AdsPower з Python Selenium

Найпоширеніше налаштування використовує requests для виклику Local API та selenium для керування браузером.

1. Запустіть профіль через Local API

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. Підключіть Selenium до запущеного браузера

Відповідь API містить data.webdriver (шлях до ChromeDriver) і data.ws.selenium (адреса налагоджувача). Для Selenium 4 використовуйте клас 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. Закрийте профіль

Завжди зупиняйте профіль після завершення роботи, інакше він залишиться відкритим і споживатиме ресурси:

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

Покроково: AdsPower з Python Playwright

Playwright використовує WebSocket-ендпоінт замість адреси налагоджувача. Процес схожий, але ви підключаєтеся через 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)

Зверніть увагу, що ключ WebSocket називається puppeteer, навіть коли ви використовуєте Playwright. Це тому, що AdsPower надає ендпоінт Chrome DevTools Protocol, який можуть використовувати обидва інструменти.

Практичний приклад: ротація профілів для скрейпінгу

Поширений шаблон — циклічно проходити список ідентифікаторів профілів, збирати одну сторінку на профіль і закривати кожен профіль перед переходом до наступного. Це підтримує передбачуване використання ресурсів і запобігає змішуванню відбитків.

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)

Для більших завдань ви можете запускати кілька профілів паралельно за допомогою потоків або asyncio з Playwright. Слідкуйте за використанням CPU та пам'яті й дотримуйтеся обмежень швидкості Local API (AdsPower документує глобальне обмеження та суворіші обмеження для певних ендпоінтів, як-от списки профілів).

Поширені підводні камені та як їх уникнути

  • Забути зупинити профілі. Якщо ваш скрипт аварійно завершиться, профілі можуть залишитися відкритими. Обгортайте роботу з браузером у try/finally і завжди викликайте ендпоінт зупинки.
  • Використання неправильної версії API. AdsPower має ендпоінти v1 і v2. Ендпоінти запуску/зупинки v1 широко використовуються та стабільні, але новіші SDK використовують v2. Перевірте офіційну документацію Local API для вашої версії.
  • Жорстке кодування API-ключів. Зберігайте ключі у змінних середовища або менеджері секретів, особливо якщо скрипти запускаються на спільних машинах.
  • Ігнорування обмежень швидкості. Надсилання занадто багатьох запитів до Local API може спричинити помилки. Додайте невеликі затримки або використовуйте клієнт, який враховує обмеження.
  • Змішування профілів в одній сесії браузера. Кожен профіль повинен мати власний екземпляр драйвера. Не використовуйте один драйвер для різних профілів.
  • Припущення, що браузер працює в headless-режимі. Профілі AdsPower за замовчуванням відкриваються у звичайному режимі. Якщо вам потрібна робота без графічного інтерфейсу, налаштуйте це в налаштуваннях профілю або в запиті на запуск.

Коли використовувати AdsPower з Python, а коли інші інструменти

Якщо ваша основна мета — простий збір даних із сайтів без суворих антибот-заходів, стандартної бібліотеки для скрейпінгу може бути достатньо. AdsPower з Python стає цінним, коли вам потрібні ізоляція відбитків, ротація проксі та збереження акаунтів одночасно.

Для ширшого огляду методів збору даних дивіться Автоматизований збір даних: інструменти, методи та найкращі практики. Якщо ви порівнюєте антидетект-браузери перед вибором, порівняння AdsPower vs Undetectable vs Genlogin охоплює якість відбитків, підтримку автоматизації та ціни.

Схожі матеріали

Джерела та додаткові матеріали

  • Приклади коду - Приклади коду для автоматизації AdsPower з Python, Javascript і Java. Приклади коду Chrome, Python Selenium. Демо пройшло тест у selenium версії 3.141.0 import requests,time from selenium import webdriver fro
  • adspower - Типізований синхронний та асинхронний Python SDK для AdsPower Local API.
  • Proxy-Seller × AdsPower: посібник з веб-скрейпінгу - Насолоджуйтеся відео та музикою, які вам подобаються, завантажуйте власний контент і діліться ним з друзями, родиною та світом на YouTube.

Часті запитання

Чи потрібен мені API-ключ для використання AdsPower з Python?

Це залежить від конфігурації вашого Local API. Деякі інсталяції дозволяють неавтентифіковані локальні запити, тоді як інші вимагають Bearer-токен. Якщо ваші запити повертають помилку авторизації, додайте заголовок Authorization: Bearer <api_key>.

Чи можу я використовувати AdsPower з Python на віддаленому сервері?

Так, але Local API має бути доступним із сервера. За замовчуванням він прив'язаний до localhost. Для віддалених налаштувань вам може знадобитися безпечно відкрити API або використовувати рішення для тунелювання. Деякі SDK пропонують опцію перезапису ендпоінта для Docker або віддалених топологій.

Яка бібліотека автоматизації Python найкраще працює з AdsPower?

Selenium і Playwright обидві офіційно підтримуються. Selenium частіше використовується в існуючих скриптах; Playwright пропонує швидше виконання та вбудовану підтримку асинхронності. Виберіть залежно від знайомства вашої команди та потреби в паралельному виконанні.

Скільки профілів я можу запустити одночасно?

Обмеження залежить від CPU, RAM вашої машини та кількості проксі. Типовий настільний комп'ютер може обробляти 5–20 одночасних профілів для легких завдань. Для важчих навантажень розподіляйте їх між кількома машинами або використовуйте хмарне налаштування.

Чи надає AdsPower Python SDK?

AdsPower надає приклади коду та Local API. Підтримуваний спільнотою типізований SDK існує на PyPI, але це не офіційний продукт AdsPower. Ви завжди можете викликати API безпосередньо через requests.

Висновок

AdsPower і Python — практична пара для всіх, хто керує кількома онлайн-ідентичностями. AdsPower забезпечує ізоляцію відбитків і призначення проксі; Python забезпечує оркестрацію, обробку даних і масштаб. Почніть з одного профілю та простого скрипта Selenium, а потім переходьте до паралельних воркерів Playwright у міру зростання потреб. Зберігайте API-ключі в безпеці, завжди закривайте профілі та дотримуйтеся обмежень швидкості — і ви отримаєте надійний конвеєр автоматизації для електронної комерції, маркетингу, скрейпінгу та тестування.

Drive revenue with AdsPower

Start free