Proxy résidentiel : guide de configuration et de connexion

Créez un compte sur la page d'inscription et vous recevez un jeton d'accès au format pm_XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX. Ce même jeton vous connecte au site et sert de mot de passe proxy.

Le serveur ne conserve qu'une empreinte (hash) du jeton et ses 4 derniers caractères. Enregistrez-le dans un gestionnaire de mots de passe ou un autre endroit sûr avant de quitter la page.

Un jeton perdu ne peut pas être récupéré. Dans votre code, lisez-le depuis une variable d'environnement pour qu'il ne se retrouve jamais dans un dépôt.

Vous pouvez créer jusqu'à 3 comptes par adresse IP, et la connexion autorise 10 essais par tranche de 10 minutes.

Les proxies puisent dans votre solde : rechargez donc d'abord. Un seul solde couvre les proxies résidentiels rotatifs, les proxies ISP statiques, les proxies datacenter et les proxies mobiles.

Le trafic résidentiel rotatif commence à $0.80/GB et le trafic mobile à $4.00/GB, facturés selon votre consommation. Par exemple, $100 dépensés en résidentiel rotatif achètent $100 divisés par $0.80/GB de trafic. Consultez les montants de recharge et les bonus sur la page des tarifs.

Le nom d'utilisateur commence par user et ajoute des parties optionnelles reliées par -. Le mot de passe est toujours votre jeton d'accès. Sans partie ajoutée, vous obtenez une IP résidentielle rotative sans pays défini.

Écrire les parties dans l'ordre type, pays, ville, session les garde lisibles. user-country-jp-city-tokyo-session-shop1 signifie une IP de Tokyo conservée sous le nom de session shop1.

Les proxies mobiles ne ciblent que par pays : n'indiquez pas de ville lorsque vous utilisez type-mobile. Les codes pays et les listes de villes se trouvent sur la page pays et villes.

HTTP et SOCKS5 partagent le même hôte gate.proxymay.com et le même port 7000. Choisissez celui de ces trois formats que votre outil accepte.

http://user-country-jp:[email protected]:7000
socks5://user-country-jp:[email protected]:7000
gate.proxymay.com:7000:user-country-jp:YOUR_TOKEN

Le tableau de bord génère les mêmes chaînes à copier. Les deux premières lignes sont des formats URL ; la dernière est destinée aux outils qui attendent host:port:user:password.

Avant d'écrire du code, testez depuis un terminal. Cela permet de cerner rapidement les problèmes. Vérifiez que les champs ip, country et city de la réponse correspondent à votre nom d'utilisateur.

curl -x http://user-country-us:[email protected]:7000 https://ipinfo.io/json

# Same check over SOCKS5
curl -x socks5h://user-country-us:[email protected]:7000 https://ipinfo.io/json

Avec socks5h, les résolutions DNS passent elles aussi par le proxy.

Avec requests, placez la même URL sous http et https dans le dictionnaire proxies. Cet exemple conserve une IP japonaise sous la session shop1.

import requests

proxy = "http://user-country-jp-session-shop1:[email protected]:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30)
print(r.status_code, r.json())

Pour SOCKS5, lancez pip install requests[socks] et remplacez le schéma par socks5h://.

Avec Scrapy, définissez proxy dans les meta de la requête et le middleware intégré gère l'authentification. Donnez à chaque requête son propre nom de session si vous voulez une IP différente par page.

import scrapy

class IpSpider(scrapy.Spider):
    name = "ipcheck"

    def start_requests(self):
        proxy = "http://user-country-gb:[email protected]:7000"
        yield scrapy.Request("https://ipinfo.io/json", meta={"proxy": proxy})

    def parse(self, response):
        yield response.json()

Avec Node.js 18 ou version ultérieure, passez le ProxyAgent d'undici comme dispatcher de fetch. Si vous utilisez axios, transmettez la même URL au paquet https-proxy-agent.

// npm install undici
import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-de:[email protected]:7000");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

Les outils d'automatisation de navigateur prennent le serveur et les identifiants séparément. Placez vos options de ciblage dans le nom d'utilisateur et votre jeton dans le mot de passe.

// Playwright
const { chromium } = require("playwright");

const browser = await chromium.launch({
  proxy: {
    server: "http://gate.proxymay.com:7000",
    username: "user-country-fr-city-paris-session-web1",
    password: "YOUR_TOKEN",
  },
});
const page = await browser.newPage();
await page.goto("https://ipinfo.io/json");

// Puppeteer
const browser2 = await puppeteer.launch({ args: ["--proxy-server=http://gate.proxymay.com:7000"] });
const page2 = await browser2.newPage();
await page2.authenticate({ username: "user-country-fr", password: "YOUR_TOKEN" });

Pour les tâches qui restent connectées, ajoutez un nom de session afin que chaque page s'ouvre depuis la même IP.

Sans partie session, chaque requête reçoit une nouvelle IP. Cela convient aux requêtes indépendantes comme le suivi du positionnement ou la collecte de prix.

Les connexions, les paniers et les parcours en plusieurs étapes peuvent échouer quand l'IP change. Ajoutez session-name pour garder la même IP jusqu'à 120 minutes.

• Donnez à chaque tâche son propre nom de session (par exemple cart1, cart2).
• Pour changer d'IP, changez simplement le nom de session.
• Si vous avez besoin de la même IP pendant un mois entier, les proxies ISP statiques sont plus adaptés.

• 407 Proxy Authentication Required : le format du nom d'utilisateur ou le jeton est incorrect. Vérifiez qu'il commence par user, que les parties sont séparées par - et que le jeton ne contient pas d'espaces superflus.
• Connexion refusée ou délai dépassé : revérifiez l'hôte gate.proxymay.com et le port 7000, et assurez-vous qu'aucun pare-feu ne bloque les connexions sortantes vers ce port. Vérifiez aussi qu'il vous reste du solde.
• Mauvais pays affiché : vérifiez que le code pays comporte deux lettres et que la ville est en minuscules avec _. Lancez d'abord le test curl, puis recherchez un cache ou un autre réglage proxy dans votre code.
• Session changée après 120 minutes : c'est normal, car une session fixe dure au maximum 120 minutes. Découpez le travail pour tenir dans cette fenêtre ou recommencez avec un nouveau nom de session.

D'autres réponses sont réunies dans la FAQ.

Utilisez ProxyMay pour la collecte de données publiques, la vérification publicitaire, le suivi du positionnement SEO, la veille tarifaire, les tests de sites web et de localisation, et la gestion de vos propres comptes. L'accès non autorisé aux comptes d'autrui, le spam, la fraude, les attaques, les contenus illégaux et tout ce qui enfreint la loi ou les droits d'un site cible sont interdits.

Espacer vos requêtes et respecter les règles de chaque site permet aussi à vos tâches de fonctionner sans accroc. Les règles complètes figurent dans les conditions d'utilisation.