browser-relay

What This Skill Does

The browser-relay skill provides a secure, local-first bridge to control your Chromium browser via a lightweight HTTP relay. By routing automation commands through your own local IP, this skill effectively bypasses common data-center IP bans often encountered when scraping or interacting with modern social platforms like Xiaohongshu. It bridges the gap between your AI agent and a local browser instance (via Chrome DevTools Protocol), allowing for sophisticated UI interactions, DOM navigation, and screenshot capturing. It ensures safety by binding solely to localhost and enforcing strict authorization headers for all commands.

Installation

To install this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/esojourn/browser-relay-xiaohongshu Ensure you have Chromium installed on your system and sufficient permissions to execute shell scripts and start local server processes. The skill automatically manages its authentication tokens in /tmp/browser-relay-token.

Use Cases

• Anti-Ban Scraping: Safely browse and extract data from websites that block cloud-based IP ranges.
• UI Automation: Automate repetitive manual tasks like form submissions, multi-step navigation, or status checks on websites that require a human-like session.
• Visual Monitoring: Capture screenshots of a rendered page and send them to your Telegram account to monitor dynamic content changes or alert triggers.
• Localized Testing: Perform web interactions as if you were sitting at your machine, utilizing your local session cookies and network environment.

Example Prompts

1. "Open Xiaohongshu in the browser and search for 'travel tips in Japan', then take a screenshot of the first page of results."
2. "Check if my local browser is running on port 9222 and navigate to the dashboard at example.com."
3. "Wait for the page to load the feed, extract the text content of the trending titles, and send me a screenshot of the interface via Telegram."

Tips & Limitations

• Isolation: Always use a dedicated browser profile for automation to keep your personal data secure.
• Security: Never share your session tokens or allow untrusted external requests to access port 18792.
• Performance: Since this controls a physical browser instance, avoid running too many parallel tasks that could impact system performance.
• Sensitivity: The /evaluate endpoint is powerful; avoid using it to access sensitive credentials like passwords or tokens, adhering strictly to the skill's data privacy constraints.