biliradarlisted

# BiliRadar — B 站曲目数据雷达 追踪指定 B 站视频的核心指标时序，识别"进推荐流"、"起步慢"、"优质曲"三类信号，为 Vocaloid / 独立音乐 / MCN 内容运营场景设计。 ## 何时使用 - 用户提供 bvid 或视频链接，说"跟踪一下""开始监控这个" - 用户说"看看那首曲怎么样了""生成数据看板" - 用户说"检查异常""哪首曲进推荐流了""哪首起步慢了" - 由 scheduled task 自动触发（每 5-10 分钟采集一次） ## 优先执行方式 **PowerShell（用户本机 IP，B 站接受度高）**： ```powershell Set-Location "C:\Users\何\Documents\Claude\Projects\MCN创业\biliradar" .\run.ps1 <command> <args> ``` `run.ps1` 自动处理 UTF-8 编码 + 依赖安装 + `py` 启动器。 ## 常用命令 ```powershell .\run.ps1 add BV1FDNJ6BE4j # 添加追踪 .\run.ps1 add https://www.bilibili.com/video/BVxxx --note "本家新曲" .\run.ps1 list # 列出所有追踪曲目 .\run.ps1 info BV1FDNJ6BE4j # 单曲详情（含 1h/24h 增量、派生指标） .\run.ps1 collect # 采集所有 active 曲目最新数据 .\run.ps1 dashboard # 生成 HTML 看板（data/dashboard.html） .\run.ps1 alerts # 检查异常（起步慢/暴涨/优质曲） .\run.ps1 remove BV1FDNJ6BE4j # 停止追踪（保留历史） .\run.ps1 remove BV1FDNJ6BE4j --purge # 彻底删除 ``` ## 关键行为规则 1. **热窗默认 7 天**：曲目发布 7 天后自动跳过采集（Vocaloid 场景 90% 数据在前 7 天） 2. **数据存 SQLite**：`data/metrics.db`，时序表结构 `(bvid, collected_at)` 主键 3. **只用公共接口**：`/x/web-interface/view` 无需 wbi 签名、无需登录，纯读、无封号风险 4. **采集频率建议**：定时任务每 5-10 分钟一次；单次同步采完所有 active 曲目 ## 输出解析（给 Claude 参考） ### collect 输出 ``` BV1FDNJ6BE4j view=6.5w like=1.4w coin=3.5k fav=8.6k ``` ### alerts 输出（三种 level） - `[HOT] ... 🔥 播放暴涨` — 立即通知用户，建议追加互推/联动 - `[WARN] ... ⚠️ 起步慢` — 需要人工判断要不要补量 - `[GOOD] ... ✨ 优质曲` — 三连率高，值得加大宣发 有 alerts 时向用户播报 ma