Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Oxylabs Proxies | DecimalAI

oxylabs/proxies

SkillScore96Maintained

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.

DevOpsby oxylabs

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Data Engineer pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/oxylabs-proxies/SKILL.md

decimalai skills pull oxylabs-proxies --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/oxylabs-proxies/SKILL.md https://app.decimal.ai/s/oxylabs-proxies/SKILL.md

Raw file: /s/oxylabs-proxies/SKILL.md ↗ · machine-readable summary at /s/oxylabs-proxies.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

24 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 3d ago

—+58% tokens0% turns96% of whole cases pass with skill (23/24)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	153%	0%
case-02	✗→✓	▲ Improved	65%	0%
case-03	✗→✓	▲ Improved	92%	0%
case-07	✗→✓	▲ Improved	66%	0%
case-08	✗→✓	▲ Improved	25%	0%

Showing 5 of 24 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v5 — 9/24/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

oxylabs / agent-skills

skills/proxies/SKILL.md

View on GitHub ↗

License MITImported 9/24/2026Version v2

Skill contents

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

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 | | 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
Dedicated Datacenter (Self-Service + Enterprise): dedicated-datacenter.md
Dedicated ISP (Self-Service + Enterprise): dedicated-isp.md
Code examples (all languages): examples.md

Illustrative Want to see what oxylabs/proxies would put in front of your model? Preview the rendered body and check its trigger phrases — no LLM call, no signup.

Latest benchmark · publisher runVerified

9/24/2026, 19:57 UTC · 24 cases

Measured on 21 comparable cases — below the 22 needed to publish a lift, so this result is shown here but not on the registry card or leaderboard.

Lift

+54%

96% vs 42%

Agent turns

1.0 vs 1.0

Tokens

+58%

2,962.52 vs 1,873.29

fail → pass · 14pass → pass · 9pass → fail · 1

Per-case results (24)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I need a curl command to test scraping a location-sensitive site using Oxylabs residential proxies. Please provide the shell command that routes requests through a persistent residential session located in New York City, set to keep the same exit IP for 10 minutes, assuming I have my Oxylabs username and password stored in standard environment variables.	fail→pass	68,202	9,912	-85%	1	1	0%	1,140	2,888	+153%	0	0	—
case-02 Can you give me the curl syntax for accessing Oxylabs shared datacenter proxies using a standard assigned static entry port versus switching to automatic IP rotation? Please show the command structure using environment variables for proxy authentication so I can run a quick location check against https://ip.oxylabs.io/location.	fail→pass	11,788	13,923	+18%	1	1	0%	1,923	3,168	+65%	0	0	—
case-03 I need to configure a cURL request through Oxylabs residential proxies that targets Beverly Hills (ZIP code 90210) in the United States and locks the session strictly to a single exit node. Please provide the exact bash cURL call utilizing my Oxylabs residential credentials environment variables.	fail→pass	10,475	5,813	-45%	1	1	0%	1,581	3,029	+92%	0	0	—
case-04 I am building a web scraper in Python using Playwright to extract product prices from an e-commerce platform that relies heavily on client-side React rendering. How do I configure Playwright's browser context to wait for network idle and execute custom JavaScript snippets to scroll down the page before saving the HTML content?	pass→fail	20,298	35,685	+76%	1	1	0%	3,161	4,283	+35%	0	0	—
case-05 I need to configure local proxy forwarding on an Ubuntu server using Squid proxy daemon so that all outgoing developer traffic is logged and restricted to an internal whitelist of domain names. What configuration directives should I add to /etc/squid/squid.conf for ACL domain filtering?	pass→pass	13,444	14,326	+7%	1	1	0%	2,385	4,136	+73%	0	0	—
case-06 How do I configure a custom Node.js Express server to handle incoming WebHook payloads securely using HMAC SHA-256 signature verification in the request headers? Please provide a code snippet for validating the header against a secret key.	pass→pass	16,901	12,903	-24%	1	1	0%	2,674	4,405	+65%	0	0	—
case-07 I need to make an HTTP request via cURL through an Oxylabs shared ISP proxy to check my assigned IP. I want to hit the first static entry port assigned to my account rather than rotating IPs across requests. Which host, port, and credential prefix should be formatted in the cURL request?	fail→pass	30,309	21,164	-30%	1	1	0%	1,515	2,514	+66%	0	0	—
case-08 I am testing mobile app API endpoints that require traffic coming from mobile devices located in California, United States. I want to route requests through Oxylabs mobile proxy endpoints with sticky session persistence. What username structure and proxy endpoint should be configured?	fail→pass	15,442	9,805	-37%	1	1	0%	2,260	2,835	+25%	0	0	—
case-09 We are building a network testing tool that needs native HTTP/3 and UDP transport support over Oxylabs residential proxies to evaluate WebRTC traffic. Standard HTTP/HTTPS proxying on TCP won't work for this specific low-latency test. What host and port endpoint should we target for MASQUE UDP connection setup?	fail→pass	58,535	4,969	-92%	1	1	0%	836	2,436	+191%	0	0	—
case-10 Our infrastructure team is migrating to Oxylabs Dedicated Datacenter proxies for high-volume API requests where we own specific assigned IPs. What entry host should we configure, and which port number corresponds to our first static IP allocation versus the automatic rotation port?	pass→pass	21,981	5,425	-75%	1	1	0%	1,794	2,605	+45%	0	0	—
case-11 I need to curl through Oxylabs shared datacenter proxies with automatic IP rotation, specifically filtering for IPs in Germany. Which proxy port and username parameter flag should be appended when authenticating with datacenter credentials?	fail→pass	10,508	29,408	+180%	1	1	0%	1,731	2,659	+54%	0	0	—
case-12 I want to pinpoint residential proxy location in Winnipeg, Canada using precise geographical coordinates (latitude 49.9235, longitude -97.0811) with a 15-mile radius, rather than relying on standard city string parameters. How is this geolocation metadata transmitted in HTTP requests through Oxylabs residential proxies?	fail→pass	17,196	11,276	-34%	1	1	0%	2,676	3,845	+44%	0	0	—
case-13 When configuring coordinate-based proxy geolocation with latitude and longitude parameters for Oxylabs residential proxy routing, what is the strict minimum radius in miles that must be specified to prevent parameter validation errors?	fail→pass	51,658	3,029	-94%	1	1	0%	3,195	2,377	-26%	0	0	—
case-14 We are configuring proxy settings for dedicated ISP proxy IPs assigned to our account by Oxylabs. Which host endpoint should our scraping workers connect to, and which port starts the assigned static proxy list?	fail→pass	11,127	4,185	-62%	1	1	0%	1,516	2,516	+66%	0	0	—
case-15 Our backend crawling worker uses a Python library that requires explicit SOCKS5 protocol endpoints to handle remote DNS resolution when tunneling through Oxylabs residential proxies. What complete proxy URL scheme and entry host should be configured?	pass→pass	12,188	7,390	-39%	1	1	0%	2,008	3,197	+59%	0	0	—
case-16 I need to target a specific residential ISP network in the US by filtering traffic through AS21928 (Lumen/CenturyLink) on Oxylabs residential proxies. How should the ASN parameter be formatted inside the proxy authentication string?	pass→pass	7,556	6,426	-15%	1	1	0%	1,023	2,928	+186%	0	0	—
case-17 If an automated proxy request string accidentally includes both a country parameter (such as -cc-US) and a specific carrier ASN parameter (such as -ASN-21928), how does Oxylabs residential proxy routing resolve the conflict between the two geo-targeting flags?	fail→pass	155,838	6,078	-96%	1	1	0%	2,304	2,541	+10%	0	0	—
case-18 We need to maintain long-running backconnect sticky sessions for scraping complex multi-step user flows using Oxylabs residential proxies. What is the maximum session duration in minutes supported via the sesstime parameter?	fail→pass	19,906	7,567	-62%	1	1	0%	713	2,666	+274%	0	0	—
case-19 We require fully encrypted TLS connections to the proxy entry node itself when routing traffic through Oxylabs residential proxies. How should the proxy URL protocol scheme be specified in client configurations?	pass→pass	14,522	6,664	-54%	1	1	0%	2,014	2,965	+47%	0	0	—
case-20 When attempting to route UDP traffic or MASQUE HTTP/3 requests through Oxylabs residential proxies, which major target destination is restricted over UDP connections?	pass→pass	10,093	7,058	-30%	1	1	0%	1,094	2,284	+109%	0	0	—
case-21 When attempting to route residential requests targeting a specific postal ZIP code (such as 90210), what accompanying geo-targeting parameter is strictly required in the username parameter chain?	pass→pass	7,581	3,350	-56%	1	1	0%	942	2,412	+156%	0	0	—
case-22 In our central secrets manager, we store proxy credentials separately for different Oxylabs product lines. Which exact environment variable names are standard for Residential/Mobile proxies versus Shared Datacenter/ISP proxies?	fail→pass	18,489	54,757	+196%	1	1	0%	2,066	2,459	+19%	0	0	—
case-23 When building authentication strings for Oxylabs proxies, what string prefix must precede your portal username for Residential proxies, and what prefix must precede it for Shared Datacenter proxies?	fail→pass	16,583	2,983	-82%	1	1	0%	2,864	2,358	-18%	0	0	—
case-24 When specifying strict session binding using the sessid_oneip parameter on Oxylabs residential proxies, what HTTP status code does the proxy gateway return if that specific exit IP becomes unavailable during the session?	pass→pass	7,275	3,647	-50%	1	1	0%	1,095	2,408	+120%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 24 cases were attempted, and 21 counted toward the lift figure. The other 3 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +54 percentage points is the difference between those two pass rates over the 21 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 41.7%
Pass rate with the skill: 95.8%
Cases attempted: 24
Cases counted toward lift: 21
Cases that regressed: 1
Skill version measured: v2
Run completed: 9/24/2026, 19:57 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-02

Prompt

Can you give me the curl syntax for accessing Oxylabs shared datacenter proxies using a standard assigned static entry port versus switching to automatic IP rotation? Please show the command structure using environment variables for proxy authentication so I can run a quick location check against https://ip.oxylabs.io/location.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run96

Live evalNeeds ≥10 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+82% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 3 days ago

Other measured skills in the registry, with their headline benchmark lift.