SkillAgentSearch skills...

web-unblocker

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

Install / Use

npx skills add oxylabs/agent-skills --skill web-unblocker

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Category

Automation

Supported Platforms

Universal

Tags

Our assessment of web-unblocker

web-unblocker scores 88/100 on our quality scale, 1569th of 2,790 Automation skills we index.

Its SKILL.md is 3.4 KB long, well organised into 9 sections with 6 code examples: a solid amount of guidance for an agent.

It has 875 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so web-unblocker is actively maintained.
  • Our last check on 2026-11-01 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

Review

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: The skill repeatedly instructs the agent to use `curl -k` / disable SSL verification for all requests, weakening TLS safeguards.

AI review: risky

  • The skill repeatedly instructs the agent to use `curl -k` / disable SSL verification for all requests, weakening TLS safeguards.
  • It directs the agent to route traffic through a third-party TLS-terminating proxy (`unblock.oxylabs.io:60000`) that can inspect and modify request/response content.
  • It explicitly tells the agent to bypass anti-bot protections and CAPTCHAs, which can facilitate scraping that violates target sites' terms of service.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

web-unblocker compared with similar skills

All 4 of these similar skills score higher than web-unblocker; compare them before choosing.

SkillScoreStarsUpdatedFormat
web-unblocker (this skill)by oxylabs8887559d agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server

Frequently asked questions

How do I install web-unblocker?
Run npx skills add oxylabs/agent-skills --skill web-unblocker. The install tabs above show the steps for each supported agent.
Which AI agents does web-unblocker work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is web-unblocker safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: The skill repeatedly instructs the agent to use curl -k / disable SSL verification for all requests, weakening TLS safeguards. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is web-unblocker still maintained?
The repository was last updated about 2 months ago, so web-unblocker is actively maintained.

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:

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 raw PNG bytes; empty value disables automatic forced rendering | | X-Oxylabs-Session-Id | Reuse same IP across requests (any random string) | | X-Oxylabs-Geo-Location | Target country, city/state, ZIP/postcode, or coordinates | | x-oxylabs-force-headers: 1 | Enable custom header passthrough | | x-oxylabs-force-cookies: 1 | Enable custom cookie passthrough | | X-Oxylabs-Successful-Status-Codes | Define custom success codes to prevent retries | | x-oxylabs-browser-instructions | JSON-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

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

Related Skills

View on GitHub
GitHub Stars875
CategoryAutomation
Updated1mo ago
Forks2

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
web-unblocker — Universal Skill: Install & Safety Check | SkillAgent