β³ This skill is pending AI review.
Scores will appear once the review pipeline completes.
proxyclaw
|
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
ProxyClaw β IPLoop V2
Residential proxy requests for agents and scripts. Create/sign in at https://platform.iploop.io/. Save your account API key, separate proxy username and proxy password privately. Add bandwidth and use the connection settings shown in the dashboard. Do not assume a free credit amount or guaranteed target-site acceptance.
V2 setup
export IPLOOP_API_KEY="YOUR_ACCOUNT_API_KEY"
export IPLOOP_PROXY_USERNAME="YOUR_PROXY_USERNAME"
export IPLOOP_PROXY_PASSWORD="YOUR_PROXY_PASSWORD"
The account key is not your proxy password. Setting both proxy credentials explicitly opts into V2; key-only existing integrations retain legacy authentication.
Country, sessions and V2 city targeting
- Country routing uses valid ISO alpha-2 codes; availability depends on the live pool.
- Sticky sessions group requests; device availability can change the exit. A new session does not guarantee a never-used IP.
- State/city selectors are deployed in V2. Country is required; state is optional for a city request. Exact-city accuracy is not certified: some Austin test exits were labeled San Antonio or Schertz by independent geo services. Inspect the observed location when precision matters.
- V2 ASN targeting is not currently supported.
Python SDK
python -m pip install 'iploop-sdk[async,socks]>=1.8.3'
import os
from iploop import IPLoop
client = IPLoop(
os.environ['IPLOOP_API_KEY'],
proxy_username=os.environ['IPLOOP_PROXY_USERNAME'],
proxy_password=os.environ['IPLOOP_PROXY_PASSWORD'],
)
r = client.get('https://example.com', country='US', timeout=15)
r.raise_for_status()
Python SDK 1.8.3 supports country, state and city selectors in sync, async and sticky requests. HTTP/SOCKS5, sticky and account usage instructions: https://proxyclaw.ai/docs.html
Boundaries
A successful proxy connection does not prove anti-bot bypass, CAPTCHA solving, JavaScript rendering or accurate structured extraction. These are separate integrations requiring their own tests. Historical inventory/benchmark numbers are not capacity or availability guarantees. Existing earnings/node programs and legacy API guides are separate from the V2 proxy contract; verify eligibility and rates with support.
Support: [email protected]. Keep credentials private.
Agent CLI (this repository)
Requires Python 3, bash and curl. Install the current ClawHub release or clone GitHub source. Use explicit bash invocation because registry installers may not preserve executable permissions.
git clone https://github.com/Iploop/proxyclaw.git
cd proxyclaw
bash ./setup.sh
bash ./fetch.sh https://example.com --country US
bash ./fetch.sh https://example.com --country US --session demo123
bash ./fetch.sh https://example.com --country GB --protocol socks5h
bash ./fetch.sh https://example.com --format markdown
--format markdown is a basic text conversion, not JavaScript rendering or structured extraction. Credentials are delivered to curl through stdin, not command-line arguments. Failed connections or non-success HTTP status exit nonzero. Setup does not announce success on failure.
V2 state/city interface
bash ./fetch.sh https://example.com --country US --state tx --city austin
bash ./fetch.sh https://example.com --country US --city austin
No deployment flag is required. State/city selectors are deployed in V2. Country is required; state is optional for a city request. Exact-city accuracy is not certified: some Austin test exits were labeled San Antonio or Schertz by independent geo services. Inspect the observed location when precision matters.
Legacy integrations
Leave both V2 proxy credential variables unset to retain existing key-only authentication. This does not migrate legacy credentials or certify all legacy selectors. No customer key revocation is required.
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
SKILL.md7.9 KBupstream β
--- 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 <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](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']}[email protected]: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"]}[email protected]: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:**README.mdupstream β
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/iploop-proxyclaw.md