tiktok-batch-downloaderlisted
Install: claude install-skill why20261/tiktok-batch-downloader
# 🚀 TikTok作品批量下载
## 1. 能力概览
> 💡**一句话价值**:一个口语化指令拿到TikTok公开的视频/作者/评论数据,直接输出结构化JSON——做达人筛选、数据分析、市场调研、爆款选题、对标账号监控、评论舆情分析、热点追踪,不用再手动刷TikTok。
| 能力 | 入口脚本 | 必填参数 | 返回 |
| ---------- | ------------------------------- | ------------------------ | --------------------------------------------------- |
| 关键词搜索 | `scripts/tiktok/search-cli.js` | `--keyword` | 作品列表:作者、点赞/评论/分享/收藏、标签、播放地址 |
| 博主作品 | `scripts/tiktok/post-cli.js` | `--url`(主页或用户名) | 该博主公开作品列表(支持最新 / 最热排序) |
| 视频评论 | `scripts/tiktok/comment-cli.js` | `--url`(视频链接或 ID) | 评论正文、评论者、点赞数、回复数 |
> **前置条件**:必须在**技能根目录**执行,且环境变量 `GUAIKEI_API_TOKEN` 已配置。未配置时所有命令返回退出码 `3`、`error_code=AUTH_REQUIRED`——此时**直接提示用户配置 Token,不要重试、不要换参数**。
---
## 2. 何时调用 / 何时不调用
### 2.1 应该调用
- 用户要查 **TikTok** 的公开内容(视频 / 图文 / 作者 / 评论 / 趋势)。
- 用户要做**爆款选题调研、竞品账号监控、红人筛选、评论舆情分析、内容风格拆解**。
- 用户已给出 TikTok 关键词、视频链接、博主主页链接,希望拿到结构化数据。
- 用户拿到数据后还要继续做总结、对比、排序、聚类、出报告 / 表格。
### 2.2 不应调用
- 用户只要文案 / 标题 / 脚本,没有要查 TikTok 数据。
- 平台不是 TikTok,而是其他平台的(抖音、小红书、B 站、微博、公众号)→ 路由到对应技能。**本技能只处理 TikTok。**
- 要求登录态、私密、隐藏数据 → 不支持。
- 既有关键词又有可识别链接且目标不明 → **先追问,不要猜**。
### 2.3 能力边界(明确不做)
发布 / 点赞 / 评论 / 关注 / 私信等**写操作**一律不支持;不登录任何账号;不采集手机号、位置、私信等隐私字段;不替用户做营销决策——职责是把数据拿回来,分析交给上层。
---
## 3. 调用路由(先判断,再执行)
| 用户意图 | 脚本 | 判定关键词 |
| ----------------------------------