agent-browser-stealth

What This Skill Does

agent-browser-stealth is an advanced automation wrapper for Playwright designed specifically to bypass sophisticated bot-detection mechanisms on the modern web. Unlike standard headless browsers that broadcast automation signals, this skill actively modifies the browser environment to appear as a human-operated user session. It achieves this by stripping out 'navigator.webdriver' flags, injecting randomized noise into Canvas and WebGL rendering buffers to evade fingerprinting, and masking internal Chrome runtime variables. The architecture uses a CDP (Chrome DevTools Protocol) wrapper to ensure that the browser instance reports a clean environment to external security services like Cloudflare or Akamai. By providing a ref-based interaction system (e.g., e1, e2), it allows users to perform complex workflows like logins, form filling, and scraping without the instability typically associated with conventional automation scripts.

Installation

To use this skill, ensure your environment has Node.js installed. Run the following command in your terminal:

npm install -g playwright npx playwright install chromium

This will provision the necessary Chromium binary. The skill is designed to run as a standalone process through the OpenClaw agent, utilizing the 'stealth-launch.js' script to orchestrate the browser lifecycle. No additional plugins are required, as the core stealth logic is embedded within the skill's local repository structure.

Use Cases

This skill is ideal for tasks requiring reliable interactions with protected web assets. Primary use cases include: automated login and session maintenance for persistent services, data extraction from sites with aggressive anti-scraping policies, testing web applications in a production-like environment, and performing background verification tasks on platforms that detect standard bot traffic.

Example Prompts

1. "Stealth browser: Open https://secure-portal.com and login using my saved credentials, then extract the dashboard data to a JSON file."
2. "Use anti-detection tools to navigate to the research site, snapshot the elements, and click on the 'Export CSV' button ref."
3. "Start a new stealth login session for the analytics platform and keep the session active so I can verify the bypass status."

Tips & Limitations

To maximize the success rate of this skill, prioritize headless-mode settings that align with your anti-detection requirements; note that while 'headless' is useful, some sophisticated sites require 'headful' mode with specific viewport settings. Always use the provided snapshot functionality to identify element references reliably, as selectors may change dynamically. Be aware that over-automation of a single endpoint can still lead to IP-based rate limiting, even if the browser fingerprint is clean. Combine this tool with rotating proxies for high-volume tasks to avoid detection at the network level.