---
name: compare-tiktok-video-performance
description: 根据已知 TikTok 视频 ID 或直链批量查询并比较播放、点赞、评论、分享、收藏、近 1/7/30 天增量、估算销量和 GMV、达人及关联商品。适用于“分析这些视频”“比较这些链接的表现”；不用于发现热门视频、下载视频或达人店铺研究。
compatibility: Requires the oo CLI and access to OOMOL Marketplace LinkFox capabilities.
metadata:
  title: TikTok 视频表现对比
  icon: ':lucide:chart-no-axes-combined:'
  packageName: "@leina/compare-tiktok-video-performance"
  version: "0.1.0"
---
# TikTok 视频表现对比

## 固定使用内置市场

所有业务动作明确使用 `--connection-name marketplace_oomol`，不能省略，也不能替换为用户自建 LinkFox 连接。首次在当前账户/团队执行时，读取 `oo connector apps linkfox --json`，确认 `connectionName=marketplace_oomol`、`authType=marketplace` 且状态可用；用户指定团队时，连接列表和业务命令使用同一个 `--team`。

未找到该市场连接或无权使用时，停止并报告内置市场不可用。不得改用户默认连接，不得退回无选择器命令、其它连接或直连来源接口。`oo file upload/download` 是文件中转命令，不属于 LinkFox 连接选择。

## 整理已知视频

至少取得一个有效视频 ID 或 TikTok 视频直链。保留 ID 为字符串，去重并保存原输入到视频 ID 的对应关系。支持 `videoIds` 和 `videoUrls` 两个字符串数组，可同时提供。

URL 使用包含数字视频 ID 的标准 TikTok 路径，例如 `/@账号/video/数字ID` 或 `/video/数字ID`。用 URL 解析器检查 TikTok 主机和路径，再提取 ID；短链、用户主页、无法明确 ID 的地址要求补充直链，不猜测或通过重复业务调用试探。

每批合并去重后最多 1000 个视频；两个数组也各不超过 1000。超出时按用户已要求查询的范围分批，保留每批输入和成功响应，不重跑已完成批次。至少一个数组非空；公开 schema 没有完整表达这一跨字段条件，不能把空对象通过格式检查当作有效业务请求。

## 查询

将真实 ID/直链写入 `video-query.json`。混合输入结构示例：

```json
{"videoIds":["7030893014180531462"],"videoUrls":["https://www.tiktok.com/@example/video/6768504823336815877"]}
```

示例仅演示格式，不代表视频存在或有数据。执行：

```bash
oo connector run linkfox --connection-name marketplace_oomol --action get_echotik_videos --data @video-query.json --json
```

视频数组是 `response.data.videos`，返回数量为 `response.data.total`。每条记录预期包含 `videoId`；按 ID 与输入匹配，不能依赖返回顺序。保留多批结果，逐个列出缺失记录的原输入；未返回不等于播放量或销量为零。

## 比较表现

读取 [视频指标规则](references/video-metrics.md)，按用户关注的指标生成每个视频一行的对比表。

- 概览展示文案、累计播放、点赞、评论、分享、估算销量、估算 GMV、发布日期和达人；需要时增加近期增量、收藏及视频属性。
- 时间窗必须一致：累计指标与近 1/7/30 天增量分列，不能把 7 天增量再与 30 天增量相加。
- 按所选指标排序时，仅排序有有效数据的记录；缺失值单列说明。销量和 GMV 均标为估算，不据此声称精准归因或未来效果。
- GMV 未给出明确币种与金额单位时，展示原值并标“币种/单位未提供”，不自动除以 100，也不跨币种合计。
- 原视频使用 `officialUrl` 链接，封面使用返回的 `coverUrl`；这里不解析视频下载地址。
- 结果说明请求的唯一视频数量、返回数、成功匹配数和缺失项；如果缺少有效 `videoId`，说明无法完成逐条匹配，不猜映射。
- 需要导出时，保存 CSV 对比表或 Markdown 报告并提供可点击路径，保留查询时间、时间窗、估算标记和原视频链接。

## 调用与证据边界

业务调用需要 oo CLI 和当前 OOMOL 账户/团队的市场访问权限。用 JSON 文件传参，保留成功响应和查询时间到本次任务输出目录，不覆盖其他任务文件。CLI 业务结果在 `response.data`，执行标识在 `response.meta.executionId`。

本技能已静态核对，未真实试跑。公开 schema 声明的结果容器之内，业务字段依据来源包说明和 Connector 透传实现，不能当作每次必定返回的字段。读值前检查类型，缺失或 null 显示“未提供”，不补零、不猜路径，也不把缺少字段解释为业务事实不存在。

命令失败时报告实际错误并保留已取得的数据。鉴权、权限或余额阻塞时按 OOMOL 错误指引处理；不索取来源平台密钥，不调用充值、余额检查或反馈接口。空结果或超时不自动改参数连续试探。当前结果不足以支持用户结论时，明确说明缺少什么。

## 读取业务字段

解释结果和构造后续请求前，读取 [结果字段与业务衔接](references/result-fields.md)，按端点保留关键输出、嵌套指标和关联 ID。