用途：通过 Kalodata 数据源完成 TikTok 电商达人两步工作流——浏览达人榜单发现高表现 TikTok Shop 达人，或用 creatorId 查询单个达人的完整资料与业绩。需要排行榜、达人发现或对比时用榜单接口；已有 creatorId 或从榜单选中某达人时用详情接口。
主要能力：榜单接口返回按地区、时间范围、语言、币种筛选的分页榜单，默认按营收（GMV）降序，包含达人身份、受众、内容观看、销量、视频/直播营收及增长率。详情接口按 creatorId 返回身份、受众、营收构成、视频/直播指标、商品/店铺数量及联系方式。两接口可能存在 T+1 统计延迟。
使用方式：API 端点为 POST /kalodata/creator/rank 或 POST /kalodata/creator/detail；脚本为 python scripts/creator_rank.py '<JSON参数>' [--inline] 或 python scripts/creator_detail.py '<JSON参数>' [--inline]。需设置 NEXSCOPE_API_KEY，消耗积分；同一会话同一参数默认只调用一次，脚本本地缓存 24 小时。脚本默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-kalodata-tiktok-creator-<timestamp>.json，响应大于 8 KB 时仅输出摘要，可用 --inline 强制完整输出，或事后用 jq 按需提取。
适用场景：TikTok 达人排行榜、TikTok 带货达人榜、近 7 天达人榜、达人详情、达人主页数据、达人联系方式等查询。榜单接口支持 region、dateRange、pageNumber、pageSize、language、currency、category_ids、shop_id、revenue_range、creator_type、followers_range、engagement_rate、sortField 参数；详情接口必填 creatorId，可选 shop_id、category_ids、region、dateRange、language、currency。
限制：榜单不是关键词搜索，只能按地区和时间窗口浏览；详情必须提供 creatorId，不能仅凭昵称或 handle 查找；榜单响应不含总数/页数，需翻页至某页返回少于 pageSize 项；pageNumber 限 1-5，pageSize 限 5-100。失败或空结果时不要自动换关键词、翻页或改筛选条件重试，应告知用户；上游瞬时错误可同参数重试一两次，不要自动改参数。creator_followers 和 content_views 为字符串类型计数；销量字段拼写为 sales_volumn；联系方式字段常为空。非达人实体请使用对应的 Kalodata 商品/视频/店铺/直播技能。认证链接：https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。