aidotnet/x-report-generator

X Report Generator Tool

Description

使用Playwright浏览器自动化技术爬取X(Twitter)平台的真实数据，进行数据分析和统计，生成精美的HTML可视化报告面板，并将其渲染为高清图片。

Features

• 🔍 关键词搜索推文（真实爬取）
• 👤 用户推文分析
• 📊 数据统计分析（互动量、时间分布、情感分析等）
• 🎨 精美HTML报告面板（深色/浅色主题）
• 🖼️ HTML转高清PNG图片导出
• 🍪 支持Cookies登录状态保存

Trigger

• /x-report command
• 用户需要分析X平台数据
• 用户想生成社交媒体报告

Usage

# 首次使用：登录并保存cookies
python scripts/x_report_generator.py login --cookies cookies.json

# 搜索关键词并生成报告
python scripts/x_report_generator.py search "AI" --limit 50 --output report.png --cookies cookies.json

# 分析用户推文
python scripts/x_report_generator.py user "elonmusk" --limit 30 --output user_report.png

# 使用浅色主题
python scripts/x_report_generator.py search "Python" --theme light --output report.png

# 仅生成HTML（不转图片）
python scripts/x_report_generator.py search "coding" --html-only --output report.html

# 显示浏览器窗口（调试用）
python scripts/x_report_generator.py search "test" --no-headless --output report.png

Requirements

pip install playwright
playwright install chromium

报告内容

• 📈 推文总数、点赞、转发、评论、浏览统计
• ⏰ 24小时发布时间分布图
• 😊 情感分析（正面/中性/负面）
• 🏷️ 热门标签云
• 👥 活跃用户 TOP 5
• 🔥 热门推文展示

Tags

twitter, x, scraper, report, analytics, visualization, playwright, html-to-image

Compatibility

• Codex: ✅
• Claude Code: ✅