browser-ability

What This Skill Does

The Browser Ability skill is a robust toolkit for the OpenClaw AI agent, allowing it to interact with websites through the Chrome DevTools Protocol (CDP). It bridges the gap between automated scripts and manual user authentication, enabling the agent to scrape data, navigate complex web structures, and perform actions that typically require a user session. Unlike traditional scrapers, this skill features a sophisticated human-in-the-loop workflow: when a target website requires a login (such as banking portals or e-commerce accounts), the skill halts, generates a secure sign-in URL, and provides a unique signin_id. This ensures security by requiring the user to authenticate manually, after which the agent resumes its task with the established session context.

Installation

To integrate this skill, navigate to your OpenClaw project directory and use the installation command:

clawhub install openclaw/skills/skills/faisalive/browser-ability

Once installed, ensure you have the necessary dependencies by running npm install within the skills/browser-ability directory. Finally, configure your environment variable to point to your browser's CDP endpoint to enable communication: export CDP_URL="http://[ipv6]:port".

Use Cases

This skill is ideal for tasks requiring dynamic interaction or authenticated access. Use it to:

• Aggregate purchase history from e-commerce platforms like Amazon.
• Monitor account-based platforms where public scrapers are blocked by authentication walls.
• Retrieve structured data from modern JS-rendered websites that cannot be parsed by simple HTTP requests.
• Automate repetitive web tasks that require personal account context.

Example Prompts

1. "OpenClaw, please log in to my Amazon account using the browser-ability skill and fetch my purchase history for the last 3 months."
2. "I need to scrape data from my banking dashboard; use the browser skill to navigate to the transactions page and extract the data into a JSON file."
3. "Run a search on this restricted industry portal and retrieve the latest market reports using the browser-ability tool."

Tips & Limitations

• Manual Auth: Never attempt to automate the entry of passwords into browser fields; the skill is designed to delegate this to you for security reasons.
• CDP Stability: Ensure your CDP-enabled browser is running with --remote-debugging-port before triggering tool calls.
• Session Management: Always check the status of your signin_id using the check_signin tool to confirm successful authentication before attempting data retrieval.
• Complexity: This skill is powerful but requires that you keep the browser window open and visible while the agent is waiting for sign-in completion.