Começando: gateway, segmentação e código

Como faço para testar com curl?

Use -x para proxies HTTP e --socks5-hostname para SOCKS5; a variante -hostname envia o nome do host para o proxy em vez de resolvê-lo na sua 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

Como usar com Python, com tentativas?

Conexões residenciais podem falhar ocasionalmente em IPs lentos ou desconectados. Faça tentativas com um novo IP ao invés de esperar: sem um ID de sessão, cada tentativa recebe um novo. Codifique a senha se ela conter caracteres especiais.

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

Como usar no navegador com Playwright?

Passe o gateway como proxy do navegador e o alvo no nome de usuário. Defina o local e o fuso horário para combinar com o país, para que as páginas renderizem como para um 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()

Quais cidades e operadoras posso escolher?

A segmentação por cidade funciona onde o pool tem IPs residenciais online nessa cidade. A lista muda durante o dia, então consulte antes de um uso por cidade: o painel mostra e a API retorna com GET /v1/catalog/countries/{CC}/cities (maiúsculo na API, minúsculo no nome de usuário do proxy) (veja a documentação da API). Se uma cidade não tiver IP online, desconsidere a cidade e use a segmentação por país.

Para escolher um operador, adicione seu ASN: USERNAME-country-ae-asn-5384 são saídas na e& nos Emirados Árabes Unidos. A segmentação por ASN não tem custo extra; GET /v1/catalog/countries/{CC}/asns lista os ASNs online em um país, e a disponibilidade varia.

IDs úteis de cidades: dubai, abu_dhabi, sharjah (EAU); riyadh, jeddah, dammam (Arábia Saudita); doha (Catar); cairo, alexandria, giza (Egito); casablanca, rabat (Marrocos); amman (Jordânia); beirut (Líbano).

O que costuma dar errado?

• 407 Proxy Authentication Required: nome de usuário ou senha errados, ou caractere especial na senha não codificado em URL.
• Conexão recusada ou tempo esgotado: porta errada; clientes HTTP precisam de 7777, clientes SOCKS5 precisam de 7778.
• Saída no país errado: o código do país está faltando ou errado no nome de usuário; códigos têm duas letras, minúsculas.
• Sem IP na cidade: a cidade não tem IP residencial online no momento; use segmentação por país ou tente depois.
• Solicitação recusada no gateway: o alvo está em uma categoria bloqueada (Sites bancários, governamentais e de portais de pagamento, além de portas SMTP (envio de email) 25, 465 e 587).
• Plano esgotado: o plano usou todo seu GB; compre outro com seu saldo.