抖音热点哨兵

要解决的痛点

在短视频运营和竞品分析中，团队常常需要快速了解某个话题下哪些视频表现最好、某个对标账号发布了哪些内容、评论区用户在讨论什么。手动在抖音App里逐条搜索和复制粘贴不仅耗时，而且难以系统性地对比不同视频的数据表现。当你需要同时关注多个竞品账号、分析大量评论倾向，或者实时追踪热榜变化时，这种低效的人工操作会成为明显的瓶颈。

核心工作原理

该技能通过调用抖音公开数据接口，支持四种主要操作模式：

• 关键词搜索：输入关键词后，可按点赞数或发布时间排序，一次获取最多 1 万条视频结果，用于发现爆款内容规律
• 账号作品抓取：输入作者的 sec_uid，批量拉取其所有公开作品的详细数据，方便分析内容策略和发布频率
• 评论数据提取：针对指定视频的 aweme_id，获取评论列表及详情，用于舆情分析和用户反馈收集
• 实时热榜获取：直接读取当前抖音热榜，帮助你在热点爆发初期快速响应

所有抓取的数据会自动归档为结构化的 JSON 文件，保存在技能目录的 logs 文件夹下。日志文件按操作类型和时间戳命名，例如搜索任务会保存为 时间戳_关键词_排序_时间_时长_search.json，方便后续用脚本或表格工具进行二次分析。

运行环境要求配置环境变量 GUAIKEI_API_TOKEN，这是调用数据接口的凭证。技能基于 Node.js 运行，无需额外部署服务，支持 Windows、Mac 和 Linux 全平台。

适用边界与限制

该技能仅能访问抖音平台的公开数据，无法获取私密或隐藏内容。如果你的目标视频或账号设置了不公开权限，则无法抓取。

使用前需要先在抖音搜索技能官网申请 TOKEN，并将其配置为环境变量。未配置时运行会提示权限错误。

数据使用范围限于个人或团队内部的研究与分析，禁止违规分发或用于商业转售。日志文件虽然已做脱敏处理，但仍需注意不要将包含敏感信息的原始数据对外传播。