oxylabs-proxies

Name: oxylabs-proxies
Author: oxylabs

github.com/oxylabsCloud & DevOps87780 installsUpdated 2w ago

About oxylabs-proxies

oxylabs-proxies is a skill for configuring and using Oxylabs proxies, aimed at users who need proxy access, geographic targeting, or IP session control. It covers endpoints, authentication, and parameters across several proxy types.

Key features

01Residential, mobile, datacenter, and ISP proxy setup
02Targeting by country, city, and postal code
03Keeping or binding IPs through session parameters
04Selecting rotating or static IPs by port

Use cases

01Choosing a proxy type for a request
02Targeting residential traffic to a country or city
03Reusing the same IP across requests

Install

Copy the command and run it in a terminal.

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

After installing, type/oxylabs-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.

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