Puppeteer

What This Skill Does

The Puppeteer skill provides OpenClaw agents with the capability to drive Chrome and Chromium browsers programmatically. It allows for advanced browser automation, enabling the agent to simulate human interactions, perform complex web scraping, and execute automated quality assurance workflows. By leveraging the industry-standard Puppeteer library, the agent can navigate websites, interact with dynamic elements, capture visual documentation, and export data in various formats like PDF or structured JSON.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/ivangdavila/puppeteer Ensure you have reviewed the setup.md file located in the skill directory after installation to configure necessary dependencies and environment-specific parameters.

Use Cases

• E2E Testing: Automate repetitive UI testing flows to ensure application stability.
• Web Scraping: Extract data from dynamic single-page applications (SPAs) that require JavaScript execution to render content.
• Visual Regression: Take full-page screenshots or PDF exports for documentation and reporting.
• Workflow Automation: Automate tedious login processes, form submissions, or periodic site checks.

Example Prompts

1. "Navigate to example.com, fill out the login form using my credentials in the memory store, and take a screenshot of the dashboard once logged in."
2. "Scrape all product titles and prices from the search results page at [url] and save the output as a JSON file in the ~/puppeteer/output/ folder."
3. "Visit the documentation site and generate a PDF of the 'Getting Started' guide, ensuring the viewport is set to 1920x1080 for desktop consistency."

Tips & Limitations

• Wait Strategy: Always utilize page.waitForSelector to ensure elements are present before interaction. Failing to do so is the most common cause of script failure.
• Stability: Prioritize the use of data-testid attributes for selectors over CSS classes to prevent script breakage during frontend updates.
• Resource Management: The skill creates local processes; always use try/finally blocks to ensure the browser instance closes, preventing memory leaks.
• Rate Limiting: Incorporate random delays to simulate human behavior and avoid triggering anti-bot mechanisms or IP bans.