xiwan 小宇宙监控 Skill
监控播客在小宇宙的播放数据、订阅者、评论等。
Features
- 📊 单集数据（播放量、完播率、点赞、评论）
- 👥 订阅者列表
- 📈 播客基本信息
- 💬 评论获取
- 🔄 Token 自动刷新（401 时自动续期）
Quick Start
1. 获取凭据
- 打开 https://podcaster.xiaoyuzhoufm.com（主播后台）
- 登录
- F12 → Network → 随便点一下
- 找 Request Headers 里的
x-jike-access-token和x-jike-refresh-token
2. 配置凭据
保存到 ~/clawd/secrets/xiaoyuzhou.json：
{
"podcastId": "YOUR_PODCAST_ID",
"accessToken": "YOUR_ACCESS_TOKEN",
"refreshToken": "YOUR_REFRESH_TOKEN"
}
获取 Podcast ID：在小宇宙打开你的播客页面，URL 里的那串 ID 就是。
3. 使用
# 获取单集列表（含播放数据）
python3 scripts/client.py episodes --limit 10
# 获取订阅者
python3 scripts/client.py subscribers --limit 100
# 获取播客信息
python3 scripts/client.py info
# 获取单集评论
python3 scripts/client.py comments --episode-id <eid>
# 手动刷新 token
python3 scripts/client.py refresh
Commands
| Command | Description | Key Args |
|---|---|---|
episodes |
单集列表（含 stats） | --limit |
subscribers |
订阅者列表 | --skip, --limit |
info |
播客基本信息 | — |
comments |
单集评论 | --episode-id, --limit |
refresh |
手动刷新 token | — |
Token 机制
小宇宙使用与即刻相同的双 Token 机制：
| Token | 有效期 | 用途 |
|---|---|---|
| Access Token | ~1 小时 | 实际 API 调用 |
| Refresh Token | 几个月 | 换新 Access Token |
自动刷新
脚本内置 401 自动刷新逻辑：
- API 返回 401 时，自动用 Refresh Token 换新 Access Token
- 新 Token 返回在响应 Header 里
- 更新凭据文件
如果 Refresh Token 也过期了，需要重新登录主播后台获取新凭据。
API Endpoints
小宇宙有两套 API：
| API | Base URL | 用途 |
|---|---|---|
| 公开 API | https://api.xiaoyuzhoufm.com |
播客内容、评论 |
| 主播 API | https://podcaster-api.xiaoyuzhoufm.com |
订阅者、详细统计 |
主播 API 需要额外的 x-pid Header。
数据字段说明
Episode Stats
{
"playCount": 123, // 播放次数
"clapCount": 10, // 点赞数
"commentCount": 5, // 评论数
"favoriteCount": 3 // 收藏数
}
注意：完播率（finishRate）需要从主播后台导出的 Excel 获取，API 不提供。
依赖
- Python 3.8+
requests
License
MIT