用途：通过 Kalodata 数据源完成 TikTok Shop 商品的两步查询——先浏览商品排行榜，发现热销与高排名商品；再用 productId 拉取单个商品详情。适用于 TikTok 商品榜单、热销榜、爆品排行、选品榜单及商品价格/销量查询场景。
主要能力：排行榜端点按 region、dateRange、currency、language 及可选 sortField 过滤，返回分页榜单，每行含商品 ID、名称、单价、销量（字段名 sales_volumn）、销售额及其视频/直播/橱窗渠道拆分、销售额增长率、佣金率、上架日期。详情端点按 productId 返回价格区间、销量、销售额（渠道拆分）、佣金率、上架日期、评论数、类目层级、所属店铺及相关视频/直播/达人数量。两端点数据可能存在 T+1 统计延迟。
使用方式：API 端点为 POST /kalodata/product/rank 或 POST /kalodata/product/detail。也可用脚本：python scripts/kalodata_product_search.py '<JSON 参数>' [--inline] 或 python scripts/kalodata_product_detail.py '<JSON 参数>' [--inline]。示例参数：{"region":"US","dateRange":"last7Day","pageSize":20,"pageNumber":1,"currency":"USD"}；详情示例：{"productId":"1729508370969629931","region":"US","dateRange":"last7Day","currency":"USD"}。完整参数与错误码见 references/api.md。响应默认落盘到 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下，大于 8 KB 时 stdout 仅输出摘要，可用 --inline 强制全量打印。
限制：排行榜并非关键词搜索，只能按地区与时间窗口浏览榜单；详情必须提供 productId，无法仅凭商品名查找，需先从榜单 product_id 获取。pageNumber 限 1-5，pageSize 限 5-100；排行榜响应不含总数或页数。有效但为空的请求可能返回 errcode 200 且仍计费；上游瞬时错误可能返回 errcode 501，可用相同参数重试一两次，不要自动改参数。每次调用消耗 7.0 算力，需评估并提醒用户。未配置 API Key 或遇到 401/402、算力或余额不足提示时，按 references/onboarding.md 处理。视频/达人/店铺/直播等其他实体请用对应技能。