adspower

AdsPower Local API Automation Skill

Automate AdsPower antidetect browser operations through its Local API. This skill handles profile creation, browser control, proxy management, cookie operations, and fingerprint verification.

Prerequisites

• AdsPower installed and running locally (paid plan with API access)
• API Key generated (AdsPower → Automation → API → Generate)
• Python 3.8+ with requests installed

API Basics

Base URL: http://local.adspower.net:50325

All requests require the Authorization header:

Authorization: Bearer YOUR_API_KEY

Success response: {"code": 0, "msg": "success", "data": {...}} Error response: {"code": -1, "msg": "error description"}

Core Operations

1. Check API Status

curl -s -H "Authorization: Bearer $API_KEY" \
  "http://local.adspower.net:50325/api/v1/status"

2. Create a Profile

import requests

resp = requests.post(
    "http://local.adspower.net:50325/api/v1/user/create",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "name": "profile_001",
        "group_id": "0",
        "fingerprint_config": {
            "automatic_timezone": "1",
            "language": ["en-US", "en"],
        },
    },
).json()
profile_id = resp["data"]["id"]

3. Open a Browser Profile

resp = requests.get(
    f"http://local.adspower.net:50325/api/v1/browser/start?user_id={profile_id}",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=30,  # 30s timeout for slow proxies
).json()

# Connection info for automation frameworks:
webdriver_path = resp["data"]["webdriver"]
selenium_address = resp["data"]["ws"]["selenium"]     # For Selenium
puppeteer_ws = resp["data"]["ws"]["puppeteer"]         # For Playwright

4. Close a Browser Profile

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

5. Connect Selenium

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

service = Service(executable_path=webdriver_path)
options = Options()
options.add_experimental_option("debuggerAddress", selenium_address)
driver = webdriver.Chrome(service=service, options=options)
driver.get("https://www.browserscan.net/")