Telegram bot for creating Webshare proxy accounts — automated captcha solving, proxy pool, and admin panel.

✨ Features

  • 🚀 One-click account creation — auto generates email, solves captcha, registers on Webshare
  • 🧩 Multi-provider captcha — AZCaptcha & 2Captcha support, switchable via admin panel
  • 🎛 Proxy pool — admin-created proxies used for routing registrations, with health checking
  • 🛡️ Admin panel — stats, user management, broadcast, ban/unban, proxy settings
  • ⏱ Rate limiting — 1 registration per user per day (admin unlimited)
  • 📋 Proxy fetching — retrieve saved proxies from your accounts anytime
  • 💾 SQLite — zero-dependency local storage with WAL mode

🏗 Architecture

config.toml          → credentials & settings (gitignored)
config.py            → loads config.toml into constants
database.py          → SQLite layer (users, registrations, proxies, settings)
bot.py               → entry point, registers handlers
handlers/
  start.py           → /start, main menu dispatcher
  register.py        → auto + manual registration flows
  admin.py           → admin panel (stats, broadcast, users, proxy, captcha)
  proxies.py         → fetch proxies from saved accounts
services/
  scraper.py         → cloudscraper wrapper with proxy support
  captcha.py         → multi-provider captcha solver
  webshare.py        → Webshare API (register + fetch proxies)
  email_gen.py       → nullz email generation
  proxy_checker.py   → proxy health checking + pool management
ui/
  keyboards.py       → all inline keyboard builders
  messages.py        → message templates
utils/
  rate_limit.py      → daily rate limit checker
  validators.py      → email/password validation

🚀 Quick Start

# 1. Clone
git clone https://github.com/hirotomasato/pelerproxy.git
cd pelerproxy

# 2. Virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

# 3. Install dependencies
pip install -r requirements.txt

# 4. Configure
cp config.example.toml config.toml
# Edit config.toml with your bot token and admin IDs

# 5. Run
python bot.py

⚙️ Configuration

Edit config.toml after copying from config.example.toml:

Section Key Description
[bot] token Telegram bot token from @BotFather
[admin] ids List of admin Telegram user IDs
[captcha.azcaptcha] api_key AZCaptcha API key (or set via admin panel)
[captcha.2captcha] api_key 2Captcha API key
[captcha] default_provider "azcaptcha" or "2captcha"
[limits] max_registrations_per_day Daily limit per user (default: 1)

🤖 Commands

User

Command Description
/start Show main menu
🚀 Create Account (Auto) Auto-generate email, solve captcha, register
✍️ Register with Your Email Manual registration with your own email
📋 Get My Proxies Fetch proxies from your last account

Admin

Command Description
🛡️ Admin Panel Access admin dashboard
📊 Statistics View user/proxy stats
🧩 Captcha Settings Switch provider, set API key
🎛 Proxy Settings Toggle proxy mode, check/clean pool
👥 List Users Paginated user list with details
📢 Broadcast Send message to all users
🔨 Ban / Unban Manage user bans
🔄 Reset Limit Reset daily limit for a user

📄 License

MIT — see LICENSE for details.