SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场playlet-bili-feed

playlet-bili-feed

营销与增长

查看项目

更新于 10-16 02:58

技能介绍

用途

B站短剧爆款内容追踪工具，通过数据驱动方式帮助短剧创作者、MCN机构和内容运营人员把握B站短剧流量风口。每日自动扫描B站短剧创作内容，按点赞量筛选爆款作品，智能聚类题材后生成可视化HTML日报与创作趋势分析。

主要能力

  • 爆款发现：从B站短剧中按点赞量筛选热门内容，精准定位高热度短剧作品。
  • 题材聚类：自动识别题材方向（穿越/霸总/重生/悬疑等），每天题材分类由内容动态决定。
  • 智能查询：默认查询全部短剧，关键词命中词库（题材名+相关词）直接查询，数据不足时提示推荐题材等待确认。
  • 自定义查询：用户可指定任意题材/达人/关键词定向查询。
  • 创作洞察：分析爆款标题特征、题材趋势、达人表现。
  • 可视化日报：深色主题HTML，封面图+互动数据+作品直链。
  • 一键订阅：--subscribe 开启每日自动产出，日报自动攒在本地文件夹。

特色机制包括：探活式日期预检（调用前用轻量请求真实探测目标日期是否有数据）、前置输入校验（关键词需命中短剧题材词库）、自动回退（--latest 自动向前回退最多7天）、无数据确认制（查询无匹配数据时不自动扩展题材、不自动降级全量，提示推荐题材关键词并等待用户确认）、结构化空因、B站风格日报（深色主题+B站蓝 #00A1D6，封面图懒加载，BV号直链跳转）、零值隐藏（互动指标为0时自动隐藏）。

使用方式

前置条件：Python 3 运行环境；已注册红狐Hub账号并获取 API Key（格式 ak_xxxxxxxx）。

环境变量配置：数据查询接口通过请求头 X-API-KEY 鉴权，Key 从环境变量 REDFOX_API_KEY 获取。macOS/Linux 将 export REDFOX_API_KEY=<值> 追加到 ~/.zshrc 或 ~/.bashrc 并 source 生效；Windows 使用 [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User")（需重启终端）。

基础使用：

# 生成最新一期日报（用户确认后，自动跳过无数据日期，不扣积分）
python3 "$SKILL_PATH/scripts/playlet_bili_daily.py" --latest

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

自定义题材查询：

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

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

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

命令速查：--latest（自动使用最新有数据的日期，向前回退最多7天）、--date YYYY-MM-DD（指定日期查询）、--topics "关键词,..."（自定义题材查询，逗号分隔）、--count N（扫描作品数量，默认200）、--start-time / --end-time（自定义开始/结束时间）、--output-dir（输出目录，默认 ~/Downloads/QoderReports）、--api-key（指定 API Key，覆盖环境变量）、--subscribe / --unsubscribe（开启/关闭每日订阅）、--from-cache（使用缓存数据）。

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

适用场景

  • 短剧创作者选题参考：每日查看短剧日报，关注题材聚类分布，分析爆款标题特征和互动数据，针对新兴起量题材提前布局内容。
  • MCN 机构内容运营：订阅每日日报持续追踪B站短剧赛道，通过核心达人榜了解竞品表现，使用自定义题材查询定向分析关注领域。
  • 品牌方/制作方竞品监测：定期查询目标题材日报，分析竞品爆款作品的标题特征和互动规律，结合跨题材对比建议探索融合创作。

限制

  • 数据每日15:00更新前一天数据，实际更新时间可能延迟，以脚本真实探活为准。
  • 查询前脚本先做输入校验：关键词需命中短剧题材词库（topic_keywords 中规定的题材名+全部相关词），不符合时不请求任何接口，直接提醒"关键词不满足查询条件"并推荐相关词。
  • 无数据确认制：查询无匹配数据或全量数据不足时，禁止自动发起任何额外查询（禁止自动降级全量、禁止自动扩展题材），先展示推荐题材关键词并询问用户，用户确认后才可发起查询。
  • 日期超出有效查询范围时提醒并自动回退最近有数据日期，无需用户确认。
  • 需配置 REDFOX_API_KEY 环境变量，接口调用通过 source 字段（值为 短剧B站信息源-GitHub）同步记录来源。
  • Windows PowerShell 若报 UnicodeEncodeError，需设置 $env:PYTHONIOENCODING='utf-8'。
  • 项目架构：SKILL.md 主文档、scripts/playlet_bili_daily.py 核心脚本、references/core_workflow.md 与 examples.md 参考文档。技术栈为 Python 3，数据接口为 HTTP 调用红狐Hub B站短剧API（queryPlayletMsgs，platform=6），前端渲染为 HTML 日报。
  • 收费、价格等具体信息暂未提供。