playlet-bili-feed

name	playlet-bili-feed
description	B站短剧爆款内容追踪工具，每日自动扫描B站短剧创作内容，按点赞量筛选爆款作品，智能聚类题材后生成可视化HTML日报与创作趋势分析。当用户需要查询B站短剧爆款日报、分析短剧题材趋势、查看热门达人表现或生成短剧创作趋势报告时使用。

短剧-B站信息源

简介

B站短剧爆款内容追踪工具，每日自动扫描B站短剧创作内容，按点赞量筛选爆款作品，智能聚类题材后生成可视化HTML日报与创作趋势分析。

通过数据驱动的方式，帮助短剧创作者、MCN机构和内容运营人员精准把握B站短剧流量风口。

你可以：

• 📊 每日获取B站短剧爆款榜单
• 🏷️ 自动识别热门题材方向（穿越/霸总/重生/悬疑等）
• 📈 深度分析爆款标题特征与达人表现
• 📄 一键生成深色主题HTML可视化日报

适用于短剧创作者、MCN机构、内容运营人员等需要追踪B站短剧趋势的场景。

重要：数据每日15:00更新前一天数据，目标日期无数据时禁止自动调用接口，必须先告知用户并等待确认。

功能特性

🎯 核心功能

功能模块	能力描述	核心价值
爆款发现	从B站短剧中按点赞量筛选热门内容	精准定位高热度短剧作品
题材聚类	自动识别题材方向（穿越/霸总/重生/悬疑等）	每天题材分类由内容动态决定
智能查询	默认查询全部短剧，数据不足时自动扩展题材批量查询	节省接口额度，高效获取数据
自定义查询	用户可指定任意题材/达人/关键词定向查询	灵活覆盖任意短剧细分方向
创作洞察	分析爆款标题特征、题材趋势、达人表现	深度挖掘创作规律
可视化日报	深色主题HTML，封面图+互动数据+作品直链	直观展示每日短剧热点
一键订阅	--subscribe 开启每日自动产出	日报自动攒在本地文件夹

✨ 特色亮点

• ⚡ 智能日期判断：内置15:00更新规则，自动拦截无效查询，避免浪费API额度
• 🎨 B站风格日报：深色主题 + B站蓝（#00A1D6），封面图懒加载，BV号直链跳转
• 📊 零值隐藏：互动指标为0时自动隐藏，日报信息更清爽
• 🔄 批量查询：所有题材通过一次批量接口获取，高效省额度

一键安装

前置条件

• Python 3 运行环境
• 已注册红狐Hub账号并获取 API Key

API Key 获取

前往 红狐Hub 官网 注册，登录后在个人中心获取，格式为 ak_xxxxxxxx。新注册用户获赠免费积分。

环境变量配置

数据查询接口通过请求头 X-API-KEY 鉴权，Key 从环境变量 REDFOX_API_KEY 获取。

变量名	必填	说明
REDFOX_API_KEY	是	红狐Hub API 访问密钥，格式 ak_xxxxxxxx

配置方式：

• macOS/Linux：将 export REDFOX_API_KEY=<值> 追加到 ~/.zshrc 或 ~/.bashrc，然后 source 使其生效
• Windows：[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")（需重启终端）
• 配置后验证：echo $REDFOX_API_KEY（macOS/Linux）或 echo %REDFOX_API_KEY%（Windows）

接口调用时通过 source 字段（值为 短剧B站信息源-GitHub）同步记录来源，无需额外请求保存接口。

使用指南

详细执行流程、字段映射、HTML规则、指标展示规则见 core_workflow.md

基础使用

1. 日期预检（每次查询前自动执行）

⛔ 核心规则：未经用户确认，禁止调用任何数据接口。

• 15:00前：最新可用日期 = T-2（前天）
• 15:00后：最新可用日期 = T-1（昨天）
• 目标日期无数据时，必须提示用户并等待确认后才能执行

2. 生成爆款日报

用户：查一下最新的B站短剧日报

助手：检查日期可用性 → 执行脚本生成日报 → 输出趋势分析

# 生成最新一期日报（用户确认后）
python3 "$SKILL_PATH/assets/daily_report.py" --latest

# 生成指定日期日报（历史日期已有数据，无需确认）
python3 "$SKILL_PATH/assets/daily_report.py" --date 2026-06-10

查询策略：默认查询全部短剧（pageSize=200），数据不足时自动追加热门题材（穿越→霸总→重生→悬疑→甜宠→逆袭），批量接口一次性查询。

3. 创作趋势分析

日报生成后，必须基于聚类结果自动执行创作趋势分析：

1. 读取题材聚类结果，选取 TOP 5 热门题材
2. 分析每个题材的爆款数量、平均互动数据、头部作品特征
3. 识别新兴起量题材（数量少但互动高）
4. 输出结构化创作趋势报告（格式见下方输出模板）

高级使用

自定义题材查询

用户可指定任意题材组合进行定向查询与分析：

# 查询穿越题材热门短剧
python3 "$SKILL_PATH/assets/daily_report.py" --topics "穿越,时空,重生"

# 查询霸总/甜宠题材
python3 "$SKILL_PATH/assets/daily_report.py" --topics "霸总,甜宠,总裁,虐恋"

# 查询悬疑/反转题材
python3 "$SKILL_PATH/assets/daily_report.py" --topics "悬疑,推理,反转,惊悚"

自定义查询逻辑：

• 用户提供的所有题材通过批量接口一次性查询，无需逐个调用
• 查询结果自动去重，题材聚类、趋势分析均基于查询结果生成

输出格式（强制执行）

⛔ 严格执行规则：

• 以下模板是唯一合法输出格式，禁止任何自由发挥、省略、简化或重新组织
• 禁止输出模板中未定义的额外内容（如"我来帮你…""以下是…"等口语化文字）
• 禁止合并、跳过任何板块，即使某板块数据为"暂无"也必须保留该板块标题
• 日报生成后，对话回复只能包含以下内容，不得包含其他任何文字

每次运行日报后，对话输出必须严格按以下模板原样输出（仅替换 {...} 占位符）：

## 短剧-B站信息源 · {日期} 日报

**扫描 {N} 部热门短剧，聚类 {M} 个题材方向**

---

### 题材概览

| 题材 | 数量 | 占比 | 爆款亮点 |
|------|------|------|---------|
| #{题材名} | {N}部 | {X}% | 头部作品亮点描述 |
| ... | ... | ... | ... |

---

### 创作趋势分析

**一、新兴起量信号**

- 🔥 **#{题材}** — 仅{N}部但均互动{X}+，描述
（若无新兴题材，输出：暂无新兴起量信号）

**二、爆款标题特征**

| 特征模式 | 出现次数 | 典型案例 | 平均互动 |
|---------|---------|---------|---------|
| {特征1} | {N}次 | 《{标题}》 | {X}w |
| ... | ... | ... | ... |
（若无标题数据，输出：暂无爆款标题数据）

**三、核心达人榜**

| 达人 | 作品数 | 总赞 | 代表作 |
|------|--------|------|--------|
| @{达人} | {N}部 | {X}w | 《{作品}》 |
| ... | ... | ... | ... |
（若无达人数据，输出：暂无核心达人数据）

**四、题材趋势报告**

**题材**：#{题材1}
**作品数**：{N}部
**平均点赞**：{X}w
**头部作品**：《{标题}》-{点赞}w

**题材特征**：{描述该题材的共性特征}
**创作建议**：{针对该题材的创作建议}

**五、#{题材2}**

（同上格式）

**六、#{题材3}**

（同上格式）

**七、跨题材对比建议**

- **{题材}** — 建议同步关注{相关题材}的联动创作，观察题材融合趋势
（若无建议，输出：暂无跨题材对比建议）

---

**日报地址**：{HTML文件绝对路径}

> 数据说明：每日15:00更新昨天的数据

以上格式为强制规范，所有字段不可省略，板块标题（一、二、三、四、五、六、七）必须保留。若某模块无数据则在该板块内标注"暂无"，不得删除板块本身。

命令速查

命令/参数	功能	默认值
--latest	自动使用最新有数据的日期，跳过无数据区间	—
--date YYYY-MM-DD	指定日期查询（历史数据已有，无需确认）	今天
--topics "关键词,..."	自定义题材查询，逗号分隔	短剧
--count N	扫描作品数量，满足即停	200
--start-time	自定义开始时间 YYYY-MM-DD HH:MM:SS	—
--end-time	自定义结束时间 YYYY-MM-DD HH:MM:SS	—
--output-dir	输出目录	~/Downloads/QoderReports
--api-key	指定 API Key（覆盖环境变量）	—
--subscribe	开启每日订阅	—
--unsubscribe	关闭每日订阅	—
--from-cache	使用缓存数据	—

使用场景

场景一：短剧创作者选题参考

角色：短剧编剧/导演

需求：了解当前B站短剧热门题材和爆款趋势，指导创作方向

使用方式：

1. 每日查看短剧日报，关注题材聚类分布
2. 分析爆款标题特征和互动数据
3. 针对新兴起量题材提前布局内容

预期收益：精准把握流量风口，提升作品曝光概率

---

场景二：MCN 机构内容运营

角色：MCN 运营人员

需求：追踪旗下达人的短剧内容表现，优化运营策略

使用方式：

1. 订阅每日日报，持续追踪B站短剧赛道
2. 通过核心达人榜了解竞品表现
3. 使用自定义题材查询定向分析关注领域

预期收益：提升内容运营效率，及时发现潜力达人

---

场景三：品牌方/制作方竞品监测

角色：短剧制作公司

需求：监测竞品短剧在B站的表现数据

使用方式：

1. 定期查询目标题材日报
2. 分析竞品爆款作品的标题特征和互动规律
3. 结合跨题材对比建议探索融合创作

预期收益：数据驱动内容投资决策，降低试错成本

项目架构

目录结构

短剧-B站信息源/
├── SKILL.md                          # Skill主文档（本文件）
├── scripts/
│   └── playlet_bili_daily.py        # 核心脚本（字段映射已修复）
└── references/
    ├── core_workflow.md              # 核心执行流程、字段映射、HTML规则
    └── examples.md                   # 使用示例与常见用法组合

技术栈

项目	说明
运行环境	Python 3
开发语言	Python（脚本 playlet_bili_daily.py）
数据接口	HTTP 调用红狐Hub B站短剧API（queryPlayletMsgs，platform=6）
前端渲染	HTML 生成日报（B站蓝 #00A1D6 主题色，<img> 懒加载，BV号直链）
来源标识	source: "短剧B站信息源-GitHub"

数据流转

用户查询 → 日期预检 → API调用(queryPlayletMsgs) → 数据去重 → 题材聚类 → HTML日报生成 → 浏览器打开
                                              ↓
                                    终端输出趋势分析报告

常见问答

使用相关

Q1: 为什么查询"今天"的数据却提示未更新？

A: 数据每日15:00更新前一天的数据。15:00前最新可用日期为前天，15:00后为昨天。查询最新数据请使用 --latest 参数。

Q2: 如何查询特定题材的短剧？

A: 使用 --topics 参数，多个题材用逗号分隔，如 --topics "穿越,霸总,重生"。所有题材批量一次性查询，无需逐个调用。

Q3: 日报生成在哪里？

A: 默认保存在 ~/Downloads/QoderReports/ 目录，文件名格式为 短剧B站日报_YYYY-MM-DD.html，生成后自动在浏览器打开。

Q4: 如何开启/关闭每日订阅？

A: 使用 --subscribe 开启每日自动产出，--unsubscribe 关闭。

故障排除

Q5: 脚本运行报 UnicodeEncodeError 怎么办？

A: Windows PowerShell 的 GBK 编码问题。执行前设置环境变量：$env:PYTHONIOENCODING='utf-8'，然后重新运行脚本。

Q6: 提示"未找到 REDFOX_API_KEY 环境变量"？

A: 请按"一键安装"章节配置环境变量。Windows 用户配置后需重启终端才能生效。

Q7: HTML日报中图片加载不出来？

A: B站CDN（hdslb.com）无防盗链限制，通常不会出现此问题。若遇到请检查网络连接或图片URL是否过期。

B站短剧改造说明（从抖音版迁移）

Q8: B站版本与抖音版本有哪些差异？

A: 主要改造点如下：

改造项	抖音版本	B站版本
platform参数	1	6
主题色	#FB7299（粉）	#00A1D6（蓝）
链接格式	douyin.com/video/{id}	bilibili.com/video/{BV号}
文件名	短剧抖音日报	短剧B站日报
图片防盗链	需referrerpolicy	无需（B站CDN无限制）
展示指标	播放/点赞/评论	分享/点赞/评论（零值隐藏）
url字段	有效	None（用BV号拼接）

字段映射详情见 core_workflow.md

验证清单

• 脚本语法正确（py_compile通过）
• API接口地址已更新为B站
• platform参数已改为6（B站）
• photoId是BV号格式，用于拼接链接
• readCount有真实数据，但不展示
• shareCount展示为分享数
• likeCount作为主排序指标
• url字段为None，用BV号拼接bilibili.com链接
• coverUrl为B站CDN（hdslb.com），无需referrerpolicy
• HTML主题色改为B站蓝（#00A1D6）
• 指标展示：分享/点赞/评论（零值隐藏）
• 链接格式：bilibili.com/video/{BV号}
• source字段：短剧B站信息源-GitHub

获取帮助

如有其他问题，可通过项目 GitHub 仓库提交 Issue。

📚 参考文档

• core_workflow.md — 核心执行流程、字段映射、HTML规则、指标展示规则、与抖音差异对比
• examples.md — 使用示例与常见用法组合