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

playlet-xhs-feed

营销与增长

查看项目

更新于 10-16 01:56

技能介绍

用途

短剧-小红书信息源是一款专为短剧创作者设计的小红书爆款内容追踪工具，参考AI-B站信息源的功能和样式设计。它通过红狐Hub API每日自动扫描小红书短剧内容，按互动量筛选爆款作品，智能聚类题材方向，并生成可视化HTML日报，帮助短剧编剧、制作人、运营人员把握小红书短剧流量风口。

主要能力

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

特色亮点包括：前置输入校验（v2.3），查询前判断分类/关键词是否符合短剧题材词库、日期是否在有效查询范围；智能日期判断，脚本内置 DATA_UPDATE_HOUR = 15 常量，调用接口前自动检测目标日期是否在无数据区间；结构化空因，空结果时明确输出原因分类并给出下一步建议；自动扩展题材，全量查询数据不足（<100条）时自动追加穿越→霸总→重生→悬疑→甜宠→逆袭定向查询补充；空结果重试，单题材查询为空/异常时间隔4秒自动重试1次；小红书适配，作品链接自动拼接 xiaohongshu.com/explore/{photoId}，互动数据为0的字段自动隐藏，HEIF封面自动转JPG，加载失败自动fallback默认封面；安全可靠，API Key通过环境变量 REDFOX_API_KEY 获取，禁止硬编码。

使用方式

前置条件：Python 3 运行环境；已注册红狐Hub账号并获取 API Key（格式为 ak_xxxxxxxx，新注册用户获赠免费积分）。

配置环境变量：

macOS/Linux：

echo 'export REDFOX_API_KEY=ak_xxxxxxxx' >> ~/.zshrc
source ~/.zshrc

Windows（PowerShell）：

[Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "ak_xxxxxxxx", "User")

配置后需重启终端使环境变量生效。验证配置：macOS/Linux 执行 echo $REDFOX_API_KEY，Windows 执行 echo %REDFOX_API_KEY%。

工作流程：

第零步：日期有效性预检（必须执行，先于任何接口调用）。数据更新规则为每日15:00更新前一天的数据。15:00前最新可用日期为T-2（前天），15:00后为T-1（昨天）。若目标日期无数据，需向用户输出提示并等待明确确认后才能执行（带 --latest 参数）；若用户拒绝，则不执行任何接口调用。

前置校验：分类/关键词（v2.3，先于日期处理）。查询前先判断用户输入的关键词/分类是否符合短剧题材词库（穿越/霸总/重生/甜宠/悬疑/逆袭/年代/战神/古装/都市/科幻等）。全部不符合时不请求任何接口，直接提示"关键词不满足短剧查询条件"并推荐相关分类和关键词后停止；部分不符合（混合词）时保留有效关键词继续查询，无效关键词自动忽略并提示；全部符合时正常查询。

第一步：生成爆款日报。常用命令：

python3 "$SKILL_PATH/assets/daily_report.py" --latest
python3 "$SKILL_PATH/assets/daily_report.py" --date 2026-06-10
python3 "$SKILL_PATH/assets/daily_report.py" --topics "穿越,霸总,重生,悬疑" --latest
python3 "$SKILL_PATH/assets/daily_report.py" --subscribe
python3 "$SKILL_PATH/assets/daily_report.py" --unsubscribe

查询策略：默认查询全部短剧内容（pageSize=200），数据不足（<100条）时自动追加热门题材（穿越→霸总→重生→悬疑→甜宠→逆袭），所有题材通过批量接口一次性查询。用户自定义题材时仅使用用户提供的有效题材词，同样批量查询。

第二步：执行创作趋势分析。日报生成后，必须基于聚类结果自动执行创作趋势分析：读取题材聚类结果，选取TOP 5热门题材；分析每个题材的爆款数量、平均互动数据、头部作品特征；识别新兴起量题材（数量少但互动高）；输出结构化创作趋势报告。

生成的HTML日报保存在 ~/Downloads/QoderReports/，自动浏览器打开。终端同步输出题材分类表格 + 创作趋势分析报告。

输出格式（强制执行）：日报生成后，对话回复必须严格按照输出模板输出 md 内容，禁止任何自由发挥、省略或口语化文字。模板包含题材概览、创作趋势分析（新兴起量信号、爆款标题特征、核心达人榜、题材趋势报告、跨题材对比建议）等板块，所有字段不可省略，板块标题必须保留，若某模块无数据则在该板块内标注"暂无"。

参数说明：

  • --topics "关键词,..."：自定义题材查询，逗号分隔；全部不符合短剧题材词库时不请求接口直接提示+推荐；混合词保留有效词。默认全量查询。
  • --count N：扫描作品数量，满足即停。默认200。
  • --date YYYY-MM-DD：指定日期（超出有效范围/未更新时提示并询问，等待确认；历史日期已有数据无需确认）。默认今天。
  • --start-time：自定义开始时间 YYYY-MM-DD HH:MM:SS（覆盖 --date 推算）。
  • --end-time：自定义结束时间 YYYY-MM-DD HH:MM:SS（覆盖 --date 推算）。
  • --latest：自动使用最新有数据的日期（用户确认后执行，不扣积分）。
  • --output-dir：输出目录。默认 ~/Downloads/QoderReports。
  • --api-key：指定 API Key。
  • --subscribe：开启每日订阅。
  • --unsubscribe：关闭每日订阅。
  • --from-cache：使用缓存数据，不扣积分。

自定义题材查询示例：

python3 "$SKILL_PATH/assets/daily_report.py" --topics "穿越,时空,重生"
python3 "$SKILL_PATH/assets/daily_report.py" --topics "霸总,甜宠,总裁,虐恋"
python3 "$SKILL_PATH/assets/daily_report.py" --topics "悬疑,推理,反转,惊悚"

适用场景

场景一：短剧创作者选题参考。短剧编剧/制作人可每日确认后执行 --latest 获取最新日报，分析题材聚类结果，关注新兴起量信号，参考爆款标题特征和题材趋势报告，精准把握流量风口，提升选题命中率。

场景二：运营团队竞品监控。短剧运营/MCN机构可使用 --topics 定向查询竞品所在题材，关注核心达人榜识别头部竞品账号，开启 --subscribe 每日自动攒日报，及时掌握竞品动态，优化自身运营策略。

场景三：内容趋势分析。内容策划/数据分析师可结合 --start-time 和 --end-time 批量分析时间范围数据，利用创作趋势分析的5个维度深度挖掘规律，关注跨题材对比建议发现题材融合机会，产出结构化趋势报告，支撑内容战略决策。

限制

  • 数据每日15:00更新前一天数据，目标日期无数据时必须先告知用户并等待确认后才能调用接口，禁止自动获取。
  • 查询前需先校验分类/关键词是否符合短剧题材词库，全部不满足时不请求任何接口。
  • API Key 通过环境变量 REDFOX_API_KEY 获取，禁止硬编码。
  • 数据来源唯一：仅使用红狐Hub API，禁止自主采集。
  • 缓存文件存储在本地 ~/.workbuddy/cache/。
  • Windows PowerShell 执行可能报 UnicodeEncodeError，需设置 $env:PYTHONIOENCODING='utf-8'。
  • 具体收费、价格、平台支持范围等细节暂未提供。