用途：通过 Kalodata 数据源完成 TikTok Shop 店铺的两步查询——浏览店铺排行榜以发现高表现店铺，或按 shopId 获取单个店铺的完整详情。需要排行榜、店铺发现或对比时用排名接口；已有 shopId 或已从排名结果中选定店铺时用详情接口。
主要能力：排名接口返回按地区、dateRange、language、currency 过滤的分页榜单，默认按营收（GMV）降序，每行含明确排名位次，字段包括 rank、shop_name、shop_id、shop_type、revenue、sales_volumn、on_sell_product_count、unit_price、revenue_growth_rate、self_promotion_revenue、affiliate_revenue、shopping_mall_revenue。详情接口按 shopId 返回店铺身份、规模、营收渠道拆分及达人/视频/直播数量，字段包括 shop_id、shop_name、seller_type、region、revenue、sales_volumn、product_number、unit_price、self_account_revenue、affiliate_revenue、shoppingmall_revenue、creator_number、video_number、live_number。
使用方式：调用 POST /kalodata/shop/rank 或 POST /kalodata/shop/detail，也可运行 python scripts/shop_detail.py '<JSON 参数>' [--inline]。需设置 NEXSCOPE_API_KEY。排名参数含 region、dateRange、pageNumber（1-5）、pageSize（5-100）、language、currency、sortField；详情必填 shopId，可选 region、dateRange、language、currency。脚本默认将完整响应写入工作目录下的 nexscope 日期/会话目录，响应体不超过 8 KB 时打印完整 JSON，超过则仅输出摘要，加 --inline 可强制完整输出。
适用场景：TikTok 店铺排行榜、地区热门店铺、按时间窗口的店铺排名、单店营收/销量/达人合作数查询。
限制：排名不是关键词搜索，仅按地区与时间窗口浏览榜单；详情必须提供 shopId，无法仅凭店名查找；排名响应不含总数/页数，需翻页至返回少于 pageSize 为止；两个接口字段名不同，不可混用；数据可能有 T+1 延迟；渠道拆分仅为近似值；同会话同参数默认只调用一次并有 24 小时本地缓存，失败或空结果时不应自动更换参数重试；上游瞬时错误可能表现为 errcode 501 与 Kalodata HTTP 554，可用相同参数重试一两次。非店铺实体请使用对应的商品/视频/达人/直播技能。