🌐 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 | INLINECODE2 — 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
CODEBLOCK0
3. Fetch Anything
CODEBLOCK1
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:
CODEBLOCK2
"Scrape this LinkedIn profile"
You run:
CODEBLOCK3
"Check what this page looks like from Germany"
You run:
./fetch.sh https://example.com --country DE
🌍 Country Targeting
Append -country-{CC} to your API key in the proxy password:
CODEBLOCK5
Advanced targeting (curl-only options also available via ./fetch.sh flags):
# City level (--city flag in fetch.sh)
curl --proxy "http://proxy.iploop.io:8880" --proxy-user "user:${IPLOOP_API_KEY}-country-US-city-newyork" ...
# Sticky session (--session flag in fetch.sh)
curl --proxy "http://proxy.iploop.io:8880" --proxy-user "user:${IPLOOP_API_KEY}-session-mysession" ...
# ISP/ASN targeting (--asn flag in fetch.sh)
curl --proxy "http://proxy.iploop.io:8880" --proxy-user "user:${IPLOOP_API_KEY}-asn-12345" ...
🐍 Python SDK
⚠️ Coming Soon — The iploop Python package is not yet available on PyPI. The examples below show the planned API; check iploop.io for release status.
CODEBLOCK7
CODEBLOCK8
🌐 Browser Integration
Puppeteer
CODEBLOCK9
Playwright
CODEBLOCK10
Scrapy
import os
HTTP_PROXY = f'http://user:{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
🐳 Earn Free Proxy Credits
Share unused bandwidth → earn proxy credits. 1 GB shared = 1 GB of proxy access.
CODEBLOCK12
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
🌐 IPLoop 的 ProxyClaw
这是一个动作技能。 当用户要求获取 URL、抓取网站或使用代理时——请自行执行请求并返回结果。不要仅仅显示说明。
预期行为：
- - 自行调用 ./fetch.sh [--country CC] [--format markdown] 并返回内容
- 当用户要求通过美国代理获取此页面时——运行它，显示结果
- 仅在 IPLOOPAPIKEY 缺失或用户明确询问如何设置时，才显示设置说明
一个好的检查方法： 如果你的回复中说你可以运行这个命令来……——请重新考虑。用户想要的是结果，而不是说明。
🔒 安全态势
| 方面 | 详情 |
|---|
| 环境变量 | IPLOOPAPIKEY — 仅检查是否存在，绝不回显或记录 |
| 读取的文件 |
无 |
|
写入的文件 | mktemp 临时文件（退出时自动删除，包括 SIGINT 信号） |
|
网络目标 | proxy.iploop.io:8880（代理网关）+ 用户指定的目标 URL |
|
密钥处理 | API 密钥通过 --proxy-user 传递（不在 URL 或 ps aux 可见的命令行参数中） |
|
代理传输 | HTTP 代理协议——密钥通过 HTTPS CONNECT 隧道加密传输到 HTTPS 目标 |
|
输入验证 | URL（必须以 http/https 开头）、国家（2 字母 ISO 代码）、超时时间（1-120 秒） |
🚀 快速入门（30 秒）
1. 获取免费 API 密钥
在 iploop.io/signup 注册——0.5 GB 免费，无需信用卡。
使用代码 OPENCLAW 可享受任何付费计划 20% 的折扣。
2. 设置密钥
bash
export IPLOOPAPIKEY=yourapikey
3. 获取任何内容
bash
每次请求自动轮换 IP
./fetch.sh https://example.com
定位到特定国家，获取 markdown 格式
./fetch.sh https://example.com --country US --format markdown
城市级定位
./fetch.sh https://example.com --country US --city newyork
粘性会话（跨请求保持相同 IP）
./fetch.sh https://example.com --session mysession
ASN/ISP 定位
./fetch.sh https://example.com --asn 12345
或直接使用 curl
curl --proxy http://proxy.iploop.io:8880 \
--proxy-user user:${IPLOOP
APIKEY} \
https://example.com
运行 ./setup.sh 验证你的连接是否正常工作。
🤖 代理使用示例
当用户询问：
从美国 IP 获取这个产品的亚马逊价格
你运行：
bash
./fetch.sh https://amazon.com/dp/PRODUCT_ID --country US --format markdown
抓取这个 LinkedIn 个人资料
你运行：
bash
./fetch.sh https://linkedin.com/in/username --country US --format markdown
检查这个页面从德国看起来是什么样子
你运行：
bash
./fetch.sh https://example.com --country DE
🌍 国家定位
在代理密码中，将 -country-{CC} 附加到你的 API 密钥：
bash
支持 195+ 个国家
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-country-US https://example.com
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-country-DE https://example.com
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-country-GB https://example.com
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-country-JP https://example.com
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-country-BR https://example.com
高级定位（仅 curl 选项，也可通过 ./fetch.sh 标志使用）：
bash
城市级别（fetch.sh 中的 --city 标志）
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-country-US-city-newyork ...
粘性会话（fetch.sh 中的 --session 标志）
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-session-mysession ...
ISP/ASN 定位（fetch.sh 中的 --asn 标志）
curl --proxy http://proxy.iploop.io:8880 --proxy-user user:${IPLOOP
APIKEY}-asn-12345 ...
🐍 Python SDK
⚠️ 即将推出 — iploop Python 包尚未在 PyPI 上提供。以下示例展示了计划中的 API；请查看 iploop.io 了解发布状态。
bash
pip install iploop-sdk # v1.8.0 — 66 个网站预设 + 反检测
包括：14 头 Chrome 指纹、TLS/JA3 欺骗、自动重试、66 个预设
python
from iploop import IPLoop
client = IPLoop(apikey=yourapi_key) # 隐身模式自动激活
通过住宅代理获取，带有反机器人指纹识别
r = client.fetch(https://www.zillow.com/homes/NYC_rb/) # ✅ 绕过反机器人
r = client.fetch(https://www.walmart.com/browse/electronics) # ✅ 1MB+ 内容
r = client.fetch(https://www.indeed.com/jobs?q=python) # ✅ 职位列表
国家定位
r = client.fetch(https://example.com, country=DE)
粘性会话（相同 IP）
session = client.session()
r1 = session.fetch(http://httpbin.org/ip)
r2 = session.fetch(http://httpbin.org/ip) # 相同 IP
手动代理配置（现在可通过标准 requests 使用）
import os, requests
proxies = {https: fhttp://user:{os.environ[IPLOOP
APIKEY]}-country-US@proxy.iploop.io:8880}
r = requests.get(https://example.com, proxies=proxies)
🌐 浏览器集成
Puppeteer
javascript
const browser = await puppeteer.launch({
args: [--proxy-server=http://proxy.iploop.io:8880]
});
const page = await browser.newPage();
await page.authenticate({ username: user, password: ${process.env.IPLOOP
APIKEY}-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
APIKEY]}-country-US
})
Scrapy
python
import os
HTTP
PROXY = fhttp://user:{os.environ[IPLOOPAPI_KEY]}-country-US@proxy.iploop.io:8880
💰 定价
| 计划 | 每 GB 价格 | 速率限制 |
|---|
| 免费 | $0 | 30 次请求/分钟（包含 0.5 GB） |
| 入门版 |
$4.50 | 120 次请求/分钟 |
|
成长版 | $3.50 | 300 次请求/分钟 |
|
商业版 | $2.50 | 600 次请求/分钟 |
|
企业版 | 定制 | 1000 次请求/分钟 |
🎁 在 iploop.io/signup 使用代码 OPENCLAW 可享受任何付费计划 20% 的折扣
🐳 赚取免费代理积分
分享未使用的带宽 → 赚取代理积分。共享 1 GB = 获得 1 GB 的代理访问权限。
bash
docker run -d --name iploop-node --restart=always ultronloop2026/iploop-node:latest
可在 Linux、macOS、Windows、Raspberry Pi 上运行。内存
