抖音数据洞察

要解决什么问题

做短视频内容策划时，典型的痛点是选题靠拍脑袋、竞品靠手动刷、舆情靠感觉。分析一个赛道的爆款规律，往往要花几个小时手动翻页、抄点赞数和文案；想盯竞品账号的更新节奏，又拿不到可以留存复用的结构化数据。抖音数据洞察（规范名 @user_fb71c45d/douyin-shuju-dongcha）针对这类重复劳动，把抖音公开数据的抓取和整理封装成可直接调用的操作。

核心能力与工作方式

• 关键词搜索：按关键词检索抖音视频，支持点赞排序与最新排序，一次最多返回 1 万条数据
• 作者作品批量抓取：给定 sec_uid，拉取指定作者的全部公开作品，用于内容策略分析
• 评论获取：拉取视频评论详情，支撑舆情方向分析
• 热榜追踪：实时读取抖音热榜，快速跟进流量风口
• 结构化落盘：每次任务自动生成 JSON 日志写入 logs 目录，搜索、作品、评论三类任务各有命名约定，便于后续对比和二次分析

运行环境很轻：只需 Node.js，无需部署服务，也不需要登录抖音账号，因此不存在账号风控或封号风险。入参出参均遵循 JSON Schema draft-07 规范，定义文件放在技能的 assets 目录。

使用边界与注意事项

技能需要一个有效的 GUAIKEI_API_TOKEN，在抖音搜索技能官网开通后配置为环境变量即可（Linux/macOS 用 export，Windows 用 set），缺失会直接报无权限错误。

几个硬性限制：

• 只抓取公开数据，私密或隐藏内容无法获取
• 搜索结果为空时，可尝试把 --time 改为 0（全部时间）
• Token 不要泄露给他人；数据仅限个人或团队内部使用，禁止违规分发