用途：通过 Kalodata 数据源完成 TikTok 带货直播的两步查询——浏览直播排行榜发现高表现直播，或用 livestreamId 获取单场直播的完整表现数据。有榜单需求（直播榜、热销直播、按地区/时间筛选排名）时用榜单端点；已有 livestreamId 或已从榜单选定一场直播时用详情端点。
主要能力：榜单端点 /kalodata/livestream/rank 返回分页排行榜，默认按营收（GMV）降序，可按 region、dateRange、language、currency、category_id、shop_id、creator_id、product_id、followers_range、sortField 过滤，分页参数 pageNumber（1-5）与 pageSize（5-100）。每行含 livestream_id、标题、创作者 ID/账号、起止时间（epoch 毫秒）、时长（秒）、营收、客单价、views、record_type 等字段。详情端点 /kalodata/livestream/detail 需必填 livestreamId，返回单个直播的完整明细，含 viewers、数值型 revenue、gpm、product_number 等。
使用方式：可调用 API 端点，或用 Python 脚本 python scripts/kalodata_livestream_search.py '<JSON 参数>' [--inline]（榜单）、python scripts/kalodata_livestream_detail.py '<JSON 参数>' [--inline]（详情）。结果默认写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下的 JSON 文件；响应超过 8 KB 时 stdout 只输出摘要，可用 --inline 强制全量打印，建议用 jq 或 ConvertFrom-Json 按需抽取字段。认证依赖环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY，出现 401/402 或余额不足提示时参考引导文档处理。每次调用消耗 7.0 算力，用户为此付费，高频调用前应提醒。
适用场景：按地区与时间窗口查看 TikTok 带货直播排行、查看某场直播的销售额/观看人数/时长/GPM/带货商品数。
限制：榜单不是关键词搜索，仅按区域与时间浏览排行榜；详情必须提供 livestreamId，无法仅凭标题查找；榜单最多 5 页，页码越界返回 errcode 501，pageSize 需在 5-100；两个端点均无 total 或页数字段；字段名与类型不一致（榜单用 views、营收为字符串并含 unit_price；详情用 viewers、营收为数字并含 gpm、无 unit_price）；数据可能存在 T+1 统计延迟；上游偶发 501 错误可同参数重试一两次，不要改参数；不支持的 sortField 不应绕行，应告知用户并回退默认排序；非直播类实体（创作者/商品/视频/店铺）需使用对应的 Kalodata 技能。