Быстрый старт

Быстрый старт

Это руководство проведёт вас от нуля до рабочего запроса через прокси менее чем за 2 минуты.

Предварительные требования

• Аккаунт HydraSkill (зарегистрируйтесь бесплатно)
• API key (из Dashboard → API Keys)
• Python 3.8+ (или Node.js 18+)

Шаг 1. Установка

pip install hydraskill

Шаг 2. Инициализация

from hydraskill import ProxyClient

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

Или задайте переменную окружения и пропустите параметр:

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

client = ProxyClient()  # автоматически читает из окружения

Шаг 3. Получите прокси

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

Шаг 4. Используйте его

import requests

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

print(response.status_code)  # 200

Что происходит за кулисами

1. HydraSkill анализирует целевой домен (amazon.com)
2. Выбирает оптимальный тип IP (residential для e-commerce)
3. Назначает IP из пула США
4. Привязывает этот IP к вашей сессии (он не изменится, пока вы его не освободите)
5. Если IP блокируется → автоматически переключается на новый, прозрачно повторяет запрос

Полный пример: агент для веб-скрапинга

from hydraskill import ProxyClient
import requests

client = ProxyClient()

# Скрапим 100 страниц товаров с одним и тем же 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)
    # Не нужно обрабатывать 403/429 — HydraSkill выполняет auto-heal

# Готово — освобождаем прокси
proxy.release()

Пример на 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();

Следующие шаги

• Session Lock — разберитесь в привязке IP
• Auto-Heal — как работает переключение
• Справочник по API — полная документация по эндпоинтам