Oxylabs Web Unblocker Skill
Teaches Claude how to fetch anti-bot-protected pages through the Oxylabs Web Unblocker proxy, including rendering, sessions, and geo-targeting.
Web & APIIntermediate★ 871⑂ 2AI score 8/10Last updated: Aug 21, 2026
What it does
- Gives Claude the exact recipe for the Oxylabs Web Unblocker proxy endpoint (
https://unblock.oxylabs.io:60000) with HTTP Basic Auth credentials. - Documents the key headers:
x-oxylabs-render(HTML or PNG rendering),X-Oxylabs-Session-Id(sticky IP),X-Oxylabs-Geo-Location(country, city/state, ZIP, coordinates), forced header/cookie passthrough, custom success status codes, and browser instructions. - Includes operational guidelines: always pass
-k(proxy uses its own certs), set ~180s timeouts for rendered requests, checkX-Oxylabs-Final-Urlfor redirects, avoid conflicting unblocking headers. - Provides a decision table for Web Unblocker vs. regular proxies, plus a pointer to multi-language code examples.
Who it's for
- Data engineers with an existing Oxylabs subscription running scraping pipelines.
- Crawler developers blocked by CAPTCHAs and browser fingerprinting.
- Teams extracting data from JavaScript-heavy single-page apps.
Example uses
- "This product page returns 403" → Claude writes a curl/Python request through Web Unblocker with
x-oxylabs-render: html. - "Show me German pricing" → adds
X-Oxylabs-Geo-Location: Germanyto the request. - "Crawl several pages from the same IP after login" → uses
X-Oxylabs-Session-Idplus forced cookie passthrough.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/oxylabs/agent-skills/HEAD/skills/web-unblocker/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/web-unblocker folder from the GitHub repo oxylabs/agent-skills into my ~/.claude/skills/web-unblocker/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/oxylabs/agent-skills.git /tmp/oxylabs-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/oxylabs-agent-skills/skills/web-unblocker ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and create the skills directory:
mkdir -p ~/.claude/skills - Clone the repository:
git clone https://github.com/oxylabs/agent-skills.git /tmp/oxylabs-agent-skills - Copy just this skill:
cp -r /tmp/oxylabs-agent-skills/skills/web-unblocker ~/.claude/skills/ - Get your Web Unblocker username and password from the Oxylabs dashboard (paid product).
- Export credentials:
export OXYLABS_USERNAME="..."andexport OXYLABS_PASSWORD="..."(add them to ~/.zshrc or ~/.bashrc to persist). - Restart Claude Code and ask something like "fetch this blocked URL via Web Unblocker" to trigger the skill.
View source on GitHub ↗License: MIT