Agent Skill · Oxylabs

oxylabs-web-unblocker

Bypasses anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript rendering, and retries automatically. Use when the user needs to scrape protected websites, bypass CAPTCHAs, access blocked content, or when regular proxies fail due to anti-bot measures.

View SKILL.md on GitHub → Source repository Provider profile

Provider: Oxylabs Path in repo: skills/web-unblocker/SKILL.md

Skill body

Oxylabs Web Unblocker

AI-powered proxy solution that automatically manages fingerprinting, headers, retries, and JavaScript rendering.

Endpoint

https://unblock.oxylabs.io:60000

Authentication

HTTP Basic Auth via proxy credentials:

curl -k -x "https://unblock.oxylabs.io:60000" \
  -U "$OXYLABS_USERNAME:$OXYLABS_PASSWORD" \
  "https://example.com"

Quick Start

Basic request:

curl -k -x "https://unblock.oxylabs.io:60000" \
  -U "$OXYLABS_USERNAME:$OXYLABS_PASSWORD" \
  "https://ip.oxylabs.io/headers"

With JavaScript rendering:

curl -k -x "https://unblock.oxylabs.io:60000" \
  -U "$OXYLABS_USERNAME:$OXYLABS_PASSWORD" \
  -H "x-oxylabs-render: html" \
  "https://example.com/spa-page"

Headers

Header	Description
`x-oxylabs-render`	`html` for rendered HTML, `png` for screenshot
`X-Oxylabs-Session-Id`	Reuse same IP across requests (any random string)
`X-Oxylabs-Geo-Location`	Target country (e.g., `Germany`, `United States`)
`x-oxylabs-force-headers: 1`	Enable custom header passthrough
`X-Oxylabs-Successful-Status-Codes`	Define custom success codes to prevent retries

Session Persistence

Reuse the same IP across multiple requests:

curl -k -x "https://unblock.oxylabs.io:60000" \
  -U "$OXYLABS_USERNAME:$OXYLABS_PASSWORD" \
  -H "X-Oxylabs-Session-Id: my-session-123" \
  "https://example.com/page1"

Geo-Location Targeting

curl -k -x "https://unblock.oxylabs.io:60000" \
  -U "$OXYLABS_USERNAME:$OXYLABS_PASSWORD" \
  -H "X-Oxylabs-Geo-Location: Germany" \
  "https://example.com"

When to Use Web Unblocker vs Regular Proxies

Scenario	Use
Sites with anti-bot protection	Web Unblocker
CAPTCHAs, fingerprint detection	Web Unblocker
JavaScript-heavy SPAs	Web Unblocker with `x-oxylabs-render: html`
Simple requests, no protection	Regular Proxies
High volume, price sensitive	Regular Proxies

Key Guidelines

Always use -k flag (or disable SSL verification) - the proxy uses its own certificates
Add x-oxylabs-render: html if experiencing empty content or low success rates
Avoid adding custom unblocking headers that may interfere with the AI

For code examples in Python, Node.js, PHP, Go, Java, and C#, see examples.md.

Work with this as data

Every skill here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for agent skills

4 MCP tools reach this

find_skillsBrowse and filter every skill in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This skill

curl "https://apis.io/api/v1/skills/oxylabs-web-unblocker"

All agent skills

curl "https://apis.io/api/v1/skills?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.