Commencer : passerelle, ciblage et code

Comment tester avec curl ?

Utilisez -x pour les proxies HTTP et --socks5-hostname pour SOCKS5 ; la variante -hostname envoie le nom d’hôte au proxy au lieu de le résoudre sur votre machine.

# 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

Comment l’utiliser depuis Python, avec des tentatives ?

Les connexions domestiques peuvent fluctuer, donc une requête peut parfois échouer avec une IP lente ou déconnectée. Retentez avec une nouvelle IP plutôt que d’attendre : sans ID session, chaque tentative reçoit une nouvelle IP. Encodez le mot de passe s’il contient des caractères spéciaux.

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

Comment l’utiliser dans un navigateur avec Playwright ?

Passez la passerelle comme proxy du navigateur et la cible dans le nom d’utilisateur. Réglez la langue et le fuseau horaire pour correspondre au pays, afin que les pages s’affichent comme pour un visiteur 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()

Quelles villes et opérateurs puis-je cibler ?

Le ciblage par ville fonctionne si le pool a des IP domicile en ligne dans cette ville. La liste change au fil de la journée, lisez-la avant d’exécuter un ciblage ville : elle s’affiche dans le tableau de bord, et l’API la renvoie avec GET /v1/catalog/countries/{CC}/cities (majuscule dans l’API, minuscule dans le nom d’utilisateur proxy) (voir la documentation API). Si aucune IP n’est en ligne dans une ville, ne ciblez pas la ville et utilisez le ciblage pays.

Pour choisir un opérateur, ajoutez son ASN : USERNAME-country-ae-asn-5384 propose des sorties sur e& aux Émirats. Le ciblage ASN ne coûte rien de plus ; GET /v1/catalog/countries/{CC}/asns liste les ASN en ligne dans un pays, la disponibilité varie.

Exemples d’identifiants villes utiles : dubai, abu_dhabi, sharjah (Émirats) ; riyadh, jeddah, dammam (Arabie Saoudite) ; doha (Qatar) ; cairo, alexandria, giza (Égypte) ; casablanca, rabat (Maroc) ; amman (Jordanie) ; beirut (Liban).

Qu’est-ce qui déconne le plus souvent ?

• 407 Proxy Authentication Required : nom d’utilisateur ou mot de passe incorrect, ou caractère spécial dans le mot de passe non encodé en URL.
• Connexion refusée ou timeout : mauvais port ; les clients HTTP doivent utiliser 7777, les clients SOCKS5 7778.
• Sortie dans un mauvais pays : code pays absent ou mal orthographié dans le nom d’utilisateur ; les codes sont en deux lettres, en minuscules.
• Pas d’IP dans la ville : aucune IP domicile en ligne dans cette ville pour le moment ; utilisez le ciblage pays ou réessayez plus tard.
• Requête refusée à la passerelle : la cible est dans une catégorie bloquée (Sites bancaires, gouvernementaux et portails de paiement, plus ports SMTP (envoi d’e-mails) 25, 465 et 587).
• Plan épuisé : le plan a consommé tous ses GB ; achetez-en un autre avec votre solde.