用途：该技能面向 TikTok 电商带货视频的数据检索，分两步使用。榜单接口用于发现高排名、高播放、热销的带货视频；详情接口用于在拿到 videoId 后查询单个视频的完整表现。
主要能力：榜单接口返回分页榜单，可按 region、dateRange、language、currency 及可选 GMV 范围 revenue_range 过滤，并用 sortField 按 revenue 排序。每行包含 video_id、video_title、views、digg_count/comment_count/share_count、revenue、revenue_growth_rate、广告字段（ad、ad_view_ratio、ad_revenue_ratio、ads_roas）及创作者信息（belonged_creator_id、belonged_creator_handle、creator_debut）。详情接口按 videoId 返回互动指标、变现指标、广告指标、创作者身份、地区、时长与关联商品数量，额外含 video_region、sales_volumn（注意拼写）、video_gpm、ads_views、ad_cpa、ads_period、duration、product_number。数据可能有 T+1 统计延迟。
使用方式：API 端点 POST /kalodata/video/rank 或 POST /kalodata/video/detail，完整参数与响应见 references/api.md。也可用脚本 python scripts/kalodata_video_search.py '<JSON 参数>' [--inline] 或 python scripts/kalodata_video_detail.py '<JSON 参数>' [--inline]。榜单 pageNumber 限 1-5，pageSize 限 5-100。详情必填 videoId，通常取自榜单的 video_id。脚本默认把完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ 下，响应体大于 8 KB 时 stdout 只输出摘要，可加 --inline 强制全量打印。
适用场景：查询 TikTok 视频榜单、热门或爆量带货视频排行、指定地区带货视频排行、单个视频详情及播放、互动、GPM 等指标。
限制：榜单不是关键词搜索，只能按地区与时间窗口浏览。详情必须有 videoId，无法仅凭标题查找。榜单响应不含总数或页数，结果数为 data.length。revenue 指 GMV，不是利润或广告花费。上游偶发错误可能表现为 errcode 501 与 Kalodata HTTP 554，可原参数重试一两次，不要自动改参数。非视频类实体请使用对应的 Kalodata 商品、创作者、店铺、直播技能。每次调用消耗 7.0 算力，频繁调用或用户预期不足时应先提醒。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401/402、提示算力或余额不足时，按 references/onboarding.md 处理。脚本带 24 小时本地缓存，同一会话同一参数默认只调用一次，失败或空结果不得自动换词、翻页试探。