⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v3.0.3

proxyclaw

iploop@iploop⭐ 13 stars· last commit 12d ago· 0 open issues

|

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.

β€”/10

// RATINGS

⭐GitHub Stars
⭐⭐ 13 on GitHubGitHub β†—

Growing

🟒ProSkills Score
β€”
πŸ“

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

// REPO STATS

13 stars
0 open issues
Last commit: 12d ago