【小题XT】抖音互动数采集
给出一条或多条抖音视频链接，或一张含视频链接的飞书表格，采集作品的点赞、收藏、评论、分享等互动数，整理成结果表；也可以按要求将数据写回飞书对应行。
能帮你做什么
| 你的需求 | 这个 Skill 会做什么 |
|---|---|
| 投放结束，要回收达人视频数据 | 逐条采集指定视频的互动指标，保留作品链接、采集时间和采集状态 |
| 飞书表里已有视频链接 | 读取指定表格中的抖音视频链接，整理数据回收结果 |
| 表里有点赞、收藏、评论等空列，需要补齐 | 按你要求采集指标，写回对应行并回读核对 |
| 上次有几条采集失败，需要继续 | 复用本次任务已成功的结果，只继续失败或未执行的条目；要求刷新时重新采集 |
你需要提供什么
提供一条或多条抖音视频链接，也可以粘贴包含链接的分享文案；或提供一张链接列中包含抖音视频链接的飞书电子表格／多维表格。想采集特定指标可直接说明，例如“只要点赞、收藏和评论”；需要更新原表时说明“写回原表”。
能拿到哪些数据
| 数据 | 说明 |
|---|---|
| 点赞、收藏、评论、分享数 | 默认采集的互动指标，可按你指定的指标采集 |
| 标题、作者、作品类型、发布时间 | 接口有返回时一并整理，便于识别作品 |
| 作品链接、原表行号或记录 ID | 保留来源，便于追溯及对应回填 |
| 采集时间、成功／失败状态、失败原因 | 说明数据采集时间及未完成情况 |
| 播放量 | 仅在接口实际提供时记录，不保证每个作品都能取得 |
所有数据以接口实际返回为准。未取得的指标留空并注明，不填成 0，也不推算。
最后交付什么
- 默认交付结果表：CSV 可用 Excel 打开，同时保留 JSON 数据和来源映射；需要 Excel 文件时可要求 XLSX。
- 按要求写回飞书：将结果填入已确认的目标列，完成后回读核验。未要求写回时只读取原表并交付结果文件。
- 采集说明：报告处理数量、成功数量、失败条目及缺失指标，并提供文件或表格位置。
可以直接这样用
> 帮我采集这些抖音视频的点赞、收藏和评论，整理成 Excel。
> [粘贴视频链接]
> 读取这个飞书表格里的抖音视频链接，采集赞评藏转，导出结果表。
> [粘贴飞书表格链接]
> 把这个表里每条视频的点赞、收藏、评论更新一下，写回原来的对应列。
> [粘贴飞书表格链接]
使用前需要准备
- 采集作品数据：当前 Agent 必须配置并能实际使用小题
ai-tool-centerMCP。 - 读取或写回飞书：还需要安装
lark-cli、完成登录，并拥有目标表格的访问权限。直接提供作品链接并只导出文件时无需飞书 CLI。
本 Skill 只处理用户提供的抖音视频，不按关键词搜索作品，不扩展为全账号采集、账号诊断或媒体下载。默认只采集评论数；评论正文仅在用户提出并明确页数范围后采集。
以下为 Agent 执行规则。上面的能力介绍不改变执行顺序：第一步始终检查小题 MCP，未通过时不读取飞书、不访问视频链接。
小题 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：严格执行上面的强制闸门；工具已实际可用时直接继续，不重复询问配置。
- 确定输入与范围：有作品链接就直接建立清单；有飞书链接就先按 飞书 CLI 读取与回填 检查 CLI、登录与表类型，再读取真实链接。输入缺失时只问用户要作品或表格链接。
- 去重并逐条采集：执行 采集执行细则，保留全部原表位置。只抓用户指定范围；条目失败记录原因，不拿搜索结果或估计值替代。
- 整理与交付：按 结果字段与验收 处理缺失值和状态。用户已要求回填时直接在授权范围内写入并回读；落点不明确时先准备结果，再询问目标列。
实际调用的工具
所有作品数据工具均来自 ai-tool-center，参数与返回处理详见 MCP 工具契约。
| 输入 | 工具 | 关键参数 |
|---|---|---|
| 抖音视频链接 | mcp__ai_tool_center__fetch_content_detail |
request.link、request.plant="dy" |
| 已确认的抖音 videoId | mcp__ai_tool_center__get_dy_video_detail |
request.videoId（字符串） |
工具名称与参数以当前 Agent 注册的 Schema 为准；缺少必需工具时报告能力不可用。不得用浏览器、HTTP 脚本或其他爬虫绕过 MCP。
