抖音数据分析器

解决什么问题

做短视频内容策划时，最常见的困境是决策靠感觉：选题拍脑袋，竞品情况不清楚，评论区里的用户情绪没人细看，热点来了也来不及反应。手工去抖音App里翻、复制、截图，一次竞品盘点可能就要花掉半天，数据还分散、难复用。

这个技能的目标是把这些动作脚本化，让"搜视频、拉作品、抓评论、看热榜"变成一条可重复执行的命令。

它能做什么

围绕抖音公开数据，提供四类能力：

• 关键词搜索：按关键词搜视频，可按点赞或最新排序，用来找爆款选题、观察高赞视频的共性。
• 作者作品批量抓取：拿到对标账号的全部公开作品数据，用于分析其内容策略和更新节奏。
• 评论获取：拉取指定作品的评论详情，分析舆情走向和用户真实反馈。
• 热榜追踪：实时获取抖音热榜，判断当前可追的热点。

关键步骤与工作方式

以关键词搜索为例，流程大致是：调用方传入关键词和排序方式，技能返回结果并把原始数据落盘为 logs 目录下的 JSON 文件，例如 时间戳_关键词_排序_时间_时长_search.json。作者作品、评论也各有对应的日志命名规则。

这带来两个好处：一次调用拿到结构化数据，后续对比分析、做报告时可以直接读文件，不必再人工整理；单次任务最多可获取约 1 万条数据，批量操作也被内置进技能里。

技能用 Node.js 运行，不需要登录你的抖音账号，因此不存在账号风控或封号风险，也不依赖你本地的任何登录态。

适用边界与注意点

• 只抓公开数据：私密、隐藏内容无法获取，设计上就不应该期待它绕过任何可见性限制。
• 需要 GUAIKEI_API_TOKEN：没有配置环境变量会直接报无权限，Token 不要泄露给他人。
• 使用范围：数据仅限个人或团队内部使用，禁止违规分发。
• 空结果排查：如果搜不到内容，先换更常用的关键词，或把时间范围参数设为 0 表示全部时间。

适合的场景是内容选题、竞品监测、舆情观察和热点跟进；不适合拿来做需要登录态或非公开数据的采集。