SkillsAdd

oxylabs/agent-skills

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. Use when routing traffic through proxies, building scrapers with proxy auth, rotating or sticky sessions, whitelisting IPs, or accessing geo-restricted content.

First seen Jul 31, 2026

Installation

$ npx skills add oxylabs/agent-skills --skill proxies
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from oxylabs/agent-skills · top by installs.

npx skills add oxylabs/agent-skills
oxylabs-web-scraper 229 web-scraper-api 149 oxylabs-proxies 80 oxylabs-web-unblocker 73 oxylabs-video-data 63 oxylabs-headless-browser 62 headless-browser 38 web-unblocker 37 video-data 35 oxylabs-unblocking-browser 2

Browse all from oxylabs/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 870
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 5,805 B
  • docs SUMMARY.md 361 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 39 installs

SKILL.md

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 OXYRESUSERNAME, OXYRESPASSWORD customer-
Datacenter, ISP, Dedicated Datacenter, Dedicated ISP OXYDCUSERNAME, OXYDCPASSWORD 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](dedicated-datacenter.md) and [dedicated-isp.md](dedicated-isp.md).

Use separate credentials for Residential/Mobile (OXYRESUSERNAME, OXYRESPASSWORD) and Datacenter/ISP (OXYDCUSERNAME, OXYDCPASSWORD).

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.

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-newyork, -city-losangeles
st US states with us_ prefix -st-uscalifornia, -st-ustexas
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](proxy-types.md)
  • Dedicated Datacenter (Self-Service + Enterprise): [dedicated-datacenter.md](dedicated-datacenter.md)
  • Dedicated ISP (Self-Service + Enterprise): [dedicated-isp.md](dedicated-isp.md)
  • Code examples (all languages): [examples.md](examples.md)