Inicio rápido

Inicio rápido

Esta guía te lleva de cero a una petición de proxy funcional en menos de 2 minutos.

Requisitos previos

• Una cuenta de HydraSkill (regístrate gratis)
• Una API key (desde Dashboard → API Keys)
• Python 3.8+ (o Node.js 18+)

Paso 1: Instalar

pip install hydraskill

Paso 2: Inicializar

from hydraskill import ProxyClient

client = ProxyClient(api_key="sk-your-key-here")

O establece la variable de entorno y omite el parámetro:

export HYDRASKILL_API_KEY="sk-your-key-here"

client = ProxyClient()  # se lee automáticamente del entorno

Paso 3: Obtener un proxy

proxy = client.get_proxy(
    target="amazon.com",
    session_lock=True,
    country="US"
)

print(proxy.ip)       # 203.0.113.42
print(proxy.country)  # US
print(proxy.type)     # residential

Paso 4: Usarlo

import requests

response = requests.get(
    "https://www.amazon.com/dp/B09V3KXJPB",
    proxies=proxy.to_dict()
)

print(response.status_code)  # 200

Qué ocurre tras bambalinas

1. HydraSkill analiza el dominio de destino (amazon.com)
2. Selecciona el tipo de IP óptimo (residential para e-commerce)
3. Asigna una IP del pool de US
4. Bloquea esa IP a tu sesión (no cambiará hasta que la liberes)
5. Si la IP es bloqueada → cambia automáticamente a una nueva y reintenta de forma transparente

Ejemplo completo: agente de web scraping

from hydraskill import ProxyClient
import requests

client = ProxyClient()

# Hacer scraping de 100 páginas de productos con la misma IP
proxy = client.get_proxy(target="amazon.com", session_lock=True)

for product_id in product_ids:
    url = f"https://www.amazon.com/dp/{product_id}"
    resp = requests.get(url, proxies=proxy.to_dict())

    if resp.status_code == 200:
        parse_product(resp.text)
    # No hace falta gestionar 403/429 — HydraSkill se autorrepara

# Listo — liberar el proxy
proxy.release()

Ejemplo en Node.js

import { ProxyClient } from 'hydraskill';

const client = new ProxyClient({ apiKey: process.env.HYDRASKILL_API_KEY });

const proxy = await client.getProxy({
  target: 'amazon.com',
  sessionLock: true,
  country: 'US',
});

const response = await fetch('https://www.amazon.com/dp/B09V3KXJPB', {
  agent: proxy.toAgent(),
});

console.log(response.status); // 200
await proxy.release();

Próximos pasos

• Session Lock — entiende la vinculación de IP
• Auto-Heal — cómo funciona la conmutación
• Referencia de la API — documentación completa de los endpoints