用途：该技能基于 Kalodata 数据源提供 TikTok 电商直播的两步查询流程，用于发现热销直播和查看单场直播的完整表现数据。
主要能力：
- 直播排行榜（POST /kalodata/livestream/rank）：分页返回按地区、时间范围、语言、币种等过滤的直播榜单，可选 sortField，默认按收入（GMV）降序。行字段含 livestream_id、标题、创作者、起止时间、时长、revenue（字符串）、unit_price（字符串）、views 等。结果用 pageNumber（1-5）与 pageSize（5-100）分页，无总数。
- 直播详情（POST /kalodata/livestream/detail）：按 livestreamId（必填，通常取自榜单的 livestream_id）返回单场直播完整详情，含 viewers、revenue（数字）、gpm、product_number。无分页。
使用方式：可调用上述 HTTP 接口，或用脚本 python scripts/livestream_rank.py '<JSON参数>' [--inline] 与 python scripts/livestream_detail.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY。同一参数组合默认只调用一次，脚本有 24 小时本地缓存；响应写入工作目录的 nexscope 目录，超过 8 KB 时 stdout 仅输出摘要，加 --inline 可强制完整输出。读取时建议先用摘要，再用 jq 或 ConvertFrom-Json 提取字段。
注意：两接口字段名与类型不同（RANK 用 views，DETAIL 用 viewers；RANK 的 revenue 为字符串，DETAIL 为数字；gpm 仅 DETAIL 有，unit_price 仅 RANK 有），不可混用。榜单最多 5 页，无总数。数据可能有 T+1 延迟。上游偶发瞬时错误可用相同参数重试一两次，不要更改参数；不支持的排序或过滤应告知用户并回退默认顺序。
适用场景：TikTok Shop 直播榜单浏览、区域/时间筛选的热门直播发现、已知 livestreamId 的单场直播指标查询（收入、观看、时长、GPM）。不适用：按关键词搜索直播、仅凭标题查详情、其他平台直播数据、创作者/商品/视频/店铺等非直播实体查询、TikTok 广告投放或内容创作。该工具消耗 credits。更多请求与响应细节见 references/api.md。