x-report-generator_skill

Overview

This skill automates the collection and analysis of real X (Twitter) data using a Playwright browser, then builds a polished HTML dashboard and exports it as a high-resolution image. It supports keyword searches, user timeline analysis, engagement and time-distribution stats, sentiment breakdowns, tag clouds, and exportable reports in dark or light themes. Cookie-based login persists sessions for authenticated data access.

How this skill works

The tool drives a headless or visible Chromium instance via Playwright to fetch live posts and metadata from X. It aggregates metrics (likes, reposts, replies, impressions when available), runs basic sentiment analysis and time-series grouping, renders an HTML visualization panel, and converts that panel into a PNG image. Optional flags control limits, themes, headless mode, and whether to output raw HTML instead of an image.

When to use it

• When you need a quick social listening snapshot for a keyword or hashtag on X
• When preparing client-ready visuals summarizing X engagement and trends
• When auditing a specific user account’s posting behavior and interactions
• When you want printable or shareable high-resolution report images
• When collecting real-world sample posts for research or competitive analysis

Best practices

• Save and reuse authenticated cookies to avoid repeated logins and rate issues
• Start with a reasonable result limit (e.g., 50–200) to balance completeness and speed
• Use headful mode for debugging visual scraping issues, then switch to headless for production
• Respect platform terms and throttling: add delays or lower concurrency to reduce detection
• Validate sentiment outputs on a sample set; tune or replace the analyzer if needed

Example use cases

• Generate a weekly keyword report for a marketing campaign and export a PNG for slide decks
• Analyze a competitor’s last 30 posts to surface peak posting times and most engaging content
• Produce a sentiment and tag-cloud summary before a product launch to inform messaging
• Export an HTML snapshot for archival purposes and create a high-resolution image for social sharing
• Run ad-hoc investigations into trending posts and save the visual dashboard for team review