douyin-topiclisted

# Douyin Topic Skill — 抖音选题 + 对标拆解 把抖音当前热门话题（**真实数据**）筛成符合本博客「前端 → 全栈 → AI 开发」方向的选题，分 🔥热度 / 📈涨粉 双系列，定位确切代表视频，拆解爆款（钩子/结构/热评/转写），产出**详细到可抄**的大纲 + 映射博客资产的仿写脚本。 ## 何时用 - 不知道该做什么视频 / 下一篇写什么 → 跑 `make topic` 拿选题清单（Phase 1，不下载） - 想快速涨粉 → 优先看 📈涨粉系列（垂直话题），结合原片拆解做差异化原创 - 想蹭热点 → 优先看 🔥热度系列（热榜 ∩ 方向关键词），跟得快有流量 - 在 `topics.md` / `rough_outlines/` 看中某条 → `make topic-deep id=<group_id>` 确认后深挖（Phase 2） ## 数据源（三源真实数据，已实测） | 源 | 通道 | 内容 | |----|------|------| | A | 抖音搜索热榜 API（免登录免签名） | 51 热搜词 + 5 上升热点，`group_id` 覆盖率 98% | | B | `yxer query hot-events`（蚁小二，账号已绑定） | 热榜 + 真实播放量（千万级） | | C | `yxer query challenges --query <方向词>` | 方向内话题搜索（存在性信号） | - A 源异常自动降级 B（双源兜底）；结果缓存 10 分钟 - 抖音账号 id 动态解析（`yxer accounts list`），不硬编码 ## ⚠️ 合规边界（强制，违反即错） - 下载的原片 / 截图**仅作分析素材**（转写、拆钩子、截关键帧、拆结构），**禁止直接发布** - 产出是「同结构、换内容」的**差异化原创脚本**：内容来自真实经历 / 存量博客，不复制原片文案逐字发布 - 搬运原片违反抖音原创声明 / 查重机制 → 限流删号；发布管线已有 AI 生成声明（`declaration=3`） ## 依赖 | 依赖 | 用途 | 安装 | |------|------|------| | Python 3.11（全局，含 playwright） | 全部脚本解释器（对齐 video/wechat 管线） | 已装 | | playwright + msedge | 打开视频页拦截 mp4 / 截图 | 已装（wechat 管线复用） | | faster-whisper | 原片本地中文转写 | `py -3.11 -m pip install faster-whisper` | | yxer CLI（蚁小二） | B/C 源拉取 | `npm i -g @yixiaoermail/cli` + 客户端在线 | ## 运行（两阶段：先选题，确认后再深挖） **默认先跑 Phase 1 选题**（不下载原片，快）；看到想模仿的代表视频后，**用户确认**再跑 Phase 2 下载拆解。 ```bash # ── Phase 1 选题（不下载）── make topic # 三源拉取 → 双系列评分 → Top 候选「假设大纲」 # 产物: .douyin-topic/topics.md + rough_outlines/ # 参数: make topic top=8