proxy-hunter-botman 1.0.0

Fast concurrent proxy scraper and checker — by BotMan Army

Proxy Hunter

Fast concurrent proxy scraper and checker

By BotMan Army | Developer: morose1337

Telegram: t.me/botmanarmy | t.me/morose1337

Install

pip install proxy-hunter

Usage

Get working proxies (scrape + check)

from proxy_hunter import get_proxies

# Returns list of working proxies
proxies = get_proxies()
print(proxies)
# ['103.152.112.162:80', '47.88.31.226:8080', ...]

# With options
proxies = get_proxies(
    workers=500,
    timeout=8,
    verbose=True,
    save_to="working.txt",
)

Only scrape (no checking)

from proxy_hunter import grab_proxies

all_proxies = grab_proxies()
print(f"Grabbed {len(all_proxies)} proxies")

Check your own proxy list

from proxy_hunter import check

my_proxies = ["103.152.112.162:80", "47.88.31.226:8080"]
result = check(my_proxies, workers=100, timeout=5, verbose=True)

print(result["working"])       # list of working proxies
print(result["working_count"]) # count
print(result["elapsed"])       # seconds
print(result["rate"])          # proxies/sec

With callback

from proxy_hunter import get_proxies

def on_hit(proxy, latency_ms):
    print(f"Found: {proxy} ({latency_ms}ms)")

proxies = get_proxies(callback=on_hit)

CLI

# Default
proxy-hunter

# Custom
proxy-hunter -w 1000 -t 4 -o results.txt --insecure -v

# As module
python -m proxy_hunter -w 500 -v

API

get_proxies(**kwargs) -> list[str]

Scrape + check. Returns working proxies.

Param	Default	Description
workers	800	Concurrent threads
timeout	6	Seconds per proxy
retries	2	Retry attempts
verify_ssl	False	Verify SSL certs
verbose	False	Print live output
save_to	None	Save to file
callback	None	fn(proxy, latency_ms)

grab_proxies(verbose=False) -> list[str]

Scrape only, no checking.

check(proxies, **kwargs) -> dict

Check a given list. Returns dict with working, total, tested, working_count, failed_count, elapsed, rate.