Agent skill

Web Unblocker

by oxylabs in oxylabs/agent-skills

Bypasses anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript rendering, and retries automatically.

MITAuto-check passedData & Analytics

Install Web Unblocker

skills CLI
$ npx skills add oxylabs/agent-skills --skill web-unblocker -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install oxylabs/agent-skills web-unblocker --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/oxylabs/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/web-unblocker .claude/skills/web-unblocker && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
web-unblocker
GitHub stars
875
Token cost
~865 tokens
SKILL.md length
261 words
Files
2
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Bypasses anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript rendering, and retries automatically.

  • The user needs to scrape protected websites
  • SKILL.md covers Endpoint, Authentication, Quick Start and Headers, plus 4 more sections
  • Calls curl; reaches unblock.oxylabs.io and ip.oxylabs.io; needs OXYLABS_PASSWORD
  • Bypass CAPTCHAs

What it does

Web Unblocker is an agent skill from oxylabs/agent-skills. 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.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `examples.md`).

It sits in Data & Analytics, covering Web scraping. It works with JavaScript. The repository describes itself as: Official Agent skills of Oxylabs products. The licence is MIT.

When your agent uses it

  • The user needs to scrape protected websites
  • Bypass CAPTCHAs
  • Access blocked content
  • Regular proxies fail due to anti-bot measures

Example prompts

  • “Use the web-unblocker skill to bypass anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript…”
  • “/web-unblocker”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit a410198. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • unblock.oxylabs.io
    • ip.oxylabs.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OXYLABS_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Web Unblocker loads about 865 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 261 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~865

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oxylabs/agent-skills at commit a410198, republished under its MIT licence (© oxylabs). 261 words, ~865 tokens.

Download SKILL.mdSave it as .claude/skills/web-unblocker/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
web-unblocker
description
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.

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:

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

Quick Start

Basic request:

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

With JavaScript rendering:

bash
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:

bash
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

bash
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.

© oxylabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/web-unblocker of oxylabs/agent-skills.

  • SKILL.md
  • examples.md

Open the folder on GitHubat commit a410198

Compare with similar skills

Web Unblocker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Web Unblocker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Web Unblocker this skilloxylabs/agent-skills875—~865Automated safety check: PassMIT
Web Scrapingplatonai/Browser41.2k—~1.1kAutomated safety check: PassApache-2.0
Chrome Devtoolseinverne/dotfiles1211 repos~1.6kAutomated safety check: NotesApache-2.0
Selenium Opinion Crawler123321kk/opinion-agent-ultimate107—~631Automated safety check: PassNone
Meowhub Browserzhaojiaqi/MeowHub111—~1.6kAutomated safety check: PassGPL-3.0
Agent Readiness Auditindranilbanerjee/digital-marketing-pro8591 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • Web Scraping

    platonai/Browser4

    Extracts data from web pages using browser automation and CSS/JavaScript selectors.

    1.2k GitHub stars~1.1k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Chrome Devtools

    einverne/dotfiles

    Browser automation, debugging, and performance analysis using Puppeteer CLI scripts.

    121 GitHub starsUsed in 1 repo~1.6k tokens
    Data & AnalyticsAuto-check: notes
  • Selenium Opinion Crawler

    123321kk/opinion-agent-ultimate

    browser-based page capture and text extraction for public-opinion research.

    107 GitHub stars~631 tokensUpdated 6 mo ago
    Data & AnalyticsAuto-check passed
  • Meowhub Browser

    zhaojiaqi/MeowHub

    Browse the web using Browserless.io cloud browser service. An agent skill from zhaojiaqi/MeowHub.

    111 GitHub stars~1.6k tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed
  • Agent Readiness Audit

    indranilbanerjee/digital-marketing-pro

    Audit whether AI agents and AI crawlers can actually use a site — robots.txt rules per AI crawler token (OpenAI, Anthropic and Perplexity bots, Google-Extended, Applebot-Extended)…

    859 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed
  • Capterra Data Extraction

    browsing-skills/browsing-skills

    Extracts software product ratings, pricing and written user reviews from Capterra pages with a real browser, since the site has no public API.

    117 GitHub stars~532 tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed

More from oxylabs/agent-skills

  • Agent Browser

    oxylabs/agent-skills

    Connects to Oxylabs remote agent browsers over the Chrome DevTools Protocol (CDP) with Playwright or Puppeteer.

    875 GitHub stars~3k tokensUpdated 8 days ago
    Auto-check passed
  • Proxies

    oxylabs/agent-skills

    Oxylabs proxy networks: Residential, Mobile, shared Datacenter/ISP, and Dedicated Datacenter/ISP proxies with geo-targeting, IP rotation, session persistence, and port-based sticky IPs.

    875 GitHub stars~1.7k tokensUpdated 8 days ago
    Auto-check passed
  • Video Data

    oxylabs/agent-skills

    YouTube data extraction API and high-bandwidth proxy downloads.

    875 GitHub stars~1.4k tokensUpdated 8 days ago
    Auto-check passed
  • Web Scraper API

    oxylabs/agent-skills

    Production-grade web scraping with automatic anti-bot bypass, structured JSON parsing for 40+ targets, and geo-targeting.

    875 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Web Unblocker

What does Web Unblocker do?

Bypasses anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript rendering, and retries automatically. Web Unblocker is an agent skill from oxylabs/agent-skills. Bypasses anti-bot protections using Oxylabs Web Unblocker, an AI-powered proxy that handles fingerprinting, JavaScript rendering, and retries automatically.

When should I use Web Unblocker?

Web Unblocker fits situations like: the user needs to scrape protected websites; bypass CAPTCHAs; access blocked content; regular proxies fail due to anti-bot measures.

How do I install Web Unblocker in Claude Code?

Run `npx skills add oxylabs/agent-skills --skill web-unblocker -a claude-code`. Or copy the skill folder (skills/web-unblocker in oxylabs/agent-skills) into .claude/skills/web-unblocker in your project. Claude Code loads it when a task matches its description.

How do I install Web Unblocker in Codex?

Run `npx skills add oxylabs/agent-skills --skill web-unblocker -a codex`. Or copy the skill folder (skills/web-unblocker in oxylabs/agent-skills) into .agents/skills/web-unblocker in your project. Codex loads it when a task matches its description.

Can I use Web Unblocker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oxylabs/agent-skills --skill web-unblocker -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/web-unblocker, .gemini/skills/web-unblocker, .github/skills/web-unblocker and .opencode/skills/web-unblocker in your project.

What does Web Unblocker need to run?

Going by SKILL.md and its folder, Web Unblocker needs the command-line tools its instructions call (curl) and credentials named OXYLABS_PASSWORD. Our summary lists: Node.js.

Does Web Unblocker access the network?

SKILL.md names 2 domains. In commands or code: unblock.oxylabs.io and ip.oxylabs.io; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Web Unblocker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Web Unblocker use?

Web Unblocker is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Web Unblocker use?

About 865 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Web Unblocker?

Skills that share tags, products or a category with Web Unblocker: Web Scraping (platonai/Browser4, 1.2k stars), Chrome Devtools (einverne/dotfiles, 121 stars), Selenium Opinion Crawler (123321kk/opinion-agent-ultimate, 107 stars) and Meowhub Browser (zhaojiaqi/MeowHub, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Web Unblocker?

oxylabs (a GitHub organization) maintains it in oxylabs/agent-skills, which has 875 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 30, 2026.

Source: oxylabs/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.