masterhttprelayvpn-proxy — Claude Code skill: proxy over Apps Script
A skill that walks your agent through running a local HTTP/SOCKS5 proxy, with traffic tunnelled through Google Apps Script and dressed up as Google requests.
npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a claude-codeWhat masterhttprelayvpn-proxy does
MasterHttpRelayVPN listens on your machine and forwards traffic along a chain: browser, local proxy at 127.0.0.1:8085, a Google IP, the Apps Script relay, then the destination site. A free Google account is all you need; there is no VPS to rent. Because the proxy intercepts TLS locally and re-encrypts it, HTTPS pages stay broken until you install the CA certificate.
The skill covers the whole setup. You deploy the relay in Apps Script with an AUTH_KEY, copy the Deployment ID into config.json next to auth_key, start things with python3 main.py, and add the certificate via python main.py --install-cert. An interactive wizard, python setup.py, generates the key and writes the config for you. Ports, an ad-blocking block_hosts list and a bypass_hosts list for local addresses that skip the relay are all set in that same file.
Watch the key: auth_key in config.json has to match AUTH_KEY in Code.gs, or the relay rejects every request. To spread load you can list several Deployment IDs under script_ids, though each script needs the same secret. Keep the ca/ folder to yourself — its private key sits in the middle of all your HTTPS traffic.
What it helps with
- run a proxy without renting a VPS
- get past DPI by making traffic look like Google
- point a browser and curl at a local HTTP proxy
- share the proxy with other machines on the LAN
- drop ad domains through
block_hosts
Example prompts for the agent
- Set up MasterHttpRelayVPN: write
config.jsonwith my Deployment ID and start the proxy on port 8085 - Configure the Google Apps Script tunnel and install the CA certificate for HTTPS
- Turn on SOCKS5 at port 1080 and add
.doubleclick.nettoblock_hosts
How to install masterhttprelayvpn-proxy
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a claude-code2Manually: put the files in place
~/.claude/skills/masterhttprelayvpn-proxy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/masterhttprelayvpn-proxy/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a codex2Manually: put the files in place
.agents/skills/masterhttprelayvpn-proxy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a cursor2Manually: put the files in place
.cursor/skills/masterhttprelayvpn-proxy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills masterhttprelayvpn-proxy2Manually: put the files in place
.github/skills/masterhttprelayvpn-proxy/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/masterhttprelayvpn-proxyManually: put the files in place
.devin/skills/masterhttprelayvpn-proxy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about masterhttprelayvpn-proxy
How do I install masterhttprelayvpn-proxy in Claude Code?
Run npx skills add reason-machines/trending-skills --skill masterhttprelayvpn-proxy -a claude-code. The skill lands in ~/.claude/skills/masterhttprelayvpn-proxy/SKILL.md.
What does masterhttprelayvpn-proxy do?
It guides your agent through setting up a local HTTP/SOCKS5 proxy that tunnels through Google Apps Script, makes requests look like Google traffic and intercepts TLS to re-encrypt it.
What do I need before running the proxy?
A free Google account, an Apps Script relay deployed with its AUTH_KEY set, and the CA certificate from ca/ca.crt installed. The key in config.json must match the one in Code.gs.
