Oxylabs Proxy Integration Guide
Gives Claude the exact Oxylabs endpoints, auth formats, geo-targeting parameters and session rules needed to wire proxies into scrapers correctly.
Web & APIIntermediate★ 875⑂ 2AI score 8/10Last updated: Sep 24, 2026
What it does
- Tabulates host/port per proxy product (
pr.oxylabs.io:7777,dc.oxylabs.io:8000,isp.oxylabs.io:8001, dedicated DC/ISP). - Explains auth prefixes (
customer-for Residential/Mobile,user-for shared Datacenter/ISP) and separate env varsOXY_RES_*/OXY_DC_*. - Documents geo-targeting username parameters: country, city, US state, ZIP, carrier ASN, and lat/lon radius header.
- Covers sticky/rotating sessions with
sessid,sessid_oneip,sesstimeand their expiry limits. - Compares HTTP, HTTPS, SOCKS5 and MASQUE (HTTP/3) transports, including caveats such as Google being restricted over UDP.
Who it's for
- Developers with an Oxylabs subscription building scrapers or crawlers.
- Data engineers validating geo-restricted content (pricing, ad verification).
- Anyone repeatedly misconfiguring rotation vs. assigned ports or sticky sessions.
Examples
- "Give me a curl command that fetches this page from a New York, US IP" → builds
customer-...-cc-US-city-new_york. - "Write Python requests code that keeps the same exit IP for 5 minutes" → uses
sessidplussesstime-5. - "High-volume crawl where speed matters — which product?" → recommends shared Datacenter on rotation port
8000with a working snippet.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/oxylabs/agent-skills/HEAD/skills/proxies/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/proxies folder from the GitHub repo oxylabs/agent-skills into my ~/.claude/skills/proxies/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/oxylabs/agent-skills.git /tmp/oxylabs-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/oxylabs-agent-skills/skills/proxies ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/oxylabs/agent-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r agent-skills/skills/proxies ~/.claude/skills/ - Export your Oxylabs credentials as environment variables:
export OXY_RES_USERNAME=...andexport OXY_RES_PASSWORD=...(Residential/Mobile)export OXY_DC_USERNAME=...andexport OXY_DC_PASSWORD=...(Datacenter/ISP)- Add them to
~/.zshrcor~/.bashrcso they persist.
- Restart Claude Code and try: "send a test request through the Oxylabs proxy from a US IP".
View source on GitHub ↗License: MIT