# Adspower

> A Claude skill from pencil20388-eng/adspower-skill.

- **Type:** Skill
- **Install:** `agentstack add skill-pencil20388-eng-adspower-skill-adspower`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pencil20388-eng](https://agentstack.voostack.com/s/pencil20388-eng)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [pencil20388-eng](https://github.com/pencil20388-eng)
- **Source:** https://github.com/pencil20388-eng/adspower-skill/tree/main/adspower

## Install

```sh
agentstack add skill-pencil20388-eng-adspower-skill-adspower
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

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

### 2. Create a Profile

```python
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

```python
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

```python
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

```python
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

```python
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

```python
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

```python
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

```python
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:

```bash
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](https://www.adspower.net/)
- [Local API Documentation](https://localapi-doc-en.adspower.com/)
- [Ready-to-use Scripts & Guides](https://github.com/pencil20388-eng/awesome-adspower-automation)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [pencil20388-eng](https://github.com/pencil20388-eng)
- **Source:** [pencil20388-eng/adspower-skill](https://github.com/pencil20388-eng/adspower-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pencil20388-eng-adspower-skill-adspower
- Seller: https://agentstack.voostack.com/s/pencil20388-eng
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.