Agent skill

Proxies

by oxylabs in oxylabs/agent-skills

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.

MITAuto-check passedData & Analytics

Install Proxies

skills CLI
$ npx skills add oxylabs/agent-skills --skill proxies -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oxylabs/agent-skills proxies --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oxylabs/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/proxies .claude/skills/proxies && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
proxies
GitHub stars
875
Token cost
~1.7k tokens
SKILL.md length
541 words
Files
5
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

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.

  • Routing traffic through proxies
  • SKILL.md covers Proxy Types Overview, Environment Variables, Authentication Format and Quick Start, plus 6 more sections
  • Calls curl; reaches ip.oxylabs.io; needs OXY_RES_PASSWORD and OXY_DC_PASSWORD
  • Building scrapers with proxy auth

What it does

Proxies is an agent skill from oxylabs/agent-skills. 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.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `dedicated-datacenter.md`, `dedicated-isp.md` and `examples.md`).

It sits in Data & Analytics, covering Web scraping. The repository describes itself as: Official Agent skills of Oxylabs products. The licence is MIT.

When your agent uses it

  • Routing traffic through proxies
  • Building scrapers with proxy auth
  • Sticky sessions
  • Whitelisting IPs

Example prompts

  • “Use the proxies skill to oxylab proxy networks: Residential, Mobile, shared Datacenter/ISP, and Dedicated Datacenter/ISP proxies with geo-targeting…”
  • “/proxies”

What it can do on your machine

Read from SKILL.md and the folder at commit a410198. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • ip.oxylabs.io

    Also links to:

    • pr.oxylabs.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OXY_RES_PASSWORD
    • OXY_DC_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proxies loads about 1.7k tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 541 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oxylabs/agent-skills at commit a410198, republished under its MIT licence (© oxylabs). 541 words, ~1,651 tokens.

Download SKILL.mdSave it as .claude/skills/proxies/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
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

TypeHostPortBest For
Residentialpr.oxylabs.io7777High anonymity, geo-targeting
Mobilepr.oxylabs.io7777Mobile-specific content, highest trust
Datacenter (shared)dc.oxylabs.io8000 rotation / 8001+ assigned/staticSpeed, high volume
ISP (shared)isp.oxylabs.io8000 rotation / 8001+ assigned/staticSpeed + anonymity balance
Dedicated Datacenterddc.oxylabs.io8000 rotation / 8001+ assigned/staticOwned IPs, port-based access
Dedicated ISPdisp.oxylabs.io8000 rotation / 8001+ assigned/staticOwned 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 familyVariablesUsername prefix
Residential, MobileOXY_RES_USERNAME, OXY_RES_PASSWORDcustomer-
Datacenter, ISP, Dedicated Datacenter, Dedicated ISPOXY_DC_USERNAME, OXY_DC_PASSWORDuser- 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)

ProtocolTransportEntry pointUse when
HTTPTCPpr.oxylabs.io:7777Default. Supported by common libraries and third-party software
HTTPSTCPhttps://pr.oxylabs.io:7777Fully encrypted connection to the proxy
SOCKS5TCP and UDPsocks5h://pr.oxylabs.io:7777Client requires SOCKS5
HTTP/3(MASQUE) UDP (QUIC)masque.oxylabs.io:50000Native 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).

Show full SKILL.md (249 more words)Show less

Geo-Targeting Parameters

For Residential/Mobile, append username parameters with hyphens unless noted:

ParameterFormatExample
ccISO 3166-1 alpha-2-cc-US, -cc-DE, -cc-GB
cityEnglish, underscores for spaces-city-new_york, -city-los_angeles
stUS states with us_ prefix-st-us_california, -st-us_texas
postalcode5-digit US ZIP, pair with cc-US-cc-US-postalcode-90210
ASNResidential/Mobile carrier ASN-ASN-21928
X-Oxylabs-GeolocationProxy header lat:lon;radius_miles49.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

ParameterDescriptionNotes
sessidKeep the same IP across requestsStandard session is 10 minutes or up to 60s of inactivity
sessid_oneipBind the session to one exact exit nodeReturns 502 if that IP becomes unavailable
sesstimeSet session duration in minutes with sessid or sessid_oneipResidential 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

NeedRecommended
Highest anonymityResidential
Mobile app contentMobile
Speed & volumeDatacenter
Speed + anonymityISP
Owned dedicated IPsDedicated Datacenter or Dedicated ISP
Geo-restricted contentResidential/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

© oxylabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in skills/proxies of oxylabs/agent-skills.

  • SKILL.md
  • dedicated-datacenter.md
  • dedicated-isp.md
  • examples.md
  • proxy-types.md

Open the folder on GitHubat commit a410198

Compare with similar skills

Proxies next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Proxies compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proxies this skilloxylabs/agent-skills875—~1.7kAutomated safety check: PassMIT
Web Scrapingplatonai/Browser41.2k—~1.1kAutomated safety check: PassApache-2.0
Chrome Devtoolseinverne/dotfiles1211 repos~1.6kAutomated safety check: NotesApache-2.0
Web Crawlerbyungjunjang/web-crawler165—~7.2kAutomated safety check: PassMIT
Web Search Scraper API Skillbrowser-act/skills6.1k1 repos~1.3kAutomated safety check: PassMIT
Keirouter Web Fetchmydisha/keirouter147—~741Automated safety check: PassMIT

Similar skills

  • Web Scraping

    platonai/Browser4

    Extracts data from web pages using browser automation and CSS/JavaScript selectors.

    1.2k GitHub stars~1.1k tokensUpdated 2 days ago
    Data & AnalyticsAuto-check passed
  • Chrome Devtools

    einverne/dotfiles

    Browser automation, debugging, and performance analysis using Puppeteer CLI scripts.

    121 GitHub starsUsed in 1 repo~1.6k tokens
    Data & AnalyticsAuto-check: notes
  • Web Crawler

    byungjunjang/web-crawler

    URL과 수집 항목을 받아 사이트를 정찰하고 데이터를 수집하여 엑셀로 출력하는 범용 웹 크롤링 에이전트. An agent skill from byungjunjang/web-crawler.

    165 GitHub stars~7.2k tokensUpdated 3 days ago
    Data & AnalyticsAuto-check passed
  • This skill helps users automatically extract complete Markdown content from any website via the BrowserAct Web Search Scraper API.

    6.1k GitHub starsUsed in 1 repo~1.3k tokens
    Data & AnalyticsAuto-check passed
  • Keirouter Web Fetch

    mydisha/keirouter

    Fetch URL → markdown / text / HTML via KeiRouter /v1/web/fetch using Firecrawl / Jina Reader / Tavily Extract / Exa Contents.

    147 GitHub stars~741 tokensUpdated 28 days ago
    Data & AnalyticsAuto-check passed
  • Scrapling

    Tommy-yw/RunbookHermes

    Web scraping with Scrapling - HTTP fetching, stealth browser automation, Cloudflare bypass, and spider crawling via CLI and Python.

    546 GitHub starsUsed in 3 repos~2.3k tokens
    Data & AnalyticsAuto-check passed

More from oxylabs/agent-skills

  • Agent Browser

    oxylabs/agent-skills

    Connects to Oxylabs remote agent browsers over the Chrome DevTools Protocol (CDP) with Playwright or Puppeteer.

    875 GitHub stars~3k tokensUpdated 9 days ago
    Auto-check passed
  • Video Data

    oxylabs/agent-skills

    YouTube data extraction API and high-bandwidth proxy downloads.

    875 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed
  • Web Scraper API

    oxylabs/agent-skills

    Production-grade web scraping with automatic anti-bot bypass, structured JSON parsing for 40+ targets, and geo-targeting.

    875 GitHub stars~1.5k tokensUpdated 9 days ago
    Auto-check passed
  • Web Unblocker

    oxylabs/agent-skills

    Bypasses anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript rendering, and retries automatically.

    875 GitHub stars~865 tokensUpdated 9 days ago
    Auto-check passed

Questions about Proxies

What does Proxies do?

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. Proxies is an agent skill from oxylabs/agent-skills. 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.

When should I use Proxies?

Proxies fits situations like: routing traffic through proxies; building scrapers with proxy auth; sticky sessions; whitelisting IPs.

How do I install Proxies in Claude Code?

Run `npx skills add oxylabs/agent-skills --skill proxies -a claude-code`. Or copy the skill folder (skills/proxies in oxylabs/agent-skills) into .claude/skills/proxies in your project. Claude Code loads it when a task matches its description.

How do I install Proxies in Codex?

Run `npx skills add oxylabs/agent-skills --skill proxies -a codex`. Or copy the skill folder (skills/proxies in oxylabs/agent-skills) into .agents/skills/proxies in your project. Codex loads it when a task matches its description.

Can I use Proxies in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oxylabs/agent-skills --skill proxies -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/proxies, .gemini/skills/proxies, .github/skills/proxies and .opencode/skills/proxies in your project.

What does Proxies need to run?

Going by SKILL.md and its folder, Proxies needs the command-line tools its instructions call (curl) and credentials named OXY_RES_PASSWORD and OXY_DC_PASSWORD.

Does Proxies access the network?

SKILL.md names 2 domains. In commands or code: ip.oxylabs.io; the agent is likely to contact it when it follows the instructions. As links in the text: pr.oxylabs.io. This is read from the text; nothing was executed.

Is Proxies safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Proxies use?

Proxies is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Proxies use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Proxies?

Skills that share tags, products or a category with Proxies: Web Scraping (platonai/Browser4, 1.2k stars), Chrome Devtools (einverne/dotfiles, 121 stars), Web Crawler (byungjunjang/web-crawler, 165 stars) and Web Search Scraper API Skill (browser-act/skills, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proxies?

oxylabs (a GitHub organization) maintains it in oxylabs/agent-skills, which has 875 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 30, 2026.

Source: oxylabs/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.