proxytoo

Cómo configurar un proxy: del nombre de usuario al scraper

Cuando sabes qué hace cada parte del nombre de usuario, configurar un proxy en cualquier herramienta lleva pocos minutos. Esta página explica la configuración herramienta por herramienta, cómo resolver errores y cómo mantener tu token a salvo.

Obtener token y empezar

1. Crea una cuenta y guarda tu token de acceso

En la página de registro recibes un token de acceso. Es tu contraseña para iniciar sesión y para conectarte al proxy. El servidor no lo guarda, así que guárdalo en un archivo .txt.

Empezar

2. Recarga saldo

Elige un importe en el apartado de recarga del panel y envía la solicitud. Puedes recargar desde $30, y se suma al saldo cuando se confirma el pago.

Ver precios

3. Crea el nombre de usuario

Pon país, ciudad y sesión en el usuario para fijar la ubicación y cuánto se mantiene la IP. Si los eliges en crear datos de conexión del panel, se genera solo.

Ejemplos de usuario

IP nueva por petición
user-country-us
Elegir ciudad
user-country-us-city-new_york
Mantener la misma IP
user-country-us-session-shop1
IP móvil
user-type-mobile-country-us

4. Prueba la conexión

Envía una petición con curl y mira la IP y el país en la respuesta.

Formato de conexión

HTTP

http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000

SOCKS5

socks5://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000

curl

curl -x http://gate.proxytoo.com:7000 -U "user-country-us:YOUR_TOKEN" https://ipinfo.io/json

5. Añádelo a tus herramientas

Introduce host, usuario y token en Python, Node.js o tu herramienta de automatización del navegador.

Ejemplos de código

Python (requests)

import requests

proxy = "http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000"
res = requests.get("https://ipinfo.io/json",
                   proxies={"http": proxy, "https": proxy})
print(res.json())

Node.js (undici)

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://user-country-us:YOUR_TOKEN@gate.proxytoo.com:7000");
const res = await fetch("https://ipinfo.io/json", { dispatcher: agent });
console.log(await res.json());

Puppeteer

const browser = await puppeteer.launch({
  args: ["--proxy-server=http://gate.proxytoo.com:7000"],
});
const page = await browser.newPage();
await page.authenticate({ username: "user-country-us", password: "YOUR_TOKEN" });
await page.goto("https://ipinfo.io/json");

Si falla la conexión

  • 407 Proxy Authentication Required

    El usuario o el token no coinciden. Comprueba que los pegaste tal cual, sin espacios de más.

  • Tiempo de conexión agotado

    Si elegiste ciudad, prueba solo con el país. Comprueba también si el cortafuegos de tu empresa bloquea el puerto 7000.

  • Un sitio te sigue bloqueando

    Espacia más las peticiones y cambia la IP en cada una. Para sitios con bloqueo fuerte, lo adecuado son los proxies residenciales.

¿Cómo se lee un nombre de usuario de proxy?

Un nombre de usuario de proxy es una cadena corta de ajustes formada por partes unidas con guiones. Empieza por user y luego añade pares de nombre y valor que fijan la ubicación de salida y cuánto tiempo se mantiene la IP. Cuando conoces las partes, puedes escribir cualquier cadena de conexión a mano sin abrir el panel.

Después de country va un código de país de dos letras en minúsculas. user-country-us significa una IP de Estados Unidos y user-country-jp una IP de Japón. Después de city va el nombre de la ciudad en minúsculas, con los espacios convertidos en guiones bajos, como en user-country-us-city-new_york.

Después de session va un nombre de sesión que eliges tú. Con user-country-jp-session-shop1, todas las peticiones que usan ese nombre mantienen la misma IP durante un máximo de 120 minutos. Añade type-mobile, como en user-type-mobile-country-gb, para salir por una IP móvil.

El campo de contraseña siempre lleva tu token de acceso, que empieza por pt_. Para cambiar de ubicación o de sesión, edita solo el nombre de usuario y deja el token como está.

  • user marca el inicio de los ajustes.
  • country más un código de dos letras elige el país.
  • city más un nombre con guiones bajos elige la ciudad.
  • session más un nombre mantiene la misma IP.
  • type-mobile elige una IP móvil.

Proxy HTTP o SOCKS5: ¿cuál debo usar?

Los proxies HTTP son la opción sencilla por defecto para web scraping y trabajo con navegadores, mientras que los proxies SOCKS5 encajan con tráfico que no es web o con configuraciones en las que quieres resolver el DNS en el lado del proxy. ProxyToo acepta ambos en una sola pasarela, gate.proxytoo.com:7000. Mantén el mismo nombre de usuario y el mismo token y cambia solo el esquema al principio de la dirección.

Los proxies HTTP se crearon para peticiones web, así que casi todas las bibliotecas y navegadores los entienden sin configuración extra. Los sitios HTTPS también funcionan, porque el proxy abre un túnel cifrado para la conexión. Para herramientas web como requests, Scrapy, Puppeteer y Playwright, empieza con el formato HTTP.

SOCKS5 retransmite la propia conexión, así que puede llevar muchos tipos de tráfico además del web. En Python, empezar la dirección con socks5h hace que el proxy resuelva los nombres de host en el país de salida, lo que mantiene tu ubicación coherente. Los navegadores basados en Chromium tienen un soporte limitado para SOCKS5 con nombre de usuario, así que HTTP es la opción más cómoda para la automatización de navegadores.

  • HTTP para web scraping y automatización de navegadores
  • SOCKS5 para programas que envían tráfico que no es web
  • Una dirección socks5h para resolver el DNS en el país del proxy
  • El mismo nombre de usuario y el mismo token para ambos

¿Cómo añado un proxy a un navegador o a un navegador antidetección?

En un navegador normal, abre una extensión de proxy e introduce cuatro datos en campos separados: host, puerto, nombre de usuario y token. Elige el formato host:port:user:pass en Crear datos de conexión dentro del panel y los cuatro datos aparecen en una sola línea, listos para copiarlos campo a campo. Si al cargar la primera página aparece una ventana de autenticación, escribe ahí el nombre de usuario y el token.

Un navegador antidetección da a cada perfil su propio entorno de navegación, así que la regla básica es un nombre de usuario por perfil. En el campo de proxy del perfil elige HTTP o SOCKS5 y añade una parte de sesión al nombre de usuario, con un nombre de sesión distinto para cada perfil. Así cada perfil obtiene su propia IP, y la IP se mantiene dentro de ese perfil.

Ajusta el idioma, la zona horaria y la ubicación del perfil al país elegido para que las páginas se vean como las ve un visitante local. Para un perfil que gestiona una cuenta durante mucho tiempo, los proxies ISP o los proxies de centro de datos dedicados mantienen la misma IP durante todo el periodo. Pide cualquiera de ellos en Comprar productos dentro del panel eligiendo cantidad y periodo.

  • Un nombre de sesión por perfil
  • Idioma y zona horaria ajustados al país de la IP
  • Proxies ISP para perfiles de larga duración
  • Nombre de usuario y token en la ventana de autenticación

¿Cómo uso un proxy con Python requests y Scrapy?

En Python, monta el proxy como una sola línea con la forma http://username:token@gate.proxytoo.com:7000 y pásala al ajuste de proxy de la biblioteca. Con requests, el paso clave es poner la misma dirección en las entradas http y https. Al rellenar las dos, las peticiones HTTPS también pasan por el proxy.

Configura el proxy una vez en un objeto Session de requests y todas las peticiones de esa sesión lo usarán. Usa un nombre de usuario solo con país cuando quieras una IP nueva por petición, y uno con parte de sesión para flujos que continúan, como un inicio de sesión. Para SOCKS5, instala el extra SOCKS de requests y cambia el principio de la dirección a socks5h.

En Scrapy, pon una dirección del mismo estilo en el valor meta proxy de cada petición, y el middleware de proxy integrado convierte el nombre de usuario y el token en la cabecera de autenticación por ti. Para aplicar un mismo ajuste a todas las peticiones, escribe un pequeño downloader middleware que rellene el valor del proxy. Para repartir el tráfico en sesiones, haz que ese middleware asigne un nombre de sesión distinto a cada lote de peticiones.

Ajusta la concurrencia y el ritmo con opciones como CONCURRENT_REQUESTS y DOWNLOAD_DELAY. Empieza con valores bajos, comprueba que las respuestas son estables y súbelos poco a poco para equilibrar velocidad y éxito. Los proxies residenciales se cobran por tráfico usado, así que filtrar imágenes y fuentes hace que tu saldo dure más.

¿Cómo configuro un proxy en Node.js, Puppeteer y Playwright?

En Node.js lo habitual es crear un agente de proxy y pasárselo a tu biblioteca de peticiones. Para HTTP usa un paquete como https-proxy-agent o el ProxyAgent de undici, y para SOCKS5 usa socks-proxy-agent, pasando una dirección que incluya el nombre de usuario y el token. Crea el agente una vez y reutilízalo en todas las peticiones para que las conexiones se reaprovechen y todo siga siendo rápido.

Con Puppeteer, pasa solo la dirección de la pasarela en el argumento de inicio --proxy-server y envía después el nombre de usuario y el token por separado con page.authenticate tras abrir una página. Separarlos así es la configuración más fiable en Chrome. Para cambiar de país o de sesión, lo más sencillo es abrir otro navegador con el nuevo nombre de usuario.

Con Playwright, indica server, username y password en la opción proxy al iniciar y la autenticación se resuelve en un solo paso. El campo password lleva tu token de acceso. También puedes abrir un solo navegador y dar a cada contexto su propio proxy, así que asignar un nombre de sesión a cada contexto permite que un único script use varias IP en paralelo.

La automatización de navegadores descarga imágenes, vídeo y fuentes en cada página, lo que suma mucho tráfico. Bloquear los recursos innecesarios con la intercepción de peticiones reduce el coste de los proxies residenciales y móviles, que se cobran por GB. Añadir un nombre de sesión mantiene la IP estable mientras carga una página, así que las páginas se muestran correctamente.

Proxies rotativos o sesiones fijas: ¿qué es mejor para scraping?

Para scraping en el que cada página se lee por separado, usa una IP nueva por petición, y para flujos que continúan, como un inicio de sesión o un carrito, usa una sesión. Sin parte de sesión, la IP cambia en cada petición, y con ella la IP se mantiene bajo ese nombre. Un mismo token sirve para ambos casos, así que puedes elegir en cada paso del trabajo.

El modo rotativo va bien con trabajos en los que las páginas no tienen relación entre sí, como resultados de búsqueda, listas de productos y tablas de precios. Las peticiones se reparten de forma uniforme entre muchas IP, así que para el sitio parecen tráfico normal de muchos visitantes. Incluso en rastreos grandes de un mismo sitio, espaciar las peticiones mantiene la estabilidad.

Con sesiones, el truco es usar un nombre de sesión distinto para cada unidad de trabajo. Si revisas cinco cuentas de tienda, llámalas de shop1 a shop5 para que cada cuenta conserve su propia IP. Dividir el trabajo en flujos cortos que terminen dentro de la ventana de la sesión mantiene una misma IP durante todo el flujo.

Si necesitas la misma IP durante un mes entero, lo mejor son los proxies ISP o los proxies de centro de datos dedicados, y para grandes volúmenes a bajo precio por unidad, los proxies de centro de datos compartidos o los proxies IPv6 son buenas opciones. Para trabajos de mucho tráfico en los que da igual mezclar países, los proxies residenciales ilimitados a $37.58 por día hacen que los costes sean fáciles de planificar.

  • IP nueva por petición para páginas independientes
  • Un nombre de sesión fijo para flujos de inicio de sesión y pago
  • Un nombre de sesión distinto por unidad de trabajo
  • ISP o centro de datos dedicado para una misma IP todo el mes

¿Cómo compruebo la IP de mi proxy y soluciono errores de conexión?

La comprobación más rápida es enviar una petición a través del proxy a una página que muestre tu IP y confirmar que la IP y el país coinciden con el país de tu nombre de usuario. Elige el formato curl en Crear datos de conexión dentro del panel y obtendrás un comando de comprobación listo para pegar en una terminal. Si configuraste una sesión, envía el mismo comando dos o tres veces para confirmar que la IP se mantiene.

Una respuesta 407 significa que el proxy no aceptó tus credenciales, y casi siempre se debe a un solo carácter del nombre de usuario o del token. Comprueba que el token empieza por pt_, que no se copiaron espacios ni saltos de línea y que el nombre de usuario empieza por user. Si hay caracteres especiales dentro de la dirección de una línea, codificarlos para URL lo soluciona.

Respuestas como 403 o 429 vienen del sitio, lo que significa que la conexión con el proxy funcionó y que el sitio está vigilando la velocidad o los patrones de las peticiones. Espacia las peticiones, envía cabeceras parecidas a las de un navegador y pasa de una sesión a una IP nueva por petición.

Los tiempos de espera agotados suelen deberse a que la red de una oficina o centro educativo bloquea el puerto de la pasarela, a una segmentación por ciudad demasiado estrecha o a un tiempo de espera corto en tu código. Prueba el mismo comando desde otra red, quita la parte de ciudad para segmentar solo por país y da a la petición un tiempo de espera más largo. Comprueba también que te queda saldo y, en los productos por IP, que el pedido aparece como Activo en Mis pedidos.

  • 407: revisa el nombre de usuario y el token
  • 403 o 429: baja el ritmo y rota las IP
  • Tiempo agotado: revisa la red, la ciudad y el tiempo de espera
  • Ejecuta el mismo comando varias veces para probar una sesión

¿Cómo mantengo a salvo mi token de acceso al proxy?

Tu token de acceso es a la vez el ID de tu cuenta y la contraseña de tus proxies, así que cualquiera que lo tenga puede usar proxies con tu saldo. El servidor solo guarda un hash del token, por lo que el archivo de token que guardaste al registrarte es el único original. Guarda copias en dos lugares y añádelo a un gestor de contraseñas para tenerlo seguro y fácil de encontrar.

No pongas el token en tu código: cárgalo desde una variable de entorno o desde un archivo de configuración aparte. Añade ese archivo de configuración a .gitignore para que quede fuera de tu repositorio y, en un servidor compartido, restringe los permisos del archivo para que solo tú puedas leerlo. Así puedes compartir tu código mientras el token se queda en tu propio equipo.

Vigila también tus registros y capturas de pantalla. Imprimir la dirección completa del proxy en un error escribe el token directamente en el registro, así que oculta la parte del token siempre que registres una dirección. Cuando publiques una pregunta o una captura, muestra solo el nombre de usuario y quita antes el token.

  • Archivo del token guardado en dos lugares
  • Token cargado desde una variable de entorno
  • Archivo de configuración fuera del repositorio
  • Token oculto en registros y capturas de pantalla

Uso responsable

  • Recopila información pública y no entres en cuentas ajenas sin permiso.
  • Espacia las peticiones para no sobrecargar los sitios que visitas.
  • No se pueden usar para spam, accesos no autorizados ni fraudes.

Páginas relacionadas

Obtén un token y conéctate con IP del país que necesitas

Registrarte solo requiere un token. Recarga desde $30 y usa todos los tipos de proxy con un único saldo.

Obtener token y empezar