supalytics

What This Skill Does

The Supalytics skill enables your OpenClaw agent to interface directly with the Supalytics CLI, providing deep visibility into your website's performance. By leveraging this tool, the agent can fetch real-time visitor counts, detailed pageview metrics, geographic breakdowns, and revenue attribution data. It acts as an analytical engine that processes raw data from your web properties into human-readable insights. Whether you are tracking the success of a marketing campaign or troubleshooting a drop in traffic, this skill provides the necessary command-line interface to pull metrics on-demand without needing to navigate to external dashboards.

Installation

To integrate this skill into your OpenClaw environment, use the OpenClaw hub command: clawhub install openclaw/skills/skills/yogesharc/supalytics

Ensure that you have the Bun runtime installed on your host system, as the Supalytics CLI is built on Bun. After installation, execute supalytics login within your terminal to initiate the OAuth handshake. Remember to use the background: true configuration within your OpenClaw execution scripts to handle the browser-based OAuth flow effectively.

Use Cases

• Traffic Analysis: Monitor pageviews, unique visitors, and sessions over custom timeframes (last 7 days, today, or custom ranges).
• Revenue Tracking: Perform deep dives into conversion funnels and attribute revenue to specific pages or UTM campaigns.
• Geographic Insights: Identify top countries driving traffic to understand global reach.
• Real-time Monitoring: Watch traffic spikes live with the --watch flag, ideal for tracking the immediate impact of a new product launch or a social media post.
• Event Tracking: Query custom event properties to understand how users interact with your application features.

Example Prompts

1. "Check the traffic for our blog over the last 7 days and show me which pages have the highest revenue."
2. "How many active users are currently on our site, and where are they from?"
3. "Run a breakdown of visitors by country and device type for the last month."

Tips & Limitations

• Authentication: OAuth sessions require user interaction. Always provide the agent with the verification URL in the chat if login is prompted.
• Complexity: While simple stats are easy to fetch, complex cross-referenced queries (using -d and -m flags) work best with specific time ranges to avoid long execution times.
• Performance: The CLI relies on external network requests; ensure your environment allows connections to the Supalytics API. Use the --compact flag for quick check-ins during high-volume periods.