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, Dedicated Datacenter, ISP and Dedicated 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, subtitles, 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, subtitles, 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) |
Read more on our agent skills documentation