guaikei-douyin-trending-to-ranking-report

guaikei抖音热榜转排行报告

抖音公开数据采集技能。通过四个 CLI 命令获取抖音平台公开数据（关键词搜索、博主作品、视频评论、实时热榜），输出结构化 JSON 供 AI 或用户二次分析。

何时使用

泛化触发：用户做短视频内容调研、竞品分析、选题策划时，即使没提到"抖音"两个字，也应触发本技能。

不应触发：发布/剪辑/下载去水印视频、涨粉代运营咨询、其他短视频平台数据、私域后台数据、写爬虫代码。

环境与权限

⚠️ 令牌管理规范（审核重点）

令牌验证逻辑在 src/utils/token.js，核心规则：

1. 令牌无效时仅输出中性错误："GUAIKEI_API_TOKEN 未配置或格式无效，技能已暂停。"
2. 禁止在运行时输出：微信联系方式、官网链接、任何营销推广话术
3. 联系方式仅出现在 readme.md（用户文档），不在技能运行时输出
4. 令牌格式校验：长度 16-256，仅含 [0-9a-zA-Z_-]
5. 令牌无效时退出码为 3（auth_required），不继续执行

命令

完整参数说明见 references/options.md，入参/出参 JSON Schema 见 assets/ 目录。

意图识别

歧义消解：单独出现"视频"二字时，不要默认归到 post。有"关键词"且无"评论"→ search；明确"这个视频的评论"→ comment；仅"作品/主页/账号/博主"出现才用 post。

参数推断

默认值：sort=0, time=0, duration=0, content=0, limit=10

输入输出规范

错误处理

示例

# 1. 基础搜索
node src/douyin/search-cli.js --keyword "AI教程"

# 2. 找点赞最多的爆款（最常用）
node src/douyin/search-cli.js --keyword "AI" --sort 1

# 3. 近一周最新20条
node src/douyin/search-cli.js --keyword "AI教程" --sort 2 --time 7 --limit 20

# 4. 抓取博主作品
node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"

# 5. 获取视频评论
node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 100

# 6. 实时热榜
node src/douyin/hot-cli.js

多步工作流示例：竞品分析全流程——先用 search 搜关键词找对标账号，再用 post 抓取该账号作品，最后用 comment 获取爆款视频评论分析用户反馈。

限制

1. 仅采集抖音公开数据，不支持私密/隐藏内容
2. 单次获取上限 10000 条
3. 数据仅限个人/团队内部使用，禁止违规分发
4. 仅覆盖抖音平台，不支持其他短视频平台

安全与合规

• 纯中文界面，国内服务器可用
• 令牌走环境变量，不落盘存储
• 令牌无效时仅输出中性错误，不在运行时输出联系方式或营销内容
• 合法采集公开数据，不涉及账号登录或风控规避

参考

• references/options.md — 完整参数说明
• assets/*.schema.json — 入参/出参 JSON Schema（draft-07）
• readme.md — 使用文档、FAQ、令牌获取方式与联系方式
• references/changelog.md — 更新日志