用途：该技能面向 TikTok Shop 商品分析，提供两步工作流——浏览商品排行榜以发现高排名、热销商品，以及按 productId 获取单个商品的完整详情。需要排行榜、热销或选品发现时用排名接口；已有 productId 或从排名结果中选定商品时用详情接口。
主要能力：排名接口返回按 region、dateRange、currency、language 及可选 sortField 过滤的分页榜单，每行含商品标识、价格、销量、收入（按视频/直播/橱窗渠道拆分）、收入增长率、佣金率和上架日期。详情接口返回价格区间、销量、收入（含渠道拆分）、佣金率、上架日期、评论数、类目层级、所属店铺及关联视频/直播/达人数量。数据可能存在 T+1 统计延迟。
使用方式：接口为 POST /kalodata/product/rank 与 POST /kalodata/product/detail；也可用 Python 脚本 python scripts/product_detail.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY。排名参数 region 默认 US，pageNumber 限 1-5，pageSize 限 5-100。详情必填 productId，通常取自排名返回的 product_id。脚本默认将完整响应写入工作目录下的 JSON 文件，超过 8 KB 时仅输出摘要，可用 --inline 强制完整输出。
限制：排名不是关键词搜索，仅按地区和时间窗口浏览榜单；详情必须提供 productId，无法仅凭名称查找。排名响应不含总数或页数。有效但为空的请求可能返回 errcode 200 且仍计费。上游瞬时错误可能表现为 errcode 501，可原参数重试一两次，不要自动更改参数。该工具消耗额度，同一会话相同参数默认只调用一次并本地缓存 24 小时。非商品实体（视频、达人、店铺、直播）需使用对应技能。