proxyclaw

by ultronprime2026

Install this Skill

curl -fsSL -o proxyclaw.zip https://skill.seembox.com/api/v1/skills/proxyclaw/download && unzip proxyclaw.zip

SKILL.md About

---
name: proxyclaw
description: |
  ProxyClaw by IPLoop — Residential proxy access for AI agents. Route requests through 175M+ 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.
compatibility: Requires network access
metadata:
  author: iploop
  version: "2.4.8"
  website: https://proxyclaw.ai
  source: https://github.com/Iploop/proxyclaw
  platform: https://iploop.io
  docker: ultronloop2026/iploop-node
  openclaw:
    emoji: "🌐"
    requires:
      bins: ["curl"]
      env: ["IPLOOP_API_KEY"]
    primaryEnv: IPLOOP_API_KEY
---

# 🌐 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

### 2. Set Your Key

```bash
export IPLOOP_API_KEY="your_api_key"
```

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

### 3. Fetch Anything

```bash
# 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:
```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_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):
```bash
# 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

```bash
pip install iploop
```

```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

# 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']}-country-US@proxy.iploop.io: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: '', 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": "",
    "password": f"{os.environ['IPLOOP_API_KEY']}-country-US"
})
```

### Scrapy
```python
import os
HTTP_PROXY = f'http://:{os.environ["IPLOOP_API_KEY"]}-country-US@proxy.iploop.io: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.**

```bash
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](https://github.com/Iploop/proxyclaw/blob/main/rules/setup.md) for full setup guide and troubleshooting, or read `rules/setup.md` in the downloaded skill package.

## Links

- **ProxyClaw:** [proxyclaw.ai](https://proxyclaw.ai)
- **Sign Up:** [iploop.io/signup](https://iploop.io/signup.html)
- **Python SDK:** Coming soon
- **Node.js SDK:** Coming soon
- **Docker Hub:** [ultronloop2026/iploop-node](https://hub.docker.com/r/ultronloop2026/iploop-node)
- **Support:** partners@iploop.io

_meta.json Metadata

{
  "ownerId": "kn71m91tk95s3f8sayka8tv3y582q2jf",
  "publishedAt": 1776756206020,
  "slug": "proxyclaw",
  "version": "2.4.8"
}