proxies
Oxylabs proxy networks: Residential, Mobile, shared Datacenter/ISP, and Dedicated Datacenter/ISP proxies with geo-targeting, IP rotation, session persistence, and port-based sticky IPs
Install / Use
npx skills add oxylabs/agent-skills --skill proxiesInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of proxies
proxies scores 91/100 on our quality scale, 1120th of 4,700 Development & Engineering skills we index (top 24%).
Its SKILL.md is 6.4 KB long, well organised into 11 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.
It has 875 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so proxies is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
proxies compared with similar skills
All 4 of these similar skills score higher than proxies; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| proxies (this skill)by oxylabs | 91 | 875 | 59d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install proxies?
- Run
npx skills add oxylabs/agent-skills --skill proxies. The install tabs above show the steps for each supported agent. - Which AI agents does proxies work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is proxies safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is proxies still maintained?
- The repository was last updated about 2 months ago, so proxies is actively maintained.
Skill content
View source on GitHubname: proxies description: >- Oxylabs proxy networks: Residential, Mobile, shared Datacenter/ISP, and Dedicated Datacenter/ISP proxies with geo-targeting, IP rotation, session persistence, and port-based sticky IPs. Use when routing traffic through proxies, building scrapers with proxy auth, rotating or sticky sessions, whitelisting IPs, or accessing geo-restricted content.
Oxylabs Proxies
Proxy Types Overview
| Type | Host | Port | Best For |
|------|------|------|----------|
| Residential | pr.oxylabs.io | 7777 | High anonymity, geo-targeting |
| Mobile | pr.oxylabs.io | 7777 | Mobile-specific content, highest trust |
| Datacenter (shared) | dc.oxylabs.io | 8000 rotation / 8001+ assigned/static | Speed, high volume |
| ISP (shared) | isp.oxylabs.io | 8000 rotation / 8001+ assigned/static | Speed + anonymity balance |
| Dedicated Datacenter | ddc.oxylabs.io | 8000 rotation / 8001+ assigned/static | Owned IPs, port-based access |
| Dedicated ISP | disp.oxylabs.io | 8000 rotation / 8001+ assigned/static | Owned ISP IPs, ASN locked |
Residential/Mobile use pr.oxylabs.io:7777 with username session parameters. Datacenter/ISP and Dedicated self-service products use proxy-list ports starting at 8001 for assigned/static IPs and 8000 for automatic rotation.
Environment Variables
Use credentials for the specific proxy product family:
| Product family | Variables | Username prefix |
|----------------|-----------|-----------------|
| Residential, Mobile | OXY_RES_USERNAME, OXY_RES_PASSWORD | customer- |
| Datacenter, ISP, Dedicated Datacenter, Dedicated ISP | OXY_DC_USERNAME, OXY_DC_PASSWORD | user- for self-service/shared |
Authentication Format
customer-USERNAME:PASSWORD # Residential, Mobile
user-USERNAME:PASSWORD # Shared Datacenter, Shared ISP
Dedicated proxy auth (Self-Service vs Enterprise) is in dedicated-datacenter.md and dedicated-isp.md.
Use separate credentials for Residential/Mobile (OXY_RES_USERNAME, OXY_RES_PASSWORD) and Datacenter/ISP (OXY_DC_USERNAME, OXY_DC_PASSWORD).
With parameters:
customer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD
Quick Start
Residential/Mobile proxy:
curl -x "pr.oxylabs.io:7777" \
-U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
"https://ip.oxylabs.io/location"
Datacenter proxy:
curl -x "dc.oxylabs.io:8000" \
-U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
"https://ip.oxylabs.io/location"
ISP proxy:
curl -x "isp.oxylabs.io:8001" \
-U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
"https://ip.oxylabs.io/location"
For Datacenter, ISP, Dedicated Datacenter, and Dedicated ISP proxies, use dashboard proxy-list ports starting at 8001 for assigned/static IPs; the first listed IP uses 8001. Switch to port 8000 only when the task calls for automatic rotation.
Protocols (Residential)
| Protocol| Transport| Entry point| Use when| |---------|----------|-----------|----------| |HTTP| TCP| pr.oxylabs.io:7777| Default. Supported by common libraries and third-party software| |HTTPS| TCP| https://pr.oxylabs.io:7777| Fully encrypted connection to the proxy| |SOCKS5| TCP and UDP| socks5h://pr.oxylabs.io:7777| Client requires SOCKS5| |HTTP/3| (MASQUE) UDP (QUIC)| masque.oxylabs.io:50000| Native HTTP/3, UDP, DNS over UDP, WebRTC/SIP/gaming traffic|
If the task only needs standard HTTP or HTTPS (TCP) requests, use the main endpoint pr.oxylabs.io:7777. MASQUE adds QUIC connection setup overhead and is only worth it when UDP or native HTTP/3 transport is required.
Google is a restricted target over UDP connections (applies to MASQUE and SOCKS5 UDP).
Geo-Targeting Parameters
For Residential/Mobile, append username parameters with hyphens unless noted:
| Parameter | Format | Example |
|-----------|--------|---------|
| cc | ISO 3166-1 alpha-2 | -cc-US, -cc-DE, -cc-GB |
| city | English, underscores for spaces | -city-new_york, -city-los_angeles |
| st | US states with us_ prefix | -st-us_california, -st-us_texas |
| postalcode | 5-digit US ZIP, pair with cc-US | -cc-US-postalcode-90210 |
| ASN | Residential/Mobile carrier ASN | -ASN-21928 |
| X-Oxylabs-Geolocation | Proxy header lat:lon;radius_miles | 49.9235:-97.0811;10 |
ZIP targeting is US-only. Coordinate radius cannot be lower than 10 miles. If both country and ASN are used, country applies.
Example with geo-targeting:
curl -x "pr.oxylabs.io:7777" \
-U "customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD" \
"https://ip.oxylabs.io/location"
For Shared Datacenter/ISP country rotation, use -country-US with user- credentials on the rotation port.
Session Control
| Parameter | Description | Notes |
|-----------|-------------|-------|
| sessid | Keep the same IP across requests | Standard session is 10 minutes or up to 60s of inactivity |
| sessid_oneip | Bind the session to one exact exit node | Returns 502 if that IP becomes unavailable |
| sesstime | Set session duration in minutes with sessid or sessid_oneip | Residential backconnect supports up to 1440 minutes; some entry modes cap lower |
Sticky session example:
curl -x "pr.oxylabs.io:7777" \
-U "customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD" \
"https://example.com"
Timed session (5 minutes):
curl -x "pr.oxylabs.io:7777" \
-U "customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD" \
"https://example.com"
Choosing the Right Proxy Type
| Need | Recommended |
|------|-------------|
| Highest anonymity | Residential |
| Mobile app content | Mobile |
| Speed & volume | Datacenter |
| Speed + anonymity | ISP |
| Owned dedicated IPs | Dedicated Datacenter or Dedicated ISP |
| Geo-restricted content | Residential/Mobile with cc/city/postalcode, or DC/ISP by country/assigned port where suitable |
Default Behavior
- Without parameters: random IP for each request
- Residential/Mobile share the same endpoint but different IP pools
- Sessions auto-expire and get new IPs
Additional Resources
- Shared proxy details (Residential, Mobile, Datacenter, ISP): proxy-types.md
- Dedicated Datacenter (Self-Service + Enterprise): dedicated-datacenter.md
- Dedicated ISP (Self-Service + Enterprise): dedicated-isp.md
- Code examples (all languages): examples.md
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
