Proxy residencial: guia de configuração e como conectar

Crie uma conta na página de cadastro e você recebe um token de acesso no formato pm_XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX. O mesmo token faz login no site e funciona como senha do proxy.

O servidor guarda só um hash do token e seus 4 últimos caracteres. Guarde-o em um gerenciador de senhas ou outro lugar seguro antes de sair da página.

Um token perdido não pode ser recuperado. No código, leia-o de uma variável de ambiente para que ele nunca vá parar em um repositório.

Você pode criar até 3 contas por endereço IP, e o login permite 10 tentativas a cada 10 minutos.

Os proxies consomem o seu saldo, então recarregue primeiro. Um só saldo cobre Proxies residenciais rotativos, Proxies ISP estáticos, Proxies de datacenter e Proxies móveis.

O tráfego residencial rotativo começa em $0.80/GB e o tráfego móvel em $4.00/GB, cobrados pelo que você usa. Por exemplo, $100 gastos em residencial rotativo compram $100 divididos por $0.80/GB em tráfego. Veja os valores de recarga e os bônus na página de preços.

O usuário começa com user e acrescenta partes opcionais unidas por -. A senha é sempre o seu token de acesso. Sem nenhuma parte acrescentada, você recebe um IP residencial rotativo sem país definido.

Escrever as partes na ordem tipo, país, cidade, sessão deixa tudo legível. user-country-jp-city-tokyo-session-shop1 significa um IP de Tóquio mantido sob o nome de sessão shop1.

Os proxies móveis segmentam só por país, então deixe a cidade de fora ao usar type-mobile. Os códigos de país e as listas de cidades estão na página de locais.

HTTP e SOCKS5 usam o mesmo host gate.proxymay.com e a mesma porta 7000. Escolha qual destes três formatos sua ferramenta aceita.

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

O painel monta os mesmos textos para você copiar. As duas primeiras linhas são formatos de URL; a última é para ferramentas que esperam host:port:user:password.

Antes de escrever código, teste em um terminal. Isso localiza problemas rapidamente. Confira se ip, country e city na resposta batem com o seu usuário.

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

Com socks5h, as consultas de DNS também passam pelo proxy.

No requests, coloque a mesma URL em http e https no dicionário proxies. Este exemplo mantém um IP japonês sob a sessão 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())

Para SOCKS5, rode pip install requests[socks] e troque o esquema para socks5h://.

No Scrapy, defina proxy no meta da requisição e o middleware embutido cuida da autenticação. Dê a cada requisição seu próprio nome de sessão se quiser um IP diferente por página.

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

No Node.js 18 ou mais recente, passe o ProxyAgent do undici como dispatcher do fetch. Se você usa axios, entregue a mesma URL ao pacote 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());

As ferramentas de automação de navegador recebem o servidor e as credenciais separadamente. Coloque as partes de segmentação no usuário e o token na senha.

// 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" });

Em trabalhos que ficam logados, acrescente um nome de sessão para que todas as páginas abram do mesmo IP.

Sem a parte de sessão, cada requisição recebe um IP novo. Isso serve para requisições independentes, como verificação de posições ou coleta de preços.

Logins, carrinhos e fluxos de várias etapas podem quebrar quando o IP muda. Acrescente session-name para manter o mesmo IP por até 120 minutos.

• Dê a cada tarefa seu próprio nome de sessão (por exemplo cart1, cart2).
• Para trocar de IP, basta mudar o nome da sessão.
• Se você precisa do mesmo IP por um mês inteiro, os Proxies ISP estáticos são a melhor escolha.

• 407 Proxy Authentication Required: o formato do usuário ou o token está errado. Confira se ele começa com user, se as partes estão separadas por - e se o token não tem espaços extras.
• Conexão recusada ou tempo esgotado: confira de novo o host gate.proxymay.com e a porta 7000, e verifique se um firewall não está bloqueando conexões de saída para essa porta. Confirme também que ainda há saldo.
• País errado: confira se o código do país tem duas letras e se a cidade está em minúsculas com _. Rode primeiro a verificação com curl e depois procure cache ou outra configuração de proxy no seu código.
• A sessão mudou depois de 120 minutos: isso é esperado, porque uma sessão fixa dura até 120 minutos. Divida o trabalho para caber nessa janela ou recomece com um novo nome de sessão.

Mais respostas estão reunidas nas perguntas frequentes.

Use a ProxyMay para coleta de dados públicos, verificação de anúncios, verificação de posições no SEO, monitoramento de preços, testes de sites e de localização e gestão das suas próprias contas. São proibidos acesso não autorizado a contas de outras pessoas, spam, fraude, ataques, conteúdo ilegal e qualquer coisa que viole a lei ou os direitos de um site de destino.

Espaçar suas requisições e respeitar as regras de cada site também mantém seus trabalhos rodando sem problemas. As regras completas estão nos termos de serviço.