camoufox-tools

What This Skill Does

camoufox-tools is an essential utility set designed for OpenClaw users who require reliable, stealthy web automation and data scraping. Built upon the camoufox anti-detection browser framework, it provides a high-level abstraction layer that eliminates the friction of managing raw browser processes. Whether you are dealing with sophisticated anti-bot protections or simply need a streamlined way to extract metadata from video platforms, this skill manages the complex lifecycle of browser instances, path configuration, and resource cleanup automatically. By providing a clean CLI interface, it allows developers and agents to focus on the logic of their tasks rather than the underlying infrastructure of headless browser management.

Installation

To integrate camoufox-tools into your environment, use the OpenClaw command: clawhub install openclaw/skills/skills/adastraabyssoque/camoufox-tools. After the initial installation, ensure your environment variables are configured. The tools rely on a local instance of the camoufox browser; you may point the environment variable CAMOUFOX_PATH to your specific binary location if the default discovery fails. Finally, run the provided ./install.sh script to append the binary folder to your shell PATH, allowing you to trigger commands like fox-scrape and fox-eval from anywhere in your workspace.

Use Cases

This skill is perfect for automated research, content monitoring, and data auditing. Common use cases include:

• Automated Scraping: Extracting structured data from modern, JavaScript-heavy websites that typically block automated crawlers.
• Bilibili Analytics: Providing a one-command solution to retrieve detailed engagement metrics (likes, shares, views) for video content analysis.
• Automated Interaction: Using fox-eval to perform DOM-level operations on active web sessions, such as retrieving authentication tokens or parsing complex data grids.
• Headless Monitoring: Quickly spinning up browser sessions to verify page elements without the overhead of manual interaction.

Example Prompts

1. "Open the Bilibili video BV1NGZtBwELa using camoufox-tools and extract the total playback count and number of comments for me."
2. "Use fox-scrape to capture the latest news headline from https://news.example.com using the selector .headline-title, and wait 3 seconds for it to load."
3. "Open the dashboard at https://internal.dev and use fox-eval to get the current document cookie length, then close the browser safely."

Tips & Limitations

To ensure optimal performance, always call fox-close after completing your scraping or evaluation tasks to prevent memory leaks associated with orphaned browser processes. If you encounter "Selector not found" errors, it is usually because the dynamic content of the page has not fully rendered; increase your --wait parameter in fox-scrape to allow for slower network conditions. Note that while camoufox is highly effective at mimicking human browser behavior, excessive request rates may still trigger platform-specific rate limiting. Always verify your specific use case against the target website's Terms of Service and robots.txt guidelines.