Resposta rápida
Para usar os proxies residenciais da SocksNode com o Puppeteer, inicie o Chromium com a flag --proxy-server apontando para global.socksnode.com:9000 e chame page.authenticate() com o nome de usuário e a senha gerados por você. Acrescente tokens como -country-us ao nome de usuário para segmentação geográfica e troque para a porta 10000 com um token de sessão quando precisar do mesmo IP em várias páginas.
Antes de começar
A SocksNode oferece proxies residenciais em mais de 195 países, acessíveis via HTTP, HTTPS e SOCKS5 com autenticação por nome de usuário e senha. Gere um nome de usuário e uma senha no gerador de proxy do painel; criar credenciais é grátis e apenas o tráfego consome sua largura de banda pré-paga (a partir de 5 GB por US$ 4,50, sem validade nos planos flexíveis).
Como o Chromium envia as credenciais do proxy separadamente, o Puppeteer as fornece por meio de page.authenticate(), em vez de embuti-las na URL.
Configure o proxy no Puppeteer
Aponte o navegador para o host de gateway e autentique na primeira página. Exemplo:
O token de nome de usuário USERNAME-country-us solicita um IP residencial rotativo dos EUA. Troque us por qualquer código de país ISO compatível, ou complemente com tokens de estado, cidade ou ASN para uma segmentação mais precisa.
import puppeteer from 'puppeteer';
const browser = await puppeteer.launch({
args: ['--proxy-server=http://global.socksnode.com:9000'],
});
const page = await browser.newPage();
await page.authenticate({
username: 'USERNAME-country-us',
password: 'PASSWORD',
});
await page.goto('https://api.ipify.org');Sessões rotativas versus sessões persistentes
As sessões rotativas atribuem um novo IP residencial a cada requisição e usam a porta HTTP 9000. Elas são ideais para raspagem ampla e paralela, em que cada página pode sair por um ponto de saída diferente.
As sessões persistentes mantêm o mesmo IP de 1 minuto até 24 horas e usam a porta HTTP 10000. Adicione um token de sessão e duração, por exemplo USERNAME-country-us-session-abc123-lifetime-30, para manter um IP por 30 minutos em um fluxo de login ou em uma jornada com várias etapas. Observe que o Chromium não autentica SOCKS5, então use as portas HTTP com o Puppeteer.
Segmente países, estados e cidades
A segmentação é controlada inteiramente por tokens no nome de usuário: country para qualquer um dos mais de 195 países, além de state e city dentro dos EUA, ou ASN/ISP dentro de um país. Só o nome de usuário muda, então você pode criar vários perfis geográficos a partir de um único conjunto de credenciais.
Sempre faça raspagem de forma legal, respeite os termos de serviço de cada site e mantenha-se dentro da legislação aplicável e dos limites de taxa.
Veja também
Perguntas frequentes
Qual porta devo usar com o Puppeteer?
Use a porta HTTP 9000 para IPs rotativos ou 10000 para IPs persistentes. O Chromium não oferece suporte a SOCKS5 autenticado, então evite as portas 11000 e 12000 com o Puppeteer.
Como mantenho o mesmo IP em várias páginas?
Use a porta 10000 e adicione um token de sessão ao nome de usuário, como USERNAME-country-us-session-abc123-lifetime-30, para manter um proxy residencial por até 24 horas.
Por que estou recebendo erros HTTP 407?
Um 407 significa que a autenticação do proxy falhou. Confirme se você chamou page.authenticate() com o token exato de nome de usuário e a senha do /dashboard/generator, antes de navegar.
Posso segmentar uma cidade específica dos EUA?
Sim. A SocksNode oferece segmentação nos EUA até o nível de estado e cidade por meio de tokens adicionais no nome de usuário, para que você possa solicitar saídas residenciais em uma cidade escolhida.
Gerar credenciais extras consome largura de banda?
Não. Gerar credenciais é grátis; apenas o tráfego roteado pelo proxy consome sua largura de banda pré-paga.


