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/")

6. Connect Playwright

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(puppeteer_ws)
    context = browser.contexts[0]
    page = context.pages[0] if context.pages else context.new_page()
    page.goto("https://www.browserscan.net/")

7. Update Proxy

requests.post(
    "http://local.adspower.net:50325/api/v1/user/update",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "user_id": profile_id,
        "user_proxy_config": {
            "proxy_soft": "other",
            "proxy_type": "http",       # http | https | socks5
            "proxy_host": "1.2.3.4",
            "proxy_port": "8080",       # Must be string
            "proxy_user": "username",
            "proxy_password": "password",
        },
    },
).json()

8. Query Profiles

resp = requests.get(
    "http://local.adspower.net:50325/api/v1/user/list",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"page": 1, "page_size": 100, "group_name": "My Campaign"},
).json()
profiles = resp["data"]["list"]

9. Create a Group

resp = requests.post(
    "http://local.adspower.net:50325/api/v1/group/create",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"group_name": "My Campaign"},
).json()
group_id = resp["data"]["group_id"]

Rate Limits

Profile count	Max frequency
0–200	2 req/sec
200–5000	5 req/sec
> 5000	10 req/sec

Profile creation is always limited to 1 req/sec. Add time.sleep(1.1) between batch operations.

Common Errors

Error	Cause	Fix
Connection refused	AdsPower not running	Start AdsPower, check API status
Invalid API key	Wrong or expired key	Regenerate in Automation → API
Error 100044	Browser start timeout	Check proxy, clear cache, increase timeout
Error 100001	Browser failed to start	Repair profile, update AdsPower
Too many requests	Rate limit exceeded	Add sleep between API calls
Profile not found	Wrong user_id	Query /api/v1/user/list to get correct IDs

Important Notes

• proxy_port must be a string, not an integer

• user_id is the internal ID from creation, not the profile name or UI number

• The API port (default 50325) can change between sessions — verify in AdsPower settings

• Always close browsers via API after automation to prevent resource leaks

• Use resp["data"]["ws"]["selenium"] for Selenium, resp["data"]["ws"]["puppeteer"] for Playwright

  Bundled Scripts

Profile Report Generator

Generate a CSV audit report of all profiles:

python3 ${CLAUDE_SKILL_DIR}/scripts/profile_report.py
python3 ${CLAUDE_SKILL_DIR}/scripts/profile_report.py --group "My Campaign"

Output includes: profile_id, name, group, proxy status, cookie status, creation time, last open time. Use this when the user asks to audit profiles, check proxy coverage, or generate a profile summary.

Resources

• AdsPower Official
• Local API Documentation
• Ready-to-use Scripts & Guides