How do I install the API Proxy skill?

Run npx skillmds@latest add tomevault-io/api-proxy in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is API Proxy safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with API Proxy?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is API Proxy free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published API Proxy?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

API Proxy by tomevault-io — Agent Skill

Name: API Proxy
Author: tomevault-io

API Proxy

Routes API requests through the user's residential proxy to bypass cloud IP blocks. TWO use cases - (1) Runtime fallback when direct curl/fetch fails with 403/blocked errors, use fetch.py for quick retry. (2) Template for building new skills that need proxy routing, copy proxy_helper.py into the new skill. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

API Proxy Skill

Routes requests through residential IP via proxy.address.here.com.

Runtime Fallback (ad-hoc)

When a direct request fails with 403 or IP blocking, retry through the proxy:

# Simple GET
python3 /mnt/skills/user/api-proxy/scripts/fetch.py "https://api.example.com/endpoint"

# POST with body
python3 /mnt/skills/user/api-proxy/scripts/fetch.py "https://api.example.com/endpoint" POST '{"key": "value"}'

Returns JSON response or {"error": "message"} on failure.

Template Mode (building skills)

When creating skills that need proxy routing:

Copy proxy_helper.py into the new skill's scripts/ folder
Import and use:

from proxy_helper import proxy_get, proxy_request

data = proxy_get("https://api.example.com/endpoint")

data = proxy_request(
    url="https://api.example.com/endpoint",
    method="POST",
    headers={"Authorization": "Bearer xyz"},
    body='{"key": "value"}'
)

Proxy Details

URL: https://proxy.address.here.com/proxy
Token: your_token_here

Currently Whitelisted Domains

reddit.com, www.reddit.com, oauth.reddit.com

New domains require user to add them to ALLOWED_DOMAINS env var and restart the container.

Troubleshooting

Error	Cause	Fix
403 from proxy	Domain not whitelisted	Ask user to whitelist
503 from proxy	Rate limited	Retry after delay
504 from proxy	Upstream timeout	Increase timeout
Connection refused	Container/tunnel down	Check status

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: api-proxydescription: Routes API requests through the user's residential proxy to bypass cloud IP blocks. TWO use cases - (1) Runtime fallback when direct curl/fetch fails with 403/blocked errors, use fetch.py for quick retry. (2) Template for building new skills that need proxy routing, copy proxy_helper.py into the new skill. Use when this capability is needed.---# API Proxy SkillRoutes requests through residential IP via `proxy.address.here.com`.## Runtime Fallback (ad-hoc)When a direct request fails with 403 or IP blocking, retry through the proxy:```bash# Simple GETpython3 /mnt/skills/user/api-proxy/scripts/fetch.py "https://api.example.com/endpoint"# POST with bodypython3 /mnt/skills/user/api-proxy/scripts/fetch.py "https://api.example.com/endpoint" POST '{"key": "value"}'```Returns JSON response or `{"error": "message"}` on failure.## Template Mode (building skills)When creating skills that need proxy routing:1. Copy `proxy_helper.py` into the new skill's `scripts/` folder2. Import and use:```pythonfrom proxy_helper import proxy_get, proxy_requestdata = proxy_get("https://api.example.com/endpoint")data = proxy_request( url="https://api.example.com/endpoint", method="POST", headers={"Authorization": "Bearer xyz"}, body='{"key": "value"}')```## Proxy Details```URL: https://proxy.address.here.com/proxyToken: your_token_here```## Currently Whitelisted Domains- `reddit.com`, `www.reddit.com`, `oauth.reddit.com`New domains require user to add them to `ALLOWED_DOMAINS` env var and restart the container.## Troubleshooting| Error | Cause | Fix ||-------|-------|-----|| 403 from proxy | Domain not whitelisted | Ask user to whitelist || 503 from proxy | Rate limited | Retry after delay || 504 from proxy | Upstream timeout | Increase timeout || Connection refused | Container/tunnel down | Check status |---> Converted and distributed by [TomeVault](https://tomevault.io/claim/abra5umente) — claim your Tome and manage your conversions.

Frequently asked questions