抖音数据智析器

做短视频增长时，最麻烦的往往不是“没有想法”，而是缺少可核对的公开数据：选题方向是否被验证过，竞品在追什么内容，评论区的舆情走向如何，当前热榜里有哪些可结合的切入点。抖音数据智析器 面向这类工程场景，把抖音公开视频、作者作品、评论和热榜数据拉到本地，形成可检索、可对比、可二次分析的结构化结果。

它解决什么问题

• 你按关键词找视频时，需要快速看到点赞排序或最新排序下的高相关样本，而不是手工翻页记录。
• 你在跟踪竞品时，需要批量获取某个公开作者的作品数据，用来归纳内容策略、发布节奏和标题规律。
• 你在判断舆情时，需要读取作品评论内容，而不是只凭几条截图做主观推断。
• 你在追热点时，需要拿到实时热榜，尽快确认话题是否值得跟进。
• 你在写报告或做策划时，需要把结果沉淀成 JSON 日志，方便后续统计、对比和引用。

它如何工作

技能围绕五类能力组织：关键词搜索、作者作品抓取、评论获取、热榜读取、结构化日志输出。运行时无需登录你的抖音账号，降低账号风控与封号风险；配置环境变量 GUAIKEI_API_TOKEN 后，就可以按参数发起请求。搜索支持关键词与排序方式；作品与评论抓取面向公开内容；热榜用于快速发现当前热点。每次任务会把结果保存到技能目录的 logs 文件夹，日志文件名会带上时间戳、关键词/作者/视频标识、类型等字段，便于定位和批量处理。

适用边界与注意点

• 仅支持抖音公开视频、公开作者作品、公开评论和热榜，不覆盖私密或隐藏内容。
• GUAIKEI_API_TOKEN 是运行前提；报错提示无权限时，先检查环境变量是否已正确设置。
• 搜索结果为空时，可尝试更换更常用的关键词，或把时间范围设置为 0（全部时间）。
• 数据适合个人或团队内部分析，禁止违规分发；导出的 JSON 应作为研究素材而非无条件发布内容。