Primi passi: gateway, targeting e codice

Come testo con curl?

Usa -x per proxy HTTP e --socks5-hostname per SOCKS5; la variante -hostname invia il nome host al proxy invece di risolverlo sulla tua macchina.

# UAE, a new home IP on each new connection (each curl run)
curl -x http://USERNAME-country-ae:[email protected]:7777 https://ipinfo.io/json

# Riyadh, the same IP for 30 minutes (session id r1)
curl -x http://USERNAME-country-sa-city-riyadh-session-r1-ttl-30:[email protected]:7777 https://ipinfo.io/json

# Egypt over SOCKS5, hostname resolved by the proxy
curl --socks5-hostname gw.menaproxies.com:7778 -U USERNAME-country-eg:PASSWORD https://ipinfo.io/json

Come lo uso da Python, con tentativi?

Le connessioni domestiche vanno e vengono, quindi una richiesta può occasionalmente fallire su un IP lento o disconnesso. Ritenta con un nuovo IP invece di aspettare: senza un ID sessione, ogni tentativo ottiene uno nuovo. Codifica la password se contiene caratteri speciali.

import time
from urllib.parse import quote
import requests

GATEWAY = "gw.menaproxies.com:7777"
USER, PASSWORD = "USERNAME", quote("PASSWORD", safe="")

def fetch(url, country, session=None, ttl=30, tries=3):
    for attempt in range(1, tries + 1):
        user = f"{USER}-country-{country}"
        if session:  # a new session ID per attempt, so each retry gets a new IP
            user += f"-session-{session}{attempt}-ttl-{ttl}"
        proxy = f"http://{user}:{PASSWORD}@{GATEWAY}"
        try:
            r = requests.get(url, proxies={"http": proxy, "https": proxy}, timeout=30)
            if r.status_code < 500:
                return r
        except requests.RequestException:
            pass
        if attempt < tries:
            time.sleep(2 * attempt)  # back off, then retry on a new IP
    raise RuntimeError(f"{url} failed {tries} times via {country}")

for cc in ["ae", "sa", "eg"]:
    print(cc, fetch("https://ipinfo.io/json", cc).json().get("country"))

Come lo uso in un browser con Playwright?

Imposta il gateway come proxy del browser e il targeting nell'username. Imposta locale e fuso orario per corrispondere al paese, così le pagine si caricano come per un visitatore locale.

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.menaproxies.com:7777",
        "username": "USERNAME-country-sa-city-riyadh-session-pw1-ttl-30",
        "password": "PASSWORD",
    })
    context = browser.new_context(locale="ar-SA", timezone_id="Asia/Riyadh")
    page = context.new_page()
    page.goto("https://ipinfo.io/json")
    print(page.text_content("body"))
    browser.close()

Quali città e operatori posso targetizzare?

Il targeting per città funziona dove il pool ha IP residenziali online in quella città. La lista cambia durante il giorno, quindi consultala prima di una sessione per città: il dashboard la mostra e l'API la restituisce con GET /v1/catalog/countries/{CC}/cities (maiuscolo nell'API, minuscolo nell'username del proxy) (vedi la documentazione API). Se una città non ha IP online, elimina la città e usa il targeting per paese.

Per scegliere un operatore, aggiungi il suo ASN: USERNAME-country-ae-asn-5384 sono uscite su e& negli UAE. Il targeting ASN non costa extra; GET /v1/catalog/countries/{CC}/asns elenca gli ASN online in un paese, e la disponibilità varia.

ID città utili: dubai, abu_dhabi, sharjah (UAE); riyadh, jeddah, dammam (Arabia Saudita); doha (Qatar); cairo, alexandria, giza (Egitto); casablanca, rabat (Marocco); amman (Giordania); beirut (Libano).

Cosa va di solito storto?

• 407 Proxy Authentication Required: username o password errati, o un carattere speciale nella password non codificato in URL.
• Connessione rifiutata o timeout: porta sbagliata; i client HTTP usano 7777, i client SOCKS5 7778.
• Uscita nel paese sbagliato: il codice del paese manca o è scritto male nell'username; i codici sono di due lettere, minuscolo.
• Nessun IP nella città: la città non ha IP residenziali online ora; usa il targeting per paese o riprova più tardi.
• Richiesta rifiutata al gateway: il target è in una categoria bloccata (Siti bancari, governativi e portali di pagamento, più porte SMTP (invio email) 25, 465 e 587).
• Piano esaurito: il piano ha usato tutti i GB; acquista un altro dal tuo saldo.