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。混合输入结构示例:
{"videoIds":["7030893014180531462"],"videoUrls":["https://www.tiktok.com/@example/video/6768504823336815877"]}
示例仅演示格式,不代表视频存在或有数据。执行:
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 与输入匹配,不能依赖返回顺序。保留多批结果,逐个列出缺失记录的原输入;未返回不等于播放量或销量为零。
比较表现
读取 视频指标规则,按用户关注的指标生成每个视频一行的对比表。
- 概览展示文案、累计播放、点赞、评论、分享、估算销量、估算 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 错误指引处理;不索取来源平台密钥,不调用充值、余额检查或反馈接口。空结果或超时不自动改参数连续试探。当前结果不足以支持用户结论时,明确说明缺少什么。
读取业务字段
解释结果和构造后续请求前,读取 结果字段与业务衔接,按端点保留关键输出、嵌套指标和关联 ID。