Oxylabs Agent Skills

Official agent skills for Oxylabs products. Each skill provides structured instructions that AI agents can use to interact with Oxylabs services.

Available Skills

Skill	Directory	Description
Proxies	skills/proxies	Residential, Mobile, Datacenter, and ISP proxy network with geo-targeting, IP rotation, and session persistence
Web Unblocker	skills/web-unblocker	AI-powered proxy that handles fingerprinting, JavaScript rendering, CAPTCHAs, and improves access reliability automatically
Web Scraper API	skills/web-scraper-api	Production-grade web scraping with structured JSON parsing for 40+ targets and geo-targeting
Headless Browser	skills/headless-browser	Remote headless browsers via CDP (Playwright/Puppeteer) with built-in request handling and residential proxies
Video Data	skills/video-data	Video data extraction (metadata, transcripts, search, channels) and high-bandwidth proxy video downloads

Product Routing

Need	Use
Bring your own HTTP client, proxy auth, IP rotation, sticky sessions, or raw geo-targeted proxy traffic	Proxies
Fetch protected pages without browser interactions	Web Unblocker
Get structured data from supported targets, search results, e-commerce pages, or parsed JSON	Web Scraper API
Clicks, forms, screenshots, browser state, or Playwright/Puppeteer automation	Headless Browser
YouTube metadata, transcripts, search, channel data, or video/audio downloads	Video Data

Start with the most specific product that fits the task. Validate one small request first, confirm auth, status, and expected output, then scale with explicit limits.

Installation

Claude Code (plugin marketplace)

Inside Claude Code, run:

/plugin marketplace add oxylabs/agent-skills
/plugin install oxylabs@oxylabs-agent-skills

This installs all 5 skills as a single plugin. To update later:

/plugin marketplace update oxylabs-agent-skills

Other agents (generic)

npx skills add https://github.com/oxylabs/agent-skills.git

Configuration

All skills authenticate via environment variables defined in a .env file.

Variable	Used By	Description
OXY_RES_USERNAME	Residential/Mobile Proxies	Residential or Mobile proxy username
OXY_RES_PASSWORD	Residential/Mobile Proxies	Residential or Mobile proxy password
OXY_DC_USERNAME	Datacenter/ISP Proxies	Datacenter or ISP proxy username
OXY_DC_PASSWORD	Datacenter/ISP Proxies	Datacenter or ISP proxy password
OXYLABS_USERNAME	Web Unblocker	Web Unblocker username
OXYLABS_PASSWORD	Web Unblocker	Web Unblocker password
OXY_WSA_USERNAME	Web Scraper API, Video Data	Web Scraper API username
OXY_WSA_PASSWORD	Web Scraper API, Video Data	Web Scraper API password
OXY_HB_USERNAME	Headless Browser	Headless Browser username
OXY_HB_PASSWORD	Headless Browser	Headless Browser password
OXY_HB_ENDPOINT	Video Data	Dedicated high-bandwidth proxy endpoint (for video downloads)