skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
oxylabs/agent-skills111 installs

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.

How do I install this agent skill?

npx skills add https://github.com/oxylabs/agent-skills --skill proxies
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides comprehensive documentation and code examples for using Oxylabs proxy services. It follows security best practices by using environment variables for credentials and only references official vendor domains.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Oxylabs Proxies

Proxy Types Overview

TypeHostPortBest For
Residentialpr.oxylabs.io7777High anonymity, geo-targeting
Mobilepr.oxylabs.io7777Mobile-specific content, highest trust
Datacenter (shared)dc.oxylabs.io8000 rotation / 8001+ assigned/staticSpeed, high volume
ISP (shared)isp.oxylabs.io8000 rotation / 8001+ assigned/staticSpeed + anonymity balance
Dedicated Datacenterddc.oxylabs.io8000 rotation / 8001+ assigned/staticOwned IPs, port-based access
Dedicated ISPdisp.oxylabs.io8000 rotation / 8001+ assigned/staticOwned 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 familyVariablesUsername prefix
Residential, MobileOXY_RES_USERNAME, OXY_RES_PASSWORDcustomer-
Datacenter, ISP, Dedicated Datacenter, Dedicated ISPOXY_DC_USERNAME, OXY_DC_PASSWORDuser- 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)

ProtocolTransportEntry pointUse when
HTTPTCPpr.oxylabs.io:7777Default. Supported by common libraries and third-party software
HTTPSTCPhttps://pr.oxylabs.io:7777Fully encrypted connection to the proxy
SOCKS5TCP and UDPsocks5h://pr.oxylabs.io:7777Client requires SOCKS5
HTTP/3(MASQUE) UDP (QUIC)masque.oxylabs.io:50000Native 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:

ParameterFormatExample
ccISO 3166-1 alpha-2-cc-US, -cc-DE, -cc-GB
cityEnglish, underscores for spaces-city-new_york, -city-los_angeles
stUS states with us_ prefix-st-us_california, -st-us_texas
postalcode5-digit US ZIP, pair with cc-US-cc-US-postalcode-90210
ASNResidential/Mobile carrier ASN-ASN-21928
X-Oxylabs-GeolocationProxy header lat:lon;radius_miles49.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

ParameterDescriptionNotes
sessidKeep the same IP across requestsStandard session is 10 minutes or up to 60s of inactivity
sessid_oneipBind the session to one exact exit nodeReturns 502 if that IP becomes unavailable
sesstimeSet session duration in minutes with sessid or sessid_oneipResidential 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

NeedRecommended
Highest anonymityResidential
Mobile app contentMobile
Speed & volumeDatacenter
Speed + anonymityISP
Owned dedicated IPsDedicated Datacenter or Dedicated ISP
Geo-restricted contentResidential/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

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/oxylabs/agent-skills/proxies">View proxies on skillZs</a>