# 小宇宙播客数据助手 (Xiaoyuzhou Podcast Assistant)
### —— 专业的“小宇宙播客统计”与“小宇宙数据统计”自动化利器

本项目专为小宇宙 (XiaoYuzhou) 创作者打造，旨在解决后台数据分散、无法自动留存历史、难以直观查看增长的问题。通过自动化脚本，一站式完成**小宇宙数据统计**与**增量复盘**。

---

## 🌟 核心功能

### 1. 全维度播客数据自动抓取
一键获取创作者后台核心指标。比如官方提供的 Excel **单集明细** 和 **“订阅总数”** 和 **“单集完播率”** 等关键数据。

> **生成报表示例（原始数据总表）：**
> ![小宇宙播客数据统计-原始详单](images/daily.png)
> *（自动记录：标题、发布日期、播放量、完播率、评论、分享、收藏、点赞等维度）*

### 2. 自动化每日增量统计分析
这是本助手的核心灵魂。系统会自动对比“今日”与“昨日”的抓取结果，计算出 **7 个维度** 的每日净增值（如新增播放、新增订阅、点赞变化等），让你的播客增长趋势一目了然。

> **增量分析示例（每日增长差异表）：**
> ![小宇宙数据统计-每日增量对比](images/compared.png)
> *（直观展示：各单集今日新增了多少播放、完播率波动、互动增长等数据）*

### 3. 长效历史数据归档
系统会自动将每日数据重命名（如：`播客名_251221.xlsx`）并分类存放。
- **daily_raw/**：存放每日下载的原始数据。
- **compared_results/**：存放系统自动生成的每日对比结果。
- **subscription_stats.xlsx**：存放订阅数与完播率的长期历史记录。

### 4. 表格工具完美兼容
生成的 Excel 报表格式经过专门优化，你可以直接全选、复制，并粘贴到 **飞书多维表格**、**Notion** 或 **Airtable** 中，完成个人播客数据库的建立。

---

## 🛠️ 技术亮点

- **小宇宙数据统计安全性**：完全模拟真实用户浏览器行为，复用本地环境。不进行高频、暴力的 API 请求，最大限度保障创作者账号的安全。
- **持久化登录状态**：内置状态保持逻辑。用户仅需在首次运行时**扫码登录一次**，后续运行即可利用本地 Cookie 自动跳过登录，实现真正的自动化。

---

## 📅 使用场景

1. **创作者每日复盘**：每天固定时间运行，快速查看 24 小时内的涨粉与播放变化，即时反馈节目表现。
2. **播客数据分析报告**：利用生成的增量表，轻松回溯订阅数的变化曲线，找出拉新爆发的“关键单集”。
3. **团队周报制作**：直接使用系统导出的对比结果，不再需要手动在 Excel 里拉公式计算增长。

---

## 🚀 快速开始

### 1. 环境准备
- 确保你的 Mac 已安装 **Python 3.8+**。
- 安装依赖：`pip install -r requirements.txt`
- 首次运行会通过 `webdriver-manager` 自动下载与本机 Chrome 匹配的 `chromedriver`；也可手动将对应版本放入项目根目录（本地文件优先）。

### 2. 配置说明
将 `config.example.json` 重命名为 `config.json`，并填入你的 `podcast_id` 和 `podcast_name`。

### 3. 运行统计
```bash
python3 main.py run
```

首次运行时，自动化浏览器窗口会弹出并要求扫码登录；登录态保存在项目目录的 `browser_profile/` 中（已在 `.gitignore` 忽略），之后运行无需重复扫码。

---

## 📝 更新记录

详见 [CHANGELOG.md](CHANGELOG.md)。

## ⚠️ 免责声明
本项目仅供播客创作者进行**个人播客数据统计**学习交流使用，请勿用于大规模数据爬取或商业用途。使用请遵守相关法律法规。