home / skills / openclaw / skills / aluvia-web-unblock

aluvia-web-unblock skill

needs review

This skill unblocks web access by routing through Aluvia mobile proxies to search and fetch content from blocked sites without browser automation.

npx playbooks add skill openclaw/skills --skill aluvia-web-unblock

Review the files below or copy the command above to add this skill to your agents.

Files (6)

SKILL.md

1.6 KB

---
name: aluvia-web-unblock
description: Unblock websites and bypass CAPTCHAs and 403 errors using Aluvia mobile proxies. Enables web search and content extraction without browser automation.
---

# Aluvia Web Unblock

Provides unblockable web access for agents using Aluvia mobile proxies.
Use this skill to search the web or fetch page content from sites that block bots, scrapers, or datacenter IPs.

## Capabilities

- Web search with unblockable access
- Fetch and extract page content as Markdown
- Bypass CAPTCHAs and anti-bot challenges
- Avoid 403 and IP-based blocking
- Route requests through Aluvia mobile IPs
- Reuse proxy connections

## Requirements

- Aluvia API key
- Brave Search API key
- Optional Aluvia connection ID for connection reuse

## Setup

```bash
cd ~/Projects/agent-scripts/skills/aluvia-web-unblock
npm ci
```

```bash
export ALUVIA_API_KEY=your_aluvia_key
export BRAVE_API_KEY=your_brave_key
```

Optional:

```bash
export ALUVIA_CONNECTION_ID=your_connection_id
```

## Usage

### Web Search

```bash
./search.js "query"
./search.js "query" -n 10
./search.js "query" --content
```

### Fetch Page Content

```bash
./content.js https://example.com/article
```

## Output

Returns structured search results and extracted page content in Markdown format.

## Use Cases

- Agents blocked by CAPTCHAs or 403 errors
- Web retrieval without headless browsers
- Scraping sites that block cloud IPs
- Search + fetch workflows requiring stable IPs

## Keywords

unblock, bypass captcha, 403 errors, website block, mobile proxy, web scraping, agent retrieval, anti-bot

Overview

This skill provides unblockable web access for agents by routing requests through Aluvia mobile proxies. It enables web search and page content extraction without relying on headless browsers, and it handles CAPTCHAs, anti-bot challenges, and 403/IP-based blocking. The skill returns structured search results and extracted content in Markdown for easy downstream consumption.

How this skill works

Requests are proxied through Aluvia mobile IPs to appear as legitimate mobile traffic and avoid datacenter blocks. The skill integrates with Brave Search for query results and can fetch page content, extracting it to Markdown while reusing proxy connections when an Aluvia connection ID is provided. Anti-bot challenges and CAPTCHAs are handled by the proxy layer so agents can operate without browser automation.

When to use it

When agents are blocked by CAPTCHAs or receiving 403 responses from target sites
To perform web search where cloud or datacenter IPs are rate-limited or blocked
When you need to fetch and extract page content without running headless browsers
For scraping sites that enforce aggressive anti-bot measures
When stable, reusable mobile IP connections reduce request failures

Best practices

Provide valid ALUVIA_API_KEY and BRAVE_API_KEY as environment variables
Use an ALUVIA_CONNECTION_ID to reuse proxy connections and reduce setup latency
Respect target site terms of service and robots.txt when scraping
Limit request rates and back off on errors to avoid triggering blocks
Extract only required content fields to minimize processing and bandwidth

Example use cases

Agent performs Brave Search queries via the skill to gather sources that reject datacenter traffic
Fetch and convert a news article to Markdown when the site blocks automated browsers
Automated data-collection pipeline that needs reliable mobile-IP routing to avoid CAPTCHAs
Fallback layer for web retrieval in multi-agent systems when standard proxies fail
Combine search + fetch to resolve citations from hard-to-access websites

FAQ

What credentials are required to run this skill?

You must provide ALUVIA_API_KEY and BRAVE_API_KEY; an optional ALUVIA_CONNECTION_ID enables connection reuse.

Do I need a headless browser to extract page content?

No. The skill extracts content server-side and returns Markdown without browser automation.