proxywhirl 0.3.0

Advanced Python proxy rotation library with auto-fetching, validation, and persistence

🌀 Intelligent proxy rotation that just works

   

📖 Docs
  
🚀 Examples
  
💬 Discussions

---

⚡ 30-Second Setup

pip install proxywhirl

from proxywhirl import ProxyWhirl

rotator = ProxyWhirl(proxies=["http://p1:8080", "http://p2:8080"])
response = rotator.get("https://api.example.com/data")
# Dead proxies auto-ejected ✓ | Slow ones deprioritized ✓ | Fast ones favored ✓

---

🎯 Why ProxyWhirl?

9 Strategies Round-robin, weighted, geo-targeted, performance-based & more

120 Sources Auto-fetch from built-in providers with validation

Self-Healing Auto-eject dead proxies, circuit breakers, recovery

Blazing Fast Async-first, <3μs selection, zero blocking

---

🔄 Rotation Strategies

# Switch strategies on the fly
rotator = ProxyWhirl(strategy="performance-based")
rotator.set_strategy("geo-targeted", preferences={"US": [...], "EU": [...]})

Strategy	Best For
round-robin	Even distribution
random	Unpredictable patterns
weighted	Favor reliable proxies
performance-based	Lowest latency
geo-targeted	Regional routing
session-persistence	Sticky sessions
cost-aware	Budget optimization
composite	Custom pipelines

---

🎣 Auto-Fetch Proxies

from proxywhirl import ProxyFetcher

# Grab 300+ validated proxies in seconds
proxies = await ProxyFetcher().fetch_all(validate=True)

---

🖥️ Multiple Interfaces

Python API rotator.get(url) rotator.post(url, json=data) async with AsyncProxyWhirl() as async_rotator: await async_rotator.get(url)

CLI proxywhirl fetch proxywhirl pool list proxywhirl health

REST API docker-compose up -d curl localhost:8000/api/v1/proxies

---

📚 Learn More

  📖 Full Documentation  
   
  🎯 Strategy Guide  
   
  🤖 MCP Server  
   
  📓 Examples  

---

GitHub · Issues · MIT License

_{Built with ❤️ for ethical web automation}