# 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.

- **Type:** Skill
- **Install:** `agentstack add skill-abra5umente-api-proxy-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [abra5umente](https://agentstack.voostack.com/s/abra5umente)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [abra5umente](https://github.com/abra5umente)
- **Source:** https://github.com/abra5umente/api-proxy/tree/main/skill

## Install

```sh
agentstack add skill-abra5umente-api-proxy-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
# 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:

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

```python
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 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [abra5umente](https://github.com/abra5umente)
- **Source:** [abra5umente/api-proxy](https://github.com/abra5umente/api-proxy)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-abra5umente-api-proxy-skill
- Seller: https://agentstack.voostack.com/s/abra5umente
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.