【小题XT】TikTok 热门作品与趋势调研
给一个 TikTok 话题标签或探索页链接，收集作品及播放、点赞、评论等数据，去重排序后交付作品清单，并总结样本中的热门话题、常用音乐和内容线索。
能帮你做什么
| 你的需求 | 这个 Skill 会做什么 |
|---|---|
| 想找某个话题下值得参考的视频 | 从指定标签页收集作品，按播放、点赞或评论等数据排序 |
| 想看看探索页有哪些内容 | 采集指定探索页的作品与互动数据，整理可点击的作品清单 |
| 想筛选高播放、高互动作品 | 按你提出的门槛与发布时间筛选，不把低于门槛的作品凑进结果 |
| 想比较几个话题 | 分来源采集、合并去重，保留每条作品来自哪些页面 |
| 想从数据里找选题方向 | 汇总样本中的标签、音乐、时长分布及高互动作品，给出有作品依据的观察 |
结果范围说明： 标签页和探索页返回的是所连接数据服务能够获取的作品，不等同于 TikTok 官方热榜或全站排名。排序只针对本次样本；单次采集可以发现内容特征，判断“持续上涨”需要可比的历史数据。
你需要提供什么
提供 话题标签（如 #cooking）、标签页链接 或 探索页链接 即可。只说“看看 TikTok 趋势”时，默认查看公开探索页，并在采集前说明范围。
| 可指定的条件 | 未指定时怎么处理 |
|---|---|
| 标签或页面 | 明确标签可自动转换为标签页链接；宽泛主题需先确认具体标签，避免擅自翻译或扩展 |
| 采集数量 | 默认每个页面请求20条；实际数量可能受数据服务限制 |
| 发布时间 | 默认不限，可限定近7天、近30天或日期区间 |
| 点赞、评论、播放等门槛 | 默认不限，有要求则采集后据实筛选 |
| 排序方式 | 默认按播放数从高到低，可改按点赞、评论、收藏、分享、发布时间或互动率 |
| 是否必须带目标标签 | 默认保留标签页实际返回的作品并标注是否带该标签；要求“必须带”时严格筛选 |
采集前简要说明来源、数量和筛选口径；已有明确要求直接执行。多个页面的数量说法有歧义时，先确认是合计数量还是每页数量。
数量以实际结果为准。 请求20条不保证能取得20条，也不保证筛选后仍有20条；不足时报告实际数量和缺口。国家、地区、语言等限定只有数据支持核实时才执行，不能把请求出口位置当成作品或受众所在地。
能拿到哪些数据
| 数据 | 说明 |
|---|---|
| 作品链接、作品 ID、文案、发布时间 | 方便回看与追溯，原始文案保留 |
| 播放、点赞、评论、分享、收藏数 | 以数据服务返回为准；缺失留空，不填成0 |
| 作者账号、主页链接、粉丝数 | 仅保留实际返回的字段 |
| 话题标签、音乐、作品类型、视频时长 | 用于内容与样本分布观察 |
| 互动率与样本排名 | 根据原始指标计算，明确公式与排序口径，属于派生结果 |
| 来源页面、采集时间、采集状态 | 区分请求量、返回量、去重后数量与达标数量 |
只获得文案和指标时，洞察基于这些信息，不把文案推测写成已观看视频后的结论。
最后交付什么
- 作品清单：默认 CSV，可用 Excel 打开；已去重、筛选并排序，保留链接和互动数据。
- 数据记录：JSON 保存指标、来源、筛选口径和任务状态，便于核查与后续比较。
- 趋势洞察：说明样本范围、代表作品、标签与音乐分布、内容线索和数据局限；每项关键判断有数字或作品链接支持。
- 采集说明：列出实际取得多少、排除多少、哪些页面失败或仍在处理中。
可以直接这样用
> 找一下 TikTok #cooking 标签页的作品，采20条，按播放量排序，给我清单和选题观察。
> 采集这个探索页的30条作品，按点赞量排序，看看样本里有哪些常见话题和音乐。
> https://www.tiktok.com/explore
> 分别采集 #skincare 和 #makeup 各20条，合并去重，只保留近30天发布、播放超过10万的作品。数量不足如实说明。
使用前需要准备
当前 Agent 需要配置并能实际使用小题 ai-tool-center MCP，配置方法见下方。采集由数据服务完成；导出本地文件不要求安装飞书或钉钉 CLI。附带的本地整理脚本只使用 Python 3 标准库；未安装 Python 时可用 Agent 的本地文件处理能力按相同规则整理。
本 Skill 聚焦标签页和探索页作品调研，不默认扩展为评论正文采集、视频下载、账号全量采集、在线表格写入或定时监控。
以下为 Agent 执行规则。上面的内容用于介绍能力，不改变执行顺序：第一步始终检查小题 MCP，未通过时不访问 TikTok 链接、不调用其他采集能力。 制作或修改本 Skill 属于文件编辑；仅在用户授权时进行真实采集测试。
小题 XT MCP 强制前置闸门
本节优先于正文中任何旧版配置、手动兜底或“选择是否使用 MCP”的说明。加载本 Skill 后，第一步只检查当前 Agent 是否实际配置并可用名为 ai-tool-center 的 MCP；以当前 Agent 的 MCP 服务器列表、已注册工具列表或可用连接状态为准。已检测到且可用时直接继续，不重复询问配置、不索取 API Key；未检测到、无法确认或连接失败时，只发送配置提醒并停止，不得先读取外部链接、调用平台数据、生成/分析媒体或使用其他能力绕过闸门。
用户只说“已配置”、只提供 URL/API Key，或配置后尚未重启验证，均不算可用。用户明确不配置时，只有在其再次明确授权无 MCP 继续后，才可执行不依赖 MCP 的部分，并标记受影响能力，不得伪称 MCP 调用成功。
MCP 配置提醒
未检测到可用 MCP 时，提示用户到 xt.gbotai.cn 申请 API Key，在当前 Agent 的 MCP 设置中新增以下配置，完全退出并重启 Agent，确认工具列表出现 ai-tool-center 后再回复“已配置 MCP”；真实 Key 不得写入 Skill、日志或交付物。
{
"mcpServers": {
"ai-tool-center": {
"url": "https://middle-aitool.gbotai.cn/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
MCP 错误提醒
调用 ai-tool-center 时按返回错误或状态分流，不要反复重试或猜测原因：
- 如果返回 Key 无效、未授权、认证失败或类似错误，提醒用户到 xt.gbotai.cn 重新申请 Key，更新配置并重启 Agent 后再重试。
- 如果返回钱包余额不足、额度不足或类似计费错误，提醒用户到 xt.gbotai.cn 进行充值，确认余额恢复后再重试。
- 错误处理完成前，将对应能力标记为“待确认/不可用”，不得声称任务成功，也不要索取或展示真实 Key、钱包或支付信息。
Agent 执行入口
- 检查 MCP：执行强制闸门，再核对实际注册的
social和task工具。 - 确定采集范围：整理标签页／探索页 URL、每页请求量、时间区间、筛选条件与排序方式。明确标签按 URL 路径段编码，去掉前导
#，不把普通搜索词随意变成标签。 - 提交并获取结果：按 MCP 调用契约 调用
social → tiktok_posts；取得 task_id 后查询状态，成功后获取结果。提交成功不等于已经取得作品；不得重复提交来代替查询。 - 去重、筛选与排序：按 字段、排序与洞察规则 整理。可使用
scripts/prepare_results.py生成基础清单和统计；其他筛选条件按同一契约补充，不能忽略用户条件。 - 形成洞察并交付：结合真实文案与样本统计生成 insights.md，明确样本量和时间范围；返回文件及关键发现。任务未结束时保存 task_id 与状态，交付已完成部分，不虚称完成。
实际调用的工具
| 用途 | MCP 工具与路由 | 参数 |
|---|---|---|
| 采集标签页或探索页作品 | mcp__ai_tool_center__social → tiktok_posts |
task、target_tool、arguments.url、arguments.num_of_posts |
| 查询采集任务状态 | mcp__ai_tool_center__task → scraper_task_status |
arguments.task_id |
| 获取采集任务结果 | mcp__ai_tool_center__task → scraper_task_result |
arguments.task_id |
num_of_posts 传字符串，例如 "20"，不要传数字。 tiktok_posts 是 social 工具的 target_tool 值，不是独立注册的 MCP 工具名。请求示例、真实返回结构和异步状态处理详见调用契约。
