ProxyClaw

ProxyClaw by IPLoop — Residential proxy access for AI agents. Route requests through 2M+ residential IPs across 195+ countries from real Android, Windows, Mac & Smart TV devices. Bypass geo-restrictions, rotate IPs automatically. Free tier with 0.5GB included. Earn unlimited proxy credits by contributing bandwidth via Docker. Use OPENCLAW for 20% off any paid plan.

🌐 ProxyClaw by IPLoop

This is an action skill. When a user asks to fetch a URL, scrape a site, or use a proxy — execute the request yourself and return the result. Do not just show instructions.

Expected behaviour:

• Call ./fetch.sh <URL> [--country CC] [--format markdown] yourself and return the content
• When the user asks "fetch this page through a US proxy" — run it, show the result
• Only show setup instructions when IPLOOP_API_KEY is missing or the user explicitly asks how to set up

A good check: If your response says "you can run this command to…" — reconsider. The user wants results, not instructions.

---

🔒 Security Posture

Aspect	Detail
Environment variables	IPLOOP_API_KEY — checked for existence only, never echoed or logged
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 (not in URL or command line args visible in ps aux)
Proxy transport	HTTP proxy protocol — key is encrypted via HTTPS CONNECT tunnel to HTTPS targets
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.

Use code OPENCLAW for 20% off any paid plan.

2. Set Your Key

bash

export IPLOOP_API_KEY="your_api_key"

3. Fetch Anything

bash

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

# SERP / Google-compatible search in Python
python examples/python_serp.py "public search query"

# 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:${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:

bash

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

"Scrape this LinkedIn profile"

You run:

bash

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

"Check what this page looks like from Germany"

You run:

bash

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

---

🌍 Country Targeting

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

bash

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

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

bash

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

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

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

---

🐍 Python SDK

bash

pip install iploop-sdk
# Includes: Chrome fingerprinting, auto-retry, site presets, and SERP support

python

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

# SERP / Google-compatible search research
# Use this instead of raw google.com/search to avoid verification pages.
results = client.serp.search("public search query", country="US")
print(results["results"])

# Google compatibility wrapper; uses the safe SERP path by default
results = client.google.search("public search query", country="US")

# Raw Google is QA-only and may return verification pages
raw = client.google.search("public search query", country="US", direct=True)

# 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://iploop:{os.environ['IPLOOP_API_KEY']}[e-mail]:8880"}
r = requests.get("https://example.com", proxies=proxies)

---

🌐 Browser Integration

Puppeteer

javascript

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

Playwright

python

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

Scrapy

python

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

---

💰 Pricing

Plan	Per GB	Rate Limit
Free	$0	30 req/min (0.5 GB included)
Starter	$4.50	120 req/min
Growth	$3.50	300 req/min
Business	$2.50	600 req/min
Enterprise	Custom	1000 req/min

🎁 Use code OPENCLAW for 20% off any paid plan at iploop.io/signup

---

🐳 Earn Free Proxy Credits

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

bash

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

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

---

📊 Network

• 2M+ 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.

Links

• ProxyClaw: proxyclaw.ai
• Sign Up: iploop.io/signup
• Python SDK: pip install iploop-sdk on PyPI — site presets, Chrome fingerprinting, SERP-safe search
• Docker Hub: ultronloop2026/iploop-node
• Support: [e-mail]