tiktok-skilllisted

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