用途：通过 Kalodata 数据源完成 TikTok 电商直播的两步查询流程——先浏览 TikTok Shop 直播排行榜，发现表现最好的可购物直播；再用 livestreamId 获取单场直播的完整表现详情。需要排行榜、热门直播或直播发现时用排行榜接口；用户已有 livestreamId 或已从排行榜选中某场直播时用详情接口。
主要能力：排行榜接口按 region、dateRange、language、currency 及可选 sortField 返回分页榜单，默认按营收（GMV）降序，字段含直播 ID、标题、达人 ID/handle、起止时间、时长、revenue、unit_price、views 等；详情接口按 livestreamId 返回单场直播的 12 个字段，含 viewers、数值型 revenue、gpm、product_number。两个接口字段名与类型不同：详情用 viewers，排行榜用 views；详情 revenue 为数字，排行榜 revenue 为字符串；详情有 gpm 无 unit_price，排行榜有 unit_price 无 gpm，不可混用。两接口均可能有 T+1 统计延迟。
用法：接口为 POST /kalodata/livestream/rank 与 POST /kalodata/livestream/detail；脚本命令 python scripts/livestream_detail.py '<JSON参数>' [--inline]。排行榜参数均为可选，pageNumber 限 1-5，pageSize 限 5-100；详情必填 livestreamId（通常取自排行榜的 livestream_id）。需设置 NEXSCOPE_API_KEY。结果默认写入工作目录 nexscope 日期/会话/data 下的 JSON 文件，超过 8 KB 时 stdout 只输出摘要，可加 --inline 强制完整输出；建议先用摘要，再用 jq 按需提取。
限制：排行榜不是关键词搜索，只能按地区/时间浏览榜单；详情必须提供 livestreamId，无法仅凭标题查找；两个响应均无总数/页数，需翻页直至某页返回少于 pageSize；同会话同参数默认只调用一次并本地缓存 24 小时，失败或空结果不要自动换条件重试；不支持时告知用户并回退默认排序；非直播实体（达人/商品/视频/店铺）应使用对应 Kalodata 技能。