Primeros pasos: gateway, segmentación y código

¿Cómo pruebo con curl?

Usa -x para proxies HTTP y --socks5-hostname para SOCKS5; la variante -hostname envía el nombre de host al proxy en lugar de resolverlo en tu máquina.

# 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

¿Cómo lo uso desde Python, con reintentos?

Las conexiones domésticas van y vienen, así que una solicitud puede fallar ocasionalmente con una IP lenta o desconectada. Reintenta con una IP nueva en vez de esperar: sin un ID de sesión, cada reintento obtiene uno nuevo. Codifica la contraseña si contiene caracteres especiales.

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"))

¿Cómo lo uso en un navegador con Playwright?

Pasa la puerta de enlace como proxy del navegador y la configuración del destino en el nombre de usuario. Establece la configuración regional y la zona horaria para que coincidan con el país, para que las páginas se muestren como para un visitante local.

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()

¿Qué ciudades y operadores puedo dirigir?

El direccionamiento por ciudad funciona donde el pool tiene IPs residenciales en línea en esa ciudad. La lista cambia durante el día, así que consúltala antes de hacer una ejecución a nivel de ciudad: el panel la muestra, y la API la devuelve con GET /v1/catalog/countries/{CC}/cities (mayúsculas en la API, minúsculas en el nombre de usuario del proxy) (ver la documentación API). Si una ciudad no tiene IPs en línea, elimina la ciudad y usa direccionamiento por país.

Para elegir un operador, añade su ASN: USERNAME-country-ae-asn-5384 tiene salidas en e& en los EAU. El direccionamiento por ASN no cuesta extra; GET /v1/catalog/countries/{CC}/asns lista los ASN en línea en un país, y la disponibilidad varía.

IDs de ciudad útiles: dubai, abu_dhabi, sharjah (EAU); riyadh, jeddah, dammam (Arabia Saudí); doha (Qatar); cairo, alexandria, giza (Egipto); casablanca, rabat (Marruecos); amman (Jordania); beirut (Líbano).

¿Qué suele salir mal?

• 407 Proxy Authentication Required: usuario o contraseña incorrectos, o un carácter especial en la contraseña que no fue codificado en URL.
• Conexión rechazada o timeout: puerto incorrecto; clientes HTTP necesitan 7777, clientes SOCKS5 7778.
• Salida en el país equivocado: falta o está mal escrito el código de país en el nombre de usuario; los códigos son dos letras, minúsculas.
• No hay IP en la ciudad: la ciudad no tiene IP residencial en línea ahora mismo; usa direccionamiento por país o prueba más tarde.
• Solicitud rechazada en la puerta de enlace: el destino está en una categoría bloqueada (Sitios bancarios, gubernamentales y portales de pago, además de puertos SMTP (envío de email) 25, 465 y 587).
• Plan agotado: el plan ha usado todo su GB; compra otro con tu saldo.