抖音数据雷达

为什么要做这个技能

团队在做短视频选题时，经常需要在抖音里反复手动搜索关键词、点进博主主页翻作品、复制评论做情绪判断。一次竞品调研可能要切换几十个页面，整理出来的数据格式还不统一，写周报时又得重新对齐。这个技能把抖音公开数据的抓取、结构化和落盘串成一条命令式流程，适合需要反复拉数据的分析、运营和内容策划场景。

它解决什么问题

• 选题难：用关键词搜索视频并按点赞排序，快速看到高互动内容的共同特征。
• 竞品跟踪：拿到一个或多个对标账号的 sec_uid 后，可批量拉取其全部公开作品。
• 评论舆情：读取指定视频的评论详情，判断讨论方向和用户情绪。
• 热点追踪：实时读取抖音热榜，抢在流量上升期安排内容。
• 数据留存：任务结果自动写入 logs 目录的 JSON 文件，方便后续筛选、对比和做报告。

如何使用

先在抖音搜索技能官网开通 TOKEN，并配置环境变量 GUAIKEI_API_TOKEN。技能基于 Node.js 运行，无需部署额外服务，支持 Windows、macOS 和 Linux。

主要操作只有五类：

1. 关键词搜索：输入关键词，按最新或点赞排序，一次可获取最多 1W 条结果。
2. 博主作品抓取：用 sec_uid 拉取指定账号的全部公开作品。
3. 评论获取：传入视频 aweme_id，读取评论详情。
4. 热榜读取：直接获取抖音实时热榜。
5. 日志导出：每次任务都会生成结构化 JSON 日志，文件名包含时间戳、关键词或 ID、任务类型等字段。

具体入参和出参可参考技能 assets 目录中的 JSON Schema draft-07 文件，分别覆盖搜索、博主作品、评论和热榜的规范。

适用边界

• 只处理公开数据，不支持私密或隐藏内容。
• 必须配置 GUAIKEI_API_TOKEN，否则会报无权限。
• TOKEN 属于个人或团队私有凭证，不要泄露或违规分发数据。
• 如果搜索结果为空，建议更换常用关键词，或将时间范围参数设为 0 表示全部时间。
• 输出日志默认保存在技能目录下的 logs 文件夹，注意后续做二次分析时保持目录整洁。

这个技能适合把抖音数据当作一个可重复调用的数据源，而不是绕过平台风控的爬虫工具。