抖音洞察达人

解决什么问题

做短视频选题时，判断一个方向是否值得做往往靠拍脑袋。竞品的内容策略变化、评论区的真实反馈、热榜的轮动节奏，这些信号散落在抖音的公开页面上，手工复制粘贴效率极低，而且难以形成可对比的数据集。这个技能把四类常见诉求收敛成统一入口：按关键词搜索公开视频、批量抓取对标账号的作品、读取视频评论、拉取实时热榜。

核心能力

• 关键词搜索：按关键词检索公开视频，支持按点赞或最新排序，用于找爆款选题、归纳高赞视频的共同特征。
• 作者作品抓取：给定作者的 sec_uid，批量获取其公开作品数据，一次最多 1 万条，适合做竞品内容策略分析。
• 评论分析：获取指定视频的评论详情，用于判断内容舆情方向。
• 热榜追踪：读取抖音实时热榜，快速跟进流量风口。
• 结构化落盘：所有任务的日志自动归档到技能目录下的 logs 文件夹，搜索、作品、评论分别按约定文件名保存为 JSON，方便后续二次分析和写报告。

工作方式

技能基于 Node.js 运行，无需部署额外服务。调用前需在抖音搜索技能官网开通 TOKEN，并配置环境变量 GUAIKEI_API_TOKEN。运行参数遵循 JSON Schema draft-07 规范，详细入参出参说明放在技能的 assets 目录中，大模型可直接读取理解。任务执行后，按时间戳、关键词、排序方式等信息生成日志文件名，便于回溯。

边界与注意点

• 只抓取公开数据，私密或隐藏内容不在支持范围内。
• 未配置 GUAIKEI_API_TOKEN 会直接报无权限，Windows 用 set、Linux/macOS 用 export 设置即可。
• 搜索结果为空时，优先换更通用的关键词，或把时间参数改为全部时间。
• 输出文件默认在 logs 目录下，命名规则与任务类型对应，不需要手动指定路径。
• 数据仅限个人或团队内部使用，禁止违规分发；TOKEN 属私有凭证，注意不要泄露。