proxies

Name: proxies
Author: oxylabs

github.com/oxylabsCloud & DevOps87783 installsUpdated 2w ago

About proxies

proxies is a guide to configuring Oxylabs proxies for users who need residential, mobile, datacenter, ISP, or dedicated proxy access. It also describes connection protocols, geographic targeting, authentication, and session controls.

Key features

01Configuring shared and dedicated proxy types
02HTTP, HTTPS, SOCKS5, and HTTP/3 support
03Targeting by country, city, state, or postal code
04Keeping or binding IPs through session parameters
05Selecting rotating or static IPs by port

Use cases

01Choosing a proxy and protocol for a request
02Targeting proxy traffic to a specific location
03Maintaining sessions or using fixed IPs across requests

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oxylabs/agent-skills --skill proxies

After installing, type/proxiesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

dedicated-datacenter.md

dedicated-isp.md

examples.md

proxy-types.md

Details

From the project README

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

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

Comments

Markdown supported

Details

Author: oxylabs
Repository: oxylabs/agent-skills
Category: Cloud & DevOps
Installs: 83
GitHub stars: 877

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.