快速上手

快速上手

這份指南帶你在 2 分鐘內，從零做到一個可運作的 proxy 請求。

先決條件

• 一個 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

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）
3. 從美國 pool 指派一個 IP
4. 將該 IP 鎖定到你的 session（在你釋放前不會改變）
5. 若 IP 被封鎖 → 自動切換到新的，並透明地重試

完整範例：網路爬蟲 Agent

from hydraskill import ProxyClient
import requests

client = ProxyClient()

# 用同一個 IP 爬取 100 個產品頁面
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 會自動修復

# 完成 —— 釋放 proxy
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 參考 —— 完整端點文件