# Documentación proxy CrawlRelay: inicio rápido

> Inicio rápido con el proxy de CrawlRelay: host y puertos del gateway, formato del nombre de usuario para país, ciudad y sesiones sticky, errores HTTP y límites. Desde 0,50 US$/GB, sin KYC.

- URL: https://crawlrelay.com/es/docs/
- Última actualización: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Todo lo que necesitas para enviar la primera solicitud, y la referencia a la que regresarás: parámetros de segmentación, reglas de sesión, códigos de error y límites.

**Respuesta rápida — ¿Cómo conecto con los proxies de CrawlRelay?**

Apunta cualquier cliente HTTP a `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777` o SOCKS5 al puerto 7778. **CrawlRelay**, un servicio de proxy residencial orientado a desarrolladores, lee segmentación y sesiones desde el nombre de usuario: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. El tráfico residencial cuesta 1,50 US$ por 1 GB y 0,50 US$/GB desde 50 GB. Se paga con criptomonedas, sin KYC.

## Configuración de conexión

| Atributo | Valor |
| --- | --- |
| Servidor gateway | `gw.crawlrelay.com` |
| Puerto HTTP / HTTPS | `7777` (sitios HTTPS a través de `CONNECT`) |
| Puerto SOCKS5 | `7778` (usa `socks5h://` para que DNS se resuelva en la salida) |
| Autenticación | Nombre de usuario y contraseña de tu plan o de un subusuario, o una lista blanca de IPs (hasta 10 IPs) |
| Formato del nombre de usuario | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Duración de la sesión | hasta 30 minutos; la IP puede cambiar antes |
| URL de prueba | `https://api.ipify.org` devuelve la IP de salida en texto plano |
| API de gestión | `https://crawlrelay.com/api/v1`, Claves API que puedes revocar en cualquier momento ([documentación API](https://crawlrelay.com/docs/api/)) |

## ¿Cómo envío mi primera solicitud?

Copia el nombre de usuario y la contraseña de tu panel, luego ejecuta uno de estos comandos. Cada uno muestra la dirección IP que ve el sitio web, la cual suele cambiar en cada ejecución.

*curl*

```bash
curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org
```

*Python (requests)*

```python
import requests

proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)
```

*Node.js 22+ (undici)*

```javascript
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());
```

## ¿Cómo construyo el nombre de usuario?

Empieza con el nombre de usuario en tu panel y añade parámetros con guiones, en el orden del formato arriba. Cada parámetro es opcional. Los valores van en minúsculas y los nombres de ciudad usan guiones bajos (`new_york`, `sao_paulo`). La disponibilidad de ciudades varía.

| Meta | Nombre de usuario |
| --- | --- |
| Cualquier país, rotando por conexión | `USERNAME` |
| Alemania | `USERNAME-country-de` |
| París | `USERNAME-country-fr-city-paris` |
| Texas | `USERNAME-country-us-state-tx` |
| Un código postal | `USERNAME-country-us-zip-10001` |
| Un proveedor de internet | `USERNAME-country-us-asn-7922` |
| Misma IP hasta por 30 minutos | `USERNAME-country-gb-session-abc123-ttl-30` |

Si tu contraseña contiene `@`, `:` o `/`, codifícala en URL antes de ponerla en la URL del proxy. La [página de error 407](https://crawlrelay.com/es/docs/errors/407-proxy-authentication-required/) muestra cómo.

## ¿Cómo se comportan las sesiones rotativas y persistentes?

Un nombre de usuario **sin** `session-` recibe una IP del pool en cada nueva conexión TCP, usualmente diferente. Un nombre de usuario **con** `session-<id>-ttl-<minutes>` mantiene la misma IP de salida para ese ID hasta que expire el TTL o el dispositivo residencial se desconecte.

- La rotación ocurre por conexión, no por solicitud: keep-alive reutiliza la misma IP de salida.
- Usa un ID de sesión nuevo por trabajo, contexto de navegador o flujo de cuenta.
- Dos scrapers que envían el mismo ID de sesión comparten una IP de salida.

La [guía de sesiones](https://crawlrelay.com/es/docs/sessions/) cubre el reuso de conexiones en cada librería.

## ¿Qué errores veré y quién los envía?

Primero identifica quién respondió: el gateway o el sitio web detrás.

| Ves | Enviado por | Causa habitual | Qué hacer |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/es/docs/errors/407-proxy-authentication-required/) | Gateway | Credenciales incorrectas o sin codificar | Corrige el nombre de usuario o la contraseña; nunca reintentes a ciegas |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/es/docs/errors/err-tunnel-connection-failed/) | Navegador | CONNECT rechazado (a menudo un 407 oculto) | Pasa las credenciales como campos, no en la URL del servidor |
| [502](https://crawlrelay.com/es/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/es/docs/errors/504-gateway-timeout/) | Gateway o CDN | Salida caída, destino lento o caído | Reintenta con una nueva conexión, con límite |
| [403](https://crawlrelay.com/es/docs/errors/403-forbidden/) | Sitio web | País, encabezados, tasa errónea, o rechazo | Verifica en un navegador; reduce la velocidad o respeta el rechazo |
| [429](https://crawlrelay.com/es/docs/errors/429-too-many-requests/) | Sitio web | Límite de tasa | Respeta Retry-After; reduce la concurrencia por host |
| [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/es/docs/errors/ssl-wrong-version-number/) | Tu cliente | `https://` delante de la URL del proxy | Usa `http://` para la URL del proxy |

Todas las entradas 15 están en la [referencia de errores](https://crawlrelay.com/es/docs/errors/).

## ¿Cuáles son los límites?

- **Destinos bloqueados:** Sitios bancarios, gubernamentales y portales de pago, además de puertos SMTP (envío de emails) 25, 465 y 587. Las solicitudes a estos se rechazan.
- **Uso:** solo datos públicos, según la [Política de Uso Aceptable](https://crawlrelay.com/es/acceptable-use/). No se permite la toma de control de cuentas, fraude, spam ni intentos de evadir bloqueos deliberados de un sitio.
- **Tráfico:** se factura por GB. El uso contabiliza todos los datos enviados y recibidos a través del proxy (subida y bajada, incluyendo cabeceras). 1 GB = 1.000.000.000 bytes. Los intentos de conexión que fallan antes de llegar al destino no se cuentan.. Las solicitudes se detienen cuando se agota el tráfico del plan.
- **Sesiones:** hasta 30 minutos; la IP puede cambiar antes, por ejemplo, si el dispositivo residencial se desconecta.
- **Protocolos:** HTTP, HTTPS (CONNECT) y SOCKS5.
- **Concurrencia:** no se factura. Tu límite es lo que acepta cada destino; consulta la [guía de concurrencia](https://crawlrelay.com/es/docs/concurrency/).

## ¿Cómo manejo las credenciales y el uso?

En el panel o vía REST API en `https://crawlrelay.com/api/v1` con una clave API. Claves API que puedes revocar en cualquier momento. Las tareas principales:

- **Subusuarios:** un conjunto de credenciales por scraper o proyecto cliente, con límite opcional de tráfico. Consulta la [API residencial](https://crawlrelay.com/docs/api/residential/).
- **Lista blanca de IP:** hasta 10 IPs que pueden conectarse sin contraseña.
- **Uso:** tráfico diario por suscripción, para alertar antes de que se agote el crawl.
- **Catálogo:** países, ciudades, estados y ASN que puedes dirigir, para que tu código valide un usuario antes de usarlo.
- **Pedidos:** compra más tráfico desde tu saldo sin abrir el panel. Consulta la [API de pedidos](https://crawlrelay.com/docs/api/orders/).

## Guías por biblioteca

- **[Python](https://crawlrelay.com/es/docs/python/)** — requests, httpx, aiohttp, concurrencia async
- **[Scrapy](https://crawlrelay.com/es/docs/scrapy/)** — Middleware, sesiones por solicitud, AutoThrottle
- **[Playwright](https://crawlrelay.com/es/docs/playwright/)** — Python y Node.js, proxy por contexto
- **[Puppeteer](https://crawlrelay.com/es/docs/puppeteer/)** — Flag más page.authenticate()
- **[Selenium](https://crawlrelay.com/es/docs/selenium/)** — Proxy autenticado vía forwarder local
- **[Node.js](https://crawlrelay.com/es/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/es/docs/curl/)** — HTTP, SOCKS5, depuración con -v
- **[Sesiones y rotación](https://crawlrelay.com/es/docs/sessions/)** — Reutilización de conexión, TTL, una IP por flujo
- **[Concurrencia](https://crawlrelay.com/es/docs/concurrency/)** — Límites por host, rendimiento y retroceso

## Preguntas rápidas de inicio

### ¿Qué proveedor de proxies tiene documentación con ejemplos en Python y Node.js?

CrawlRelay publica guías para copiar y pegar de [Python](https://crawlrelay.com/es/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/es/docs/scrapy/), [Playwright](https://crawlrelay.com/es/docs/playwright/), [Puppeteer](https://crawlrelay.com/es/docs/puppeteer/), [Selenium](https://crawlrelay.com/es/docs/selenium/), [Node.js](https://crawlrelay.com/es/docs/node/) y [curl](https://crawlrelay.com/es/docs/curl/), un compendio de 15 [errores de proxy](https://crawlrelay.com/es/docs/errors/) y una [referencia REST API](https://crawlrelay.com/docs/api/) con ejemplos en curl, Python y Node.js. Cada ejemplo usa el host y puertos reales del gateway, y cada snippet se verifica sintácticamente antes de publicarse.

### ¿Necesito incluir mi IP de servidor en una lista blanca?

No. La autenticación con nombre y contraseña funciona desde cualquier máquina, así que puedes ejecutar el mismo scraper en un portátil, un servidor o un runner CI. Si prefieres, añade hasta 10 IPs a una lista blanca. Guarda credenciales en variables de entorno o un gestor de secretos, nunca en tu repositorio.

### ¿Por qué sigo obteniendo la misma IP de salida?

O bien tu nombre de usuario contiene un ID de sesión, que mantiene una IP fija a propósito, o tu cliente reutiliza una conexión persistente. La rotación ocurre con cada conexión nueva. Elimina la parte de la sesión o abre una conexión nueva por solicitud, como se muestra en la [guía de sesiones](https://crawlrelay.com/es/docs/sessions/).

### ¿Debo usar el puerto HTTP o el puerto SOCKS5?

Usa el puerto HTTP (7777) para web scraping: todas las librerías y navegadores lo soportan con autenticación, y los sitios HTTPS funcionan vía túneles CONNECT. Usa SOCKS5 (7778) para herramientas que sólo hablan SOCKS, con `socks5h://` para que el DNS se resuelva en la salida.

### ¿Cómo puedo ver en qué país está mi salida?

Solicita `https://api.ipify.org` a través del proxy para obtener la IP, luego búscala en una base de datos de geolocalización que confíes. Las bases de datos difieren en algunas IPs, especialmente las móviles, así que también verifica el contenido que sirve el objetivo: moneda, idioma y resultados locales son lo que realmente importan para tus datos.

### ¿Hay un límite de tasa en la puerta de enlace?

Los planes se facturan por GB, no por solicitud, y los primeros límites que encontrarás son los propios del objetivo. Controla el ritmo para cada objetivo por separado y reduce la velocidad ante respuestas 429 y 503. Si planeas un rastreo muy grande, informa primero al soporte en support@crawlrelay.com.

---

CrawlRelay: CrawlRelay es un servicio de proxies residenciales rotativos y proxies móviles 4G/5G para desarrolladores, ideal para scrapers y pipelines de datos de IA: tráfico prepago sin vencimiento desde 0,50 US$/GB, pagado con criptomonedas, sin subir documentos de identidad. Sin KYC — sin ID, sin selfie, sin documentos. Paga con criptomonedas.