TUTORIAL T-001 · PROXY · SETUP

Membuat Proxy Residential di ProxyScrape

Panduan lengkap dari nol: bikin akun, beli & create residential proxy, generate API access, bikin command buat AI agent, sampai generate bulk proxy untuk multi-account operations.

PLATFORM: proxyscrape.com TYPE: Residential STEPS: 05 LEVEL: Beginner
— PREREQUISITES

Yang lo butuhin sebelum mulai: (1) kartu kredit atau crypto buat beli paket ProxyScrape (mulai dari ~$5/GB), (2) terminal / command line yang bisa jalanin curl dan Python, (3) file ~/.env buat simpen API key. Gak perlu server, bisa langsung dari laptop lo.

— YANG LO DAPET DI AKHIR

Setelah selesai tutorial ini: (1) proxy residential aktif dengan username/password, (2) curl command yang bisa di-copy-paste langsung, (3) Python helper function buat rotating + sticky session, (4) bulk list generator buat agent atau scraper, (5) ngerti kapan residential worth-it dan kapan buang duit.

— TL;DR

Residential proxy = IP dari device rumahan asli, susah kedeteksi. Format akhir: user:pass@rp.scrapegw.com:port. Daftar → beli paket residential → ambil username/password dari dashboard → append -session-X-lifetime-Y buat sticky, -country-XX buat geo → generate bulk list buat agent.

— KAPAN JANGAN PAKE RESIDENTIAL

Residential charged per GB dan mahal (~$3-8/GB). Jangan dipake kalau: (1) target gak block datacenter IP — pake DC proxy yang jauh lebih murah/unlimited; (2) lo cuma butuh ganti region/geo — VPN/DC proxy cukup; (3) traffic volume gede (scraping HD media, video) — bandwidth abis dalam jam. Residential worth-it cuma buat target dengan deteksi ketat (sneaker, ticketing, social media, ad verification) yang block ASN datacenter. Salah pilih = bakar duit buat masalah yang sebenernya solvable pake proxy $1.

STEP 01

Buat Akun di ProxyScrape

Pertama, daftar akun di proxyscrape.com. Pilih plan Residential sesuai kebutuhan bandwidth (GB/bulan).

  1. Buka proxyscrape.com → klik Sign Up
  2. Verifikasi email, login ke dashboard
  3. Pilih Residential Proxies → pilih paket (1GB, 5GB, 10GB, dll)
  4. Bayar (Crypto / CC), tunggu confirmation
— TIPS

Mulai dari paket terkecil dulu (1GB ~ $5) buat test. Kalau workflow lo cocok baru upgrade. Bandwidth residential expensive, jangan kebanyakan beli sekaligus.

STEP 02

Create Proxy & Setup Authentication

Setelah punya paket, masuk ke Dashboard → Residential Proxies. Disini lo set authentication dan ambil endpoint gateway.

Authentication method untuk Residential:

— NOTE

IP Whitelist/IP Authentication itu cuma tersedia untuk Premium/Dedicated datacenter proxy, BUKAN residential. Kalau lo liat tutorial lain yang nyebut IP whitelist buat residential, itu salah.

Set username/password lo, lalu copy endpoint gateway dari dashboard:

# Endpoint format ProxyScrape Residential (per docs.proxyscrape.com) Gateway: rp.scrapegw.com Port: cek dashboard # Proxy Setup → port HTTP/SOCKS5 ditampilin di sana User: your_username Pass: your_password # Final proxy URL http://user:pass@rp.scrapegw.com:PORT
— PITFALL: Hostname & port

Gateway resmi adalah rp.scrapegw.com (bukan rp.proxyscrape.com). Port HTTP/SOCKS5 berbeda per akun/region — copy dari dashboard Residential → Proxy Setup, jangan hardcode angka dari tutorial random.

— PITFALL: Password leak

Jangan share password di public repo. Simpen di .env file dan add ke .gitignore. Banyak orang kena drain bandwidth gara-gara leak password di GitHub.

Test koneksi:

$ curl -x http://user:pass@rp.scrapegw.com:PORT https://api.ipify.org $ # Output: IP residential random dari pool
— EXPECTED OUTPUT 102.135.224.18
STEP 03

Create API Access

API access dipake buat fetch usage/stats programmatically dan automate management akun (subuser, password, dll). Auth-nya pake header api-token + base URL https://api.proxyscrape.com.

  1. Dashboard → Account → API Keys → klik Create API Key
  2. Beri name, pilih permissions (minimal residential:read)
  3. Copy 64-char token (cuma muncul sekali, simpan baik-baik)
  4. Catat subAccountId dari endpoint /v4/account/subaccounts atau dashboard
# ~/.env PROXYSCRAPE_API_KEY="64-character-token-shown-once" PROXYSCRAPE_SUBACCOUNT_ID="uuid-dari-dashboard" PROXYSCRAPE_USER="your_residential_username" PROXYSCRAPE_PASS="your_residential_password" PROXYSCRAPE_GATEWAY="rp.scrapegw.com:PORT"

Verify API works (header api-token, bukan Bearer):

$ source ~/.env $ curl -s -H "api-token: $PROXY...pan> \ https://api.proxyscrape.com/v4/account/$PROXY...pan>/residential/overview | jq
— EXPECTED OUTPUT { "plan": "residential", "bandwidth_used": 1240000000, "bandwidth_limit": 5000000000, "status": "active" }
— TIPS

Token 64-char itu cuma muncul sekali waktu create. Kalau hilang, lo gak bisa retrieve — mesti regenerate (revoke key lama otomatis). Permission lain yang berguna: residential:write buat reset password subuser, subaccount:read buat list subaccount.

STEP 04

Setup Command untuk AI Agent

Bikin Python helper biar agent (bot, scraper, automation) bisa pake proxy ini gampang. Pattern: load dari env, generate session ID buat sticky/rotating.

# proxy_helper.py import os, random, string from dotenv import load_dotenv load_dotenv() def get_proxy(sticky=False, lifetime=10, country=None): """Return proxy URL. sticky=True bikin IP nempel selama `lifetime` menit. country=ISO2 (mis. 'us','id') buat geo-targeting.""" user = os.getenv("PROXYSCRAPE_USER") pwd = os.getenv("PROXYSCRAPE_PASS") gw = os.getenv("PROXYSCRAPE_GATEWAY") # rp.scrapegw.com:PORT if country: user = f"{user}-country-{country}" if sticky: sid = ''.join(random.choices(string.ascii_lowercase + string.digits, k=8)) user = f"{user}-session-{sid}-lifetime-{lifetime}" return f"http://{user}:{pwd}@{gw}" # Usage import requests proxy = get_proxy(sticky=True) r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}) print(r.text)

Sticky vs Rotating (format sesuai docs resmi):

STEP 05

Generate Bulk Proxy List

Buat multi-account operations atau distribusi ke banyak tools, lo butuh list proxy dengan session unique per line.

# bulk_proxy.py — generate 100 unique sticky sessions (rp.scrapegw.com) import os, random, string from dotenv import load_dotenv load_dotenv() user = os.getenv("PROXYSCRAPE_USER") pwd = os.getenv("PROXYSCRAPE_PASS") gw = os.getenv("PROXYSCRAPE_GATEWAY") # rp.scrapegw.com:PORT LIFETIME = 10 # menit, max 120 per docs with open("proxies.txt", "w") as f: for i in range(100): sid = ''.join(random.choices(string.ascii_lowercase + string.digits, k=8)) f.write(f"http://{user}-session-{sid}-lifetime-{LIFETIME}:{pwd}@{gw}\n") print("✓ Generated 100 proxies → proxies.txt")

Format output (compatible dengan 9router, Selenium, Playwright, dll):

— proxies.txt http://user-session-a3f2k9mz-lifetime-10:pass@rp.scrapegw.com:PORT http://user-session-bx7n2pqr-lifetime-10:pass@rp.scrapegw.com:PORT http://user-session-c9k4lmth-lifetime-10:pass@rp.scrapegw.com:PORT ... (97 more)

File ini langsung bisa di-import ke 9router, multi-account farming tools, atau automation framework apapun.

— COMMON PITFALLS

Things That Break

Hal yang bikin proxy lo gak jalan, dari yang sering banget kejadian.

Bandwidth habis tanpa lo sadar

Residential proxy charged per GB. Kalau scraping HD images atau video, bandwidth abis dalam jam. Set monitoring di dashboard, jangan loop tanpa rate limit.

Sticky session expired / IP rotated unexpectedly

Sticky session di ProxyScrape bertahan selama -lifetime-X menit (max ~120). Tapi IP bisa rotate lebih cepat kalau node hosting IP itu offline. Kalau kena 401/403 mid-session, generate session ID baru — jangan retry pake yang lama.

SSL cert verification failed

Kalau pake SOCKS5, beberapa client butuh verify=False atau konfigurasi tambahan. Untuk HTTP proxy biasanya gak ada masalah. Port HTTP/SOCKS5 ada di dashboard Proxy Setup — jangan tebak.

Salah hostname / port hardcoded

Banyak tutorial lama nyebut rp.proxyscrape.com atau port 6060/7777 hardcoded. Yang resmi sekarang: rp.scrapegw.com, dan port-nya per-akun — selalu copy dari dashboard Proxy Setup.

Sub-user mati walau quota masih ada

Per docs: kalau main balance habis atau expired, semua sub-user otomatis berhenti — walau quota individu masih sisa. Monitor balance parent, bukan cuma sub-user.

Bot detection masih kena

Residential proxy bukan magic. Kalau target deteksi via fingerprint (canvas, WebGL, fonts), lo butuh lebih dari sekedar proxy. Pake stealth browser atau anti-detect setup.