Skip to content

pencil20388-eng/awesome-adspower-automation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

25 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

English | δΈ­ζ–‡ζ–‡ζ‘£

πŸš€ Awesome AdsPower Automation

Awesome License: MIT PRs Welcome

A curated collection of ready-to-use scripts, templates, and guides for AdsPower antidetect browser automation. Copy, paste, run.

Whether you manage 10 accounts or 10,000, this repo gives you production-ready code that works out of the box with AdsPower's Local API.


πŸ“¦ What's Inside

Folder Description Difficulty
/scripts/batch-create-profiles Create hundreds of browser profiles in one command ⭐ Beginner
/scripts/auto-open-close Open, perform tasks, and close browsers automatically ⭐ Beginner
/scripts/proxy-binding Batch bind/update proxies across all profiles ⭐⭐ Intermediate
/scripts/cookie-manager Import/export cookies for account warmup ⭐⭐ Intermediate
/scripts/fingerprint-checker Auto-open profiles and verify fingerprint on BrowserScan ⭐⭐ Intermediate
/templates/ Reusable config templates (proxy, fingerprint, groups) ⭐ Beginner
/guides/ Step-by-step setup guides with screenshots ⭐ Beginner

⚑ Quick Start (5 minutes)

Prerequisites

  • AdsPower installed and running (paid plan with API access)
  • Python 3.8+ installed
  • Your API Key (AdsPower β†’ Automation β†’ API β†’ Generate)

1. Clone this repo

git clone https://github.com/pencil20388-eng/awesome-adspower-automation.git
cd awesome-adspower-automation

2. Install dependencies

pip install -r requirements.txt

3. Configure your API Key

cp .env.example .env
# Edit .env and paste your API Key

4. Run your first script

python scripts/auto-open-close/open_and_visit.py

That's it. Your AdsPower profile opens, visits BrowserScan to verify the fingerprint, and closes automatically.

πŸ”‘ API Key Setup

  1. Open AdsPower, go to Automation β†’ API
  2. Check that API status shows Success
  3. Click Generate to get your API Key
  4. Copy the key into your .env file

Security tip: Never commit your .env file. It's already in .gitignore.

πŸ“‚ Script Details

Batch Create Profiles

Create 100 profiles with randomized fingerprints in under a minute.

# Just edit the number and run
python scripts/batch-create-profiles/create_profiles.py --count 50 --group "My Campaign"

Auto Open & Visit

Open a profile, navigate to any URL, take a screenshot, close.

python scripts/auto-open-close/open_and_visit.py --profile-id xxx --url "https://www.google.com"

Proxy Binding

Bind proxies from a CSV file to profiles in batch.

python scripts/proxy-binding/bind_proxies.py --csv proxies.csv

CSV format:

profile_id,proxy_type,host,port,username,password
h1abc123,http,1.2.3.4,8080,user1,pass1
h2def456,socks5,5.6.7.8,1080,user2,pass2

Fingerprint Checker

Open each profile, visit BrowserScan, screenshot the result.

python scripts/fingerprint-checker/check_all.py --group "My Campaign"

πŸ“‹ Templates

templates/proxy_config.json

{
  "proxy_type": "http",
  "proxy_host": "YOUR_PROXY_HOST",
  "proxy_port": "YOUR_PROXY_PORT",
  "proxy_user": "YOUR_USERNAME",
  "proxy_password": "YOUR_PASSWORD"
}

templates/fingerprint_config.json

{
  "automatic_timezone": "1",
  "language": ["en-US", "en"],
  "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
}

πŸ“š Guides

πŸ”— Official Resources

🀝 Contributing

Found a bug? Have a useful script? PRs are welcome!

  1. Fork this repo
  2. Create your branch (git checkout -b feature/my-script)
  3. Commit your changes (git commit -m 'Add: new script for XYZ')
  4. Push (git push origin feature/my-script)
  5. Open a Pull Request

⚠️ Disclaimer

This repository is for educational and legitimate business use only. Always comply with the terms of service of any platform you interact with. The authors are not responsible for any misuse of these tools.

πŸ“„ License

MIT β€” Use it, modify it, share it.


⭐ If this repo saved you time, give it a star! It helps others find it too.

About

πŸš€ Ready-to-use scripts & guides for AdsPower antidetect browser automation. Batch create profiles, bind proxies, check fingerprints β€” copy, paste, run.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages