ProxyClaw

ProxyClaw by IPLoop — Residential proxy access for AI agents. Route requests through 175M+ residential IPs across 195+ countries from real Android, Windows,...

🌐 ProxyClaw by IPLoop

Route web requests through 175M+ residential IPs across 195+ countries. Bypass geo-restrictions, rotate IPs automatically, and scrape sites with anti-bot bypass.

Usage: Run ./fetch.sh <URL> to fetch a URL through the proxy. Requires IPLOOP_API_KEY environment variable.

---

🔒 Security Notes

Aspect	Detail
Environment variables	IPLOOP_API_KEY — set via env var, not hardcoded
Files read	None
Files written	mktemp temp file (auto-deleted on exit, including SIGINT)
Network destinations	proxy.iploop.io:8880 (proxy gateway) + user-specified target URLs
Secrets handling	API key passed via --proxy-user to curl. Note: curl args may be transiently visible in process listings on shared systems. Use session-scoped env vars rather than storing in ~/.bashrc.
Proxy transport	HTTP proxy protocol. Proxy authentication is sent to proxy.iploop.io before TLS to the target. For HTTPS targets, payload is protected by TLS; the proxy auth header itself is in plaintext to the proxy.
Input validation	URL (must start with http/https), country (2-letter ISO code), timeout (1-120s)

---

🚀 Quick Start (30 seconds)

1. Get Your Free API Key

Sign up at iploop.io/signup — 0.5 GB free, no credit card required.

2. Set Your Key

export IPLOOP_API_KEY="your_api_key"

⚠️ Set this in your session only — avoid storing in ~/.bashrc to limit exposure.

3. Fetch Anything

# Auto-rotate IP every request
./fetch.sh https://example.com

# Target a country, get markdown
./fetch.sh https://example.com --country US --format markdown

# City-level targeting
./fetch.sh https://example.com --country US --city newyork

# Sticky session (same IP across requests)
./fetch.sh https://example.com --session mysession

# ASN/ISP targeting
./fetch.sh https://example.com --asn 12345

# Or use curl directly
curl --proxy "http://proxy.iploop.io:8880" \
     --proxy-user ":${IPLOOP_API_KEY}" \
     https://example.com

Run ./setup.sh to verify your connection is working.

---

🤖 Agent Usage Examples

When a user asks:

"Fetch the Amazon price for this product from a US IP"

You run:

./fetch.sh https://amazon.com/dp/PRODUCT_ID --country US --format markdown

"Scrape this LinkedIn profile"

You run:

./fetch.sh https://linkedin.com/in/username --country US --format markdown

"Check what this page looks like from Germany"

You run:

./fetch.sh https://example.com --country DE

---

🌍 Country Targeting

Append -country-{CC} to your API key in the proxy password:

# 195+ countries supported
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-country-US" https://example.com
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-country-DE" https://example.com
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-country-GB" https://example.com
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-country-JP" https://example.com
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-country-BR" https://example.com

Advanced targeting (curl-only options also available via ./fetch.sh flags):

# City level (--city flag in fetch.sh)
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-country-US-city-newyork" ...

# Sticky session (--session flag in fetch.sh)
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-session-mysession" ...

# ISP/ASN targeting (--asn flag in fetch.sh)
curl --proxy "http://proxy.iploop.io:8880" --proxy-user ":${IPLOOP_API_KEY}-asn-12345" ...

---

🐍 Python SDK

pip install iploop

from iploop import IPLoop

client = IPLoop(api_key="your_api_key")  # stealth auto-activates

# Fetches through residential proxy with anti-bot fingerprinting
r = client.fetch("https://www.zillow.com/homes/NYC_rb/")  # ✅ anti-bot bypassed
r = client.fetch("https://www.walmart.com/browse/electronics")  # ✅ 1MB+ content
r = client.fetch("https://www.indeed.com/jobs?q=python")  # ✅ job listings

# Country targeting
r = client.fetch("https://example.com", country="DE")

# Sticky session (same IP)
session = client.session()
r1 = session.fetch("http://httpbin.org/ip")
r2 = session.fetch("http://httpbin.org/ip")  # same IP

# Manual proxy config (available now via standard requests)
import os, requests
proxies = {"https": f"http://:{os.environ['IPLOOP_API_KEY']}[e-mail]:8880"}
r = requests.get("https://example.com", proxies=proxies)

---

🌐 Browser Integration

Puppeteer

const browser = await puppeteer.launch({
  args: [`--proxy-server=http://proxy.iploop.io:8880`]
});
const page = await browser.newPage();
await page.authenticate({ username: '', password: `${process.env.IPLOOP_API_KEY}-country-US` });
await page.goto('https://example.com');

Playwright

browser = p.chromium.launch(proxy={
    "server": "http://proxy.iploop.io:8880",
    "username": "",
    "password": f"{os.environ['IPLOOP_API_KEY']}-country-US"
})

Scrapy

import os
HTTP_PROXY = f'http://:{os.environ["IPLOOP_API_KEY"]}[e-mail]:8880'

---

💰 Pricing

Plan	Per GB	Rate Limit
Free	$0	30 req/min (0.5 GB included)
Growth	$0.50	300 req/min
Enterprise	Custom	1000 req/min

---

🐳 Earn Free Proxy Credits

Share unused bandwidth → earn proxy credits. 1 GB shared = 1 GB of proxy access.

docker run -d --name iploop-node --restart=always ultronloop2026/iploop-node:latest

Runs on Linux, macOS, Windows, Raspberry Pi. Uses < 50MB RAM.

---

📊 Network

• 175M+ residential IPs
• 23,000+ nodes online
• 98,000+ daily unique IPs
• 195+ countries
• 99%+ success rate
• < 0.5s avg response

---

🔧 Setup & Troubleshooting

See rules/setup.md for full setup guide and troubleshooting, or read rules/setup.md in the downloaded skill package.

Links

• ProxyClaw: proxyclaw.ai
• Sign Up: iploop.io/signup
• Python SDK: Coming soon
• Node.js SDK: Coming soon
• Docker Hub: ultronloop2026/iploop-node
• Support: [e-mail]