mcpField
O
oxylabs-web-unblocker

oxylabs-web-unblocker

github.com/oxylabsData & databases87773 installsUpdated 2w ago
Repository

About oxylabs-web-unblocker

oxylabs-web-unblocker is a skill for accessing websites through a proxy, intended for users dealing with anti-bot protection, fingerprint detection, or JavaScript-heavy pages. Request headers control rendering, location targeting, sessions, and browser actions.

Key features

  1. 01Sending GET and POST requests through a proxy
  2. 02Rendering HTML or retrieving PNG output
  3. 03Setting session IP and geographic location
  4. 04Passing custom headers and cookies
  5. 05Specifying browser actions in a request header

Use cases

  1. 01Accessing sites with anti-bot protection
  2. 02Retrieving rendered content from JavaScript SPAs
  3. 03Keeping a session IP across requests
  4. 04Requesting webpage content from a target location

Install

Copy the command and run it in a terminal.

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

After installing, type/oxylabs-web-unblockerin Claude Code to confirm it loaded.

Bundled filesexamples.md

Details

From the project README

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

HeaderDescription
x-oxylabs-renderhtml for rendered HTML, png for raw PNG bytes; empty value disables automatic forced rendering
X-Oxylabs-Session-IdReuse same IP across requests (any random string)
X-Oxylabs-Geo-LocationTarget country, city/state, ZIP/postcode, or coordinates
x-oxylabs-force-headers: 1Enable custom header passthrough
x-oxylabs-force-cookies: 1Enable custom cookie passthrough
X-Oxylabs-Successful-Status-CodesDefine custom success codes to prevent retries
x-oxylabs-browser-instructionsJSON-escaped browser actions; requires x-oxylabs-render: html

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"

Use values such as Germany, 90210, California,United States, New York,New York,United States, or lat: 40.7128, lng: -74.0060, rad: 50.

Use normal HTTP methods and request bodies through the proxy; Web Unblocker supports both GET and POST.

When to Use Web Unblocker vs Regular Proxies

ScenarioUse
Sites with anti-bot protectionWeb Unblocker
CAPTCHAs, fingerprint detectionWeb Unblocker
JavaScript-heavy SPAsWeb Unblocker with x-oxylabs-render: html
Simple requests, no protectionRegular Proxies
High volume, price sensitiveRegular 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; set client timeouts near 180 seconds for rendered requests
  • Check X-Oxylabs-Final-Url in response headers when redirects matter
  • Avoid adding custom unblocking headers that may interfere with the AI
  • Browser instruction header values must be JSON-escaped and compact; pair them with x-oxylabs-render: html

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

Comments

Markdown supported