aluvia-web-unblock

What This Skill Does

The Aluvia Web Unblock skill is a specialized agent tool designed to circumvent common web-scraping obstacles, such as CAPTCHAs, IP-based blocking, and 403 Forbidden errors. By leveraging Aluvia mobile proxies, this skill allows your OpenClaw agent to access high-security websites and perform content extraction without the overhead of heavy headless browser automation. It serves as a bridge between the agent and the live internet, ensuring that data retrieval remains stable even when target domains are actively filtering datacenter traffic. The skill combines Brave Search capabilities with robust proxy routing, effectively making your agent appear as a legitimate mobile user to web servers.

Installation

To integrate this skill into your environment, use the command line to pull the package from the OpenClaw repository. First, ensure you are in your projects directory. Execute: clawhub install openclaw/skills/skills/bertxtrella/aluvia-web-unblock. Once the installation is complete, navigate to the newly created directory and run npm ci to install all necessary dependencies. Configuration requires setting two mandatory environment variables: ALUVIA_API_KEY for proxy authentication and BRAVE_API_KEY for search functionality. Optionally, you can define an ALUVIA_CONNECTION_ID if you wish to persist your proxy sessions for faster response times across multiple requests.

Use Cases

This skill is ideal for researchers, data analysts, and automated agents that need to retrieve information from websites that aggressively block automated traffic. It is particularly effective for parsing news sites, public records, and complex portals that trigger anti-bot challenges. If you find your agent is repeatedly failing to access data or receiving 403 errors, this skill is the optimal solution for restoring connectivity.

Example Prompts

1. "Perform a search for the latest quarterly earnings reports for Tesla using the Aluvia proxy and extract the key takeaways into Markdown format."
2. "Access this specific URL https://example-protected-site.com/data and fetch the content, bypassing any CAPTCHA challenges that might appear."
3. "Search for current market trends regarding renewable energy and compile the content from the top five search results into a summary report."

Tips & Limitations

While this skill is powerful, it is designed for web retrieval rather than interaction-heavy tasks like clicking buttons or filling out forms. Because it uses mobile proxies, ensure you are mindful of your Aluvia usage limits. For best results, reuse connection IDs when performing consecutive fetches to maintain session stability. Avoid using this skill for unauthorized scraping of private or sensitive user data to maintain ethical compliance with web standards.