mcpField
W
web-unblocker

web-unblocker

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

About web-unblocker

A skill guide for using Oxylabs Web Unblocker as a proxy for requests to protected or JavaScript-heavy websites. It documents rendering, session persistence, and location targeting.

Key features

  1. 01Automatic fingerprint and header management
  2. 02JavaScript rendering as HTML or PNG
  3. 03Persistent IP sessions
  4. 04Country, city, and coordinate targeting
  5. 05Custom header and cookie passthrough

Use cases

  1. 01Fetch content from anti-bot-protected sites
  2. 02Retrieve rendered pages from JavaScript SPAs
  3. 03Make requests from a specified geographic location

Install

Copy the command and run it in a terminal.

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

After installing, type/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