SkillAgentSearch 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

Install / Use

npx skills add oxylabs/agent-skills --skill proxies

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

91/100

Supported Platforms

Universal

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.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
proxies (this skill)by oxylabs9187559d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP 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.

name: 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

Related Skills

View on GitHub
GitHub Stars875
CategoryDevelopment
Updated1mo ago
Forks2

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions