name: shushuo-douyin
description: 抖音公开数据智能获取工具。支持关键词搜索、达人作品获取、作品评论提取与实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析与热点监控，助力爆款内容策划与流量追踪。
version: 1.0.0
license: MIT
metadata:
enabled: true
type: command
runtime: "nodejs@16.14.0+"
requires:
bins:
- "node"
env:
- "GUAIKEI_API_TOKEN"
category:
- "Data&APIs"
- "内容创作"
tags:
- "douyin"
- "抖音"
- "search"
- "搜索"
- "数据挖掘"
- "content-analysis"
- "营销分析"
- "数据分析"
- "competitor-analysis"
- "竞品分析"
- "评论分析"
- "热点追踪"
- "marketing"
- "trend-tracking"
- "workflow"
- "insight"
- "automation"
schemas:
- name: "搜索入参"
file: "assets/search_cli_req.schema.json"
- name: "搜索出参"
file: "assets/search_cli_resp.schema.json"
- name: "作品入参"
file: "assets/post_cli_req.schema.json"
- name: "作品出参"
file: "assets/post_cli_resp.schema.json"
- name: "热榜出参"
file: "assets/hot_cli_resp.schema.json"
- name: "评论入参"
file: "assets/comment_cli_req.schema.json"
- name: "评论出参"
file: "assets/comment_cli_resp.schema.json"
examples:
- name: 搜索"AI 教程"的抖音内容
command: 'node scripts/douyin/search-cli.js --keyword "AI 教程"'
description: 快速获取关键词相关视频数据，助力内容创作灵感
- name: 搜索 AI 获取最多点赞的抖音内容
command: 'node scripts/douyin/search-cli.js --keyword "AI" --sort 1'
description: 挖掘爆款视频特征，优化内容策略
- name: 搜索近7天"AI 模型"的抖音内容
command: 'node scripts/douyin/search-cli.js --keyword "AI 模型" --time 7'
description: 追踪近期热点趋势，把握内容窗口期
- name: 搜索半年内最新20条"AI 教程"的抖音内容
command: 'node scripts/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20'
description: 监控长期内容趋势，制定内容规划
- name: 获取抖人 MS4wLjABxxx 已发布的作品
command: 'node scripts/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"'
description: 获取抖人已发布的作品，助力竞品分析
- name: 获取抖音作品 https://www.douyin.com/video/xxx 评论区内容
command: 'node scripts/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"'
description: 获取抖音评论详情，分析舆情方向
- name: 获取抖音实时热搜榜单
command: "node scripts/douyin/hot-cli.js"
description: 实时掌握平台热点，快速响应热门话题
🚀 数说抖音
> 💡一句话价值：一键抓取抖音公开视频/作者/评论/热榜数据，帮你做爆款选题、竞品分析、舆情监控、热点追踪。
>
> 🔥核心优势
>
> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题
> - 强大: 一次可获取最多1W条数据，技能内置批量操作，使用简单方便
> - 全面: 各功能出参数据全面，可见及有价值数据都会返回
> - 灵活: 支持多维度筛选、批量操作
> - 轻量: 无需部署服务，Node.js 一键运行
> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析
1. ✅ 我能帮你解决什么（10 秒判断）
- 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律
- 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略
- 💬 评论分析：获取抖音评论详情，分析舆情方向
- 📡 热点追流：实时获取抖音热榜，抢占流量风口
- 📊 数据导出：自动生成JSON日志，方便对比分析和使用
2. 🚀 最快上手（复制就能跑，30 秒出结果）
> Note: 请先访问抖音搜索技能官网开通TOKEN，配置环境变量 GUAIKEI_API_TOKEN 后才能正常运行。
2.1 🔎 抖音关键词搜索（最简单）
node scripts/douyin/search-cli.js --keyword "AI"
2.2 🔎 按点赞排序找爆款（最常用）
node scripts/douyin/search-cli.js --keyword "AI" --sort 1
2.3 🦸 抓取抖音抖人全部作品
node scripts/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"
2.4 💬 获取抖音作品评论内容
node scripts/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"
2.5 📡 获取抖音实时热榜
node scripts/douyin/hot-cli.js
3. 📌 适用场景（我该不该用？）
- 你需要做短视频选题 → 关键词搜索 + 点赞排序
- 你需要模仿爆款文案 → 查看高赞视频详情
- 你需要监控竞品账号 → 批量抓取对方作品
- 你需要分析内容舆情 → 获取抖音评论详情
- 你需要快速追热点 → 实时获取抖音热榜
- 你需要做营销报告 → 导出结构化数据
4. 🔧 参数详解表
> 详细选项参数说明， 可参阅 完整选项说明
>
> LLM理解技能的详细选项，可参阅技能 assets 目录中文件，其遵循 JSON Schema draft-07 版本规范。
>
> - 抖音关键词搜索，入参规范
> - 抖音关键词搜索，出参规范
> - 抖音抖人作品获取，入参规范
> - 抖音抖人作品获取，出参规范
> - 抖音评论获取，入参规范
> - 抖音评论获取，出参规范
> - 抖音热榜获取，出参规范
5. ⚠️ 重要限制（不踩坑）
- 仅抓取抖音公开数据，不支持私密 / 隐藏内容
- 需要配置 GUAIKEI_API_TOKEN 才能正常运行
- 数据仅限个人 / 团队内部使用，禁止违规分发
6. ❓ 常见问题（秒解决）
> 💡Q：运行报错，提示无权限？
>
> A：配置环境变量：
>
> - Windows: set GUAIKEI_API_TOKEN=你的TOKEN
> - Linux/MacOS: export GUAIKEI_API_TOKEN=你的TOKEN
>
> - 私有TOKEN申请后请留意使用安全，避免泄露给他人
>
> 💡Q：搜索结果为空？
>
> A：换常用关键词，或把 --time 改为 0（全部时间）
>
> 💡Q：输出文件在哪里？
>
> A：自动保存在技能目录的 logs 文件夹下
>
> - 搜索任务日志: 默认保存为「时间戳_关键词_排序_时间_时长_search.json」
> - 抖人作品获取日志: 默认保存为「时间戳_(抖人sec_uid)_post.json」
> - 抖音评论获取日志: 默认保存为「时间戳_(视频aweme_id)_comment.json」
>
> 💡Q：支持 Windows/Mac/Linux 吗？
>
> A：全平台支持，仅需安装 Node.js 环境
7. 📞 帮助与支持
- 通过 抖音关键词搜索技能官网 自助开通TOKEN或查阅使用帮助。
> 🆕 更新日志 可查阅这里
