用途：该技能用于 TikTok 电商带货视频的数据查询，分两步工作流——浏览 TikTok Shop 视频排行榜以发现高表现带货视频，或按 videoId 获取单个视频的完整表现详情。需要排名、热门视频、爆款视频或视频发现时用搜索端点；已有 videoId 或从排名结果中选定某视频时用详情端点。
主要能力：排名端点返回按 region、dateRange、language、currency 及可选 sortField 过滤的分页榜单，每行含视频标识、互动、收入、广告表现与达人字段，分页参数 pageNumber（1-5）、pageSize（5-100）。详情端点按 videoId 返回单个带货视频的互动指标、变现指标、广告指标、达人身份、地区、时长及关联商品数。videoId 通常来自排名响应的 video_id 字段。两个端点可能存在统计延迟（T+1）。
使用方式：API 端点为 POST /kalodata/video/rank 或 POST /kalodata/video/detail；也可用 Python 脚本 python scripts/video_rank.py '<JSON参数>' [--inline] 或 python scripts/video_detail.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY，积分管理见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件；响应体不超过 8 KB 时打印完整 JSON，超过则仅输出摘要，加 --inline 可强制完整输出。
限制：排名不是关键词搜索，仅按地区与时间窗口浏览榜单；详情必须提供 videoId，无法仅凭标题查找；排名响应不含总数/页数，结果数为 data.length；pageNumber 限 1-5，pageSize 限 5-100。该工具消耗积分，同一会话相同参数组合默认只调用一次，脚本有 24 小时本地缓存；失败或空结果时不要自动更换关键词、分页或筛选重试，需先告知用户。上游瞬时错误可能表现为非零平台码，可用相同参数重试一两次，不要自动改参数。非视频实体请使用对应的 Kalodata 商品/达人/店铺/直播技能。