Skip to content

Commit c179e2a

Browse files
committed
fix: ClawHub SKILL.md — remove overly-broad env vars, fix package name mismatch, add privacy note
1 parent 514708e commit c179e2a

1 file changed

Lines changed: 25 additions & 53 deletions

File tree

clawhub/proxy4agent/SKILL.md

Lines changed: 25 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,32 @@
11
---
22
name: proxy4agent
33
description: Residential proxy for AI agents — fetch any URL through 2M+ real IPs, bypass anti-bot, geo-target, sticky sessions.
4-
version: 1.5.3
4+
version: 1.6.2
55
metadata:
66
openclaw:
77
requires:
88
anyBins: [node, npx]
9-
env:
10-
- NOVADA_PROXY_USER
11-
- NOVADA_PROXY_PASS
12-
- NOVADA_API_KEY
13-
- NOVADA_BROWSER_WS
14-
- BRIGHTDATA_USER
15-
- BRIGHTDATA_PASS
16-
- SMARTPROXY_USER
17-
- SMARTPROXY_PASS
18-
- OXYLABS_USER
19-
- OXYLABS_PASS
20-
- PROXY_URL
219
primaryEnv: NOVADA_PROXY_USER
2210
always: false
2311
homepage: https://github.com/Goldentrii/proxy4agent
2412
os: [macos, linux, windows]
2513
install:
2614
- kind: node
27-
formula: proxy-veil@1.6.0
28-
bins: [proxy4agent]
15+
formula: bestproxy4agents@1.6.2
16+
bins: [bestproxy4agents]
2917
---
3018

31-
# proxy4agent
19+
# Proxy4Agent
3220

3321
Residential proxy MCP server for AI agents. Route HTTP requests through 2M+ real home devices to bypass anti-bot systems, geo-target by country or city, and maintain sticky sessions.
3422

23+
**npm package:** `bestproxy4agents` | **GitHub:** [Goldentrii/proxy4agent](https://github.com/Goldentrii/proxy4agent)
24+
3525
## Setup
3626

37-
Install as an MCP server:
27+
You only need credentials for ONE provider. Novada is the default and recommended provider.
28+
29+
### Option 1: Novada (recommended)
3830

3931
```bash
4032
claude mcp add proxy4agent \
@@ -43,34 +35,28 @@ claude mcp add proxy4agent \
4335
-- npx -y bestproxy4agents
4436
```
4537

46-
Or with any other proxy provider:
38+
Get credentials: [novada.com](https://www.novada.com) → Dashboard → Residential Proxies (30 seconds, no credit card).
39+
40+
### Option 2: Any HTTP proxy
4741

4842
```bash
49-
# BrightData
5043
claude mcp add proxy4agent \
51-
-e BRIGHTDATA_USER="brd-customer-abc-zone-residential" \
52-
-e BRIGHTDATA_PASS=your_password \
44+
-e PROXY_URL="http://user:pass@host:port" \
5345
-- npx -y bestproxy4agents
46+
```
5447

55-
# Smartproxy
56-
claude mcp add proxy4agent \
57-
-e SMARTPROXY_USER=your_username \
58-
-e SMARTPROXY_PASS=your_password \
59-
-- npx -y bestproxy4agents
48+
Works with BrightData, Smartproxy, Oxylabs, IPRoyal, or any standard HTTP proxy. Encode targeting in the URL per your provider's format.
6049

61-
# Oxylabs
62-
claude mcp add proxy4agent \
63-
-e OXYLABS_USER=your_username \
64-
-e OXYLABS_PASS=your_password \
65-
-- npx -y bestproxy4agents
50+
### Optional additional credentials
6651

67-
# Any HTTP proxy
68-
claude mcp add proxy4agent \
69-
-e PROXY_URL="http://user:pass@host:port" \
70-
-- npx -y bestproxy4agents
71-
```
52+
These are NOT required. Only set them if you need the specific feature:
53+
54+
- `NOVADA_API_KEY` — enables `agentproxy_search` (Google search via Novada Scraper API)
55+
- `NOVADA_BROWSER_WS` — enables `agentproxy_render` (JS rendering via Novada Browser API)
56+
57+
## Privacy note
7258

73-
Get Novada credentials: [novada.com](https://www.novada.com) (30 seconds, no credit card).
59+
All HTTP requests are routed through your chosen proxy provider's residential network. Do not send sensitive internal URLs, API keys, or personally identifiable information through the proxy. The proxy provider can see request URLs and response content in transit. Use only for public web content.
7460

7561
## Tools
7662

@@ -98,7 +84,7 @@ Structured Google search. Returns titles, URLs, descriptions as clean JSON.
9884
agentproxy_search(query="residential proxy for AI", num=5, country="us")
9985
```
10086

101-
Requires: `NOVADA_API_KEY`
87+
Requires: `NOVADA_API_KEY` (optional — only if you need search)
10288

10389
### agentproxy_render
10490
Render JS-heavy pages with real Chromium (SPAs, React/Vue apps).
@@ -107,25 +93,11 @@ Render JS-heavy pages with real Chromium (SPAs, React/Vue apps).
10793
agentproxy_render(url="https://react.dev", wait_for=".main-content", format="markdown")
10894
```
10995

110-
Requires: `NOVADA_BROWSER_WS`
96+
Requires: `NOVADA_BROWSER_WS` (optional — only if you need JS rendering)
11197

11298
### agentproxy_status
11399
Check proxy network health. No credentials needed.
114100

115-
## Providers
116-
117-
Priority: Novada > BrightData > Smartproxy > Oxylabs > Generic HTTP.
118-
119-
All providers support automatic country/city/session targeting except Generic (encode manually in URL).
120-
121-
| Provider | Env vars | Auto targeting |
122-
|----------|----------|---------------|
123-
| Novada | `NOVADA_PROXY_USER` + `NOVADA_PROXY_PASS` | Yes |
124-
| BrightData | `BRIGHTDATA_USER` + `BRIGHTDATA_PASS` | Yes |
125-
| Smartproxy | `SMARTPROXY_USER` + `SMARTPROXY_PASS` | Yes |
126-
| Oxylabs | `OXYLABS_USER` + `OXYLABS_PASS` | Yes |
127-
| Generic | `PROXY_URL` | No (manual) |
128-
129101
## When to use proxy4agent
130102

131103
- Target site blocks your agent (403, captcha, Cloudflare challenge)

0 commit comments

Comments
 (0)