--- name: proxyclaw description: | 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. compatibility: Requires network access metadata: author: iploop version: "2.5.2" website: https://proxyclaw.ai platform: https://iploop.io docker: ultronloop2026/iploop-node openclaw: emoji: "🌐" requires: bins: ["curl"] env: ["IPLOOP_API_KEY"] primaryEnv: IPLOOP_API_KEY --- # 🌐 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 [--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](https://iploop.io/signup.html)** β€” 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']}-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: '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"]}-country-US@proxy.iploop.io: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](https://iploop.io/signup.html) --- ## 🐳 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](./rules/setup.md) for full setup guide and troubleshooting. ## Links - **ProxyClaw:** [proxyclaw.ai](https://proxyclaw.ai) - **Sign Up:** [iploop.io/signup](https://iploop.io/signup.html) - **Python SDK:** `pip install iploop-sdk` on PyPI β€” site presets, Chrome fingerprinting, SERP-safe search - **Docker Hub:** [ultronloop2026/iploop-node](https://hub.docker.com/r/ultronloop2026/iploop-node) - **Support:** partners@iploop.io