用途：通过 Kalodata 数据源查询 TikTok 电商带货视频数据，支持两步流程——浏览 TikTok Shop 视频排行榜发现高表现带货视频，或按 videoId 获取单条视频完整表现详情。需要排行榜、热门/爆款视频发现时用搜索端点；已有 videoId 或从榜单选定视频时用详情端点。
主要能力：排行榜端点返回按 region、dateRange、language、currency 及可选 sortField 过滤的分页榜单，每行含视频标识、互动、收入、广告表现与达人字段；分页参数 pageNumber 限 1-5，pageSize 限 5-100。详情端点按 videoId 返回单条带货视频的互动、变现、广告指标、达人身份、地区、时长及关联商品数。videoId 通常取自榜单返回的 video_id 字段。两个端点均可能存在统计延迟（T+1）。
使用方式：调用 POST /kalodata/video/rank 或 POST /kalodata/video/detail；也可用 Python 脚本 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 可强制完整输出。同一会话相同参数组合默认只调用一次，脚本本地缓存 24 小时；失败或空结果时不要自动更换关键词、分页或筛选重试，应先告知用户。
适用场景：TikTok 视频排行榜、热门/爆款视频、地区带货视频榜单、单条视频详情、视频播放与互动数据、视频 GPM 等。
限制：排行榜不是关键词搜索，仅按地区与时间窗口浏览榜单；详情必须提供 videoId，无法仅凭标题查找；榜单响应不含总数/页数，结果数为 data.length；上游瞬时错误可能表现为 errcode 501 与 Kalodata HTTP 554，可用相同参数重试一两次，不要自动改参数；非视频实体请使用对应的 Kalodata 商品/达人/店铺/直播技能。展示时需标注 dateRange、region、currency，字段名 sales_volumn 保持原拼写，video_gpm 为千次播放 GMV，不应显示为百分比。