Integração com Puppeteer e Playwright
Um guia para programadores com exemplos de código completos para encaminhar scrapers automatizados de Puppeteer e Playwright através dos canais móveis da XProxy, incluindo o tratamento da autenticação do proxy e a rotação automática de IP.

Integração do Puppeteer (Node.js)
O Puppeteer permite-lhe passar um servidor proxy nos argumentos de arranque. Se a sua XProxy exigir autenticação, deve usar page.authenticate() antes de navegar.
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch({
headless: true,
args: [
// Route all traffic through XProxy SOCKS5 or HTTP port
'--proxy-server=socks5://192.168.6.7:5001'
]
});
const page = await browser.newPage();
// If XProxy auth is enabled, authenticate here:
await page.authenticate({
username: 'your_xproxy_username',
password: 'your_xproxy_password'
});
await page.goto('https://httpbin.org/ip');
const body = await page.evaluate(() => document.body.innerText);
console.log('Exit IP:', body);
await browser.close();
})();Integração do Playwright (Node.js)
O Playwright suporta configurações de proxy de forma nativa nas opções de arranque do navegador, incluindo os parâmetros de credenciais. Isto dispensa a necessidade de um passo separado de autenticação da página.
const { chromium } = require('playwright');
(async () => {
const browser = await chromium.launch({
proxy: {
server: 'socks5://192.168.6.7:5001',
// Optional credentials if authentication is enabled in XProxy Settings:
username: 'your_xproxy_username',
password: 'your_xproxy_password'
}
});
const context = await browser.newContext();
const page = await context.newPage();
await page.goto('https://httpbin.org/ip');
const body = await page.locator('body').innerText();
console.log('Exit IP:', body);
await browser.close();
})();Integração do Playwright (Python)
Para programadores de Python que executam automação web ou verificadores de classificação SEO:
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(
proxy={
"server": "socks5://192.168.6.7:5001",
# Optional credentials:
"username": "your_xproxy_username",
"password": "your_xproxy_password"
}
)
page = browser.new_page()
page.goto("https://httpbin.org/ip")
print("Exit IP:", page.inner_text("body"))
browser.close()Acionar a rotação de IP em scripts
Se precisar de um novo endereço IP em cada execução ou ciclo do seu script, faça um simples pedido HTTP GET à API de rotação baseada em posição da XProxy antes de navegar:
const axios = require('axios');
async function rotateIP() {
try {
const response = await axios.get('http://192.168.6.7:8081/api/v1/rotate_ip/position/1');
console.log('Rotate response:', response.data);
// Wait 5-8 seconds for 4G/5G cellular reconnection to complete
await new Promise(resolve => setTimeout(resolve, 6000));
} catch (error) {
console.error('IP rotation failed:', error.message);
}
}Why High-Quality SOCKS5 UDP & Mobile Proxies Matter for Puppeteer & Playwright
Using cheap datacenter proxies or basic HTTP proxies in antidetect profiles leads to instant account suspensions on Facebook, Google, TikTok, and Amazon. Here is why XProxy's self-hosted 4G/5G mobile proxies deliver superior anonymity and trust:
- SOCKS5 with Full UDP Support: Unlike standard HTTP proxies that drop UDP packets, XProxy SOCKS5 proxies fully support UDP datagrams. This ensures WebRTC, DNS queries, and real-time audio/video sockets route securely through your proxy without revealing your real IP address.
- Instant REST API IP Rotation: Trigger cellular IP rotation on demand via simple HTTP GET requests (e.g.
http://192.168.6.7:8081/api/v1/rotate_ip/position/1). Reconnect 4G/5G USB modems in 3 to 8 seconds with zero proxy dropouts. - 100% WebRTC & DNS Leak Protection: Combined with XProxy's local LAN gateway and TCP OS Spoofing, your browser profiles maintain pristine anonymity scores on BrowserLeaks, Whoer, Pixelscan, and IPhey.
- Carrier-Grade NAT (CGNAT) Trust: Mobile carrier IPs are shared by thousands of active smartphone users. Major platforms never ban mobile IP ranges, granting your accounts maximum trust.
