Claude Skill

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 stick

LLM Mart · 0 points · 2 views 46 listing impressions 0 install-command copies
Download oxylabs-agent-skills-skills_proxies-eae85fb.zip · 12 KB

Install

skills CLI npx skills add https://github.com/oxylabs/agent-skills/tree/main/skills/proxies
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install oxylabs-agent-skills@llmmart
Git git clone https://github.com/oxylabs/agent-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole oxylabs/agent-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

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
geohash 4-character encoded Geohash geohash-9q8y
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

Files (agent-skills)
  • dedicated-datacenter.md 5.8 KB
    Loading…
  • dedicated-isp.md 5.7 KB
    Loading…
  • examples.md 8.3 KB
    Loading…
  • proxy-types.md 5.4 KB
    Loading…
  • SKILL.md 6.5 KB
    ---
    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](dedicated-datacenter.md) and [dedicated-isp.md](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:**
    ```bash
    curl -x "pr.oxylabs.io:7777" \
      -U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
      "https://ip.oxylabs.io/location"
    ```
    
    **Datacenter proxy:**
    ```bash
    curl -x "dc.oxylabs.io:8000" \
      -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
      "https://ip.oxylabs.io/location"
    ```
    
    **ISP proxy:**
    ```bash
    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` |
    | `geohash` | 4-character encoded Geohash | `geohash-9q8y` |
    | `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:**
    ```bash
    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:**
    ```bash
    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):**
    ```bash
    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)
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.