用途：通过 Kalodata 数据源处理 TikTok Shop 店铺（小店）相关的两步流程——先浏览店铺排行榜发现高表现店铺，再按 shopId 查询单个店铺完整详情。适合 TikTok 店铺榜单、店铺排行、热销店铺、指定店铺资料、销售额/销量/达人合作数查询等场景。不适用于 TikTok 达人/商品/视频/直播榜单或详情，也不适用于 Amazon、Shopify、1688 等其他平台店铺数据。
主要能力：排行榜端点按地区、dateRange、语言、货币筛选，默认按 GMV 降序返回带明确名次的分页榜单；详情端点按 shopId 返回店铺身份、规模、收入渠道拆分及达人/视频/直播数量。排行榜字段含 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。详情字段含 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。两端点字段名不同，不可混用；数据可能有 T+1 统计延迟。
使用方式：API 端点 POST /kalodata/shop/rank 或 POST /kalodata/shop/detail；脚本 python scripts/kalodata_shop_search.py '<JSON 参数>' [--inline] 或 python scripts/kalodata_shop_detail.py '<JSON 参数>' [--inline]。详情需 shopId，通常取自排行榜返回的 shop_id。认证通过环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY，未配置或遇 401/402、余额不足提示时按 onboarding 文档处理。
限制：排行榜是榜单浏览而非关键词搜索；详情无法仅凭店铺名查找；排行榜无总页数，pageNumber 限 1-5、pageSize 限 5-100；收入渠道拆分是近似值而非精确等式；同一会话同参数默认只调用一次，脚本带 24h 本地缓存，每次调用消耗 7.0 算力并产生费用，需提醒用户。上游临时错误可能表现为 errcode 501 与 Kalodata HTTP 554，可用原参数重试一两次，不要自动改参数。