前言¶
做 TikTok Shop 选品、达人合作或竞品分析时，数据大多散落在 KaloData 后台的各类榜单里：想查某个类目的热销商品，要手动翻商品榜；想评估一个达人的带货能力，要对比 GPM、视频和直播营收占比；想导出某个月的品类趋势，只能靠截图或手动抄表。
kalodata_tiktok电商数据查询这个 Skill 把 KaloData 的查询能力包成一组命令行工具，用 bundled kalo CLI 直接调用，覆盖商品、店铺、达人、视频、直播、品类六大维度。下面介绍它的能力、用法和适用边界。
这是什么¶
这是 SkillHub 上由 @user_69885abb 发布和维护的社区 Skill，版本 1.0.1，分类 data-analysis，需要 API Key（requires_api_key=true）。
它解决的问题是：让 Agent 不用打开浏览器、不用手动翻 KaloData 后台，就能按站点、时间范围、排序和筛选条件查询 TikTok Shop 的电商数据，并把结果用于选品调研、达人挖掘、竞品诊断等分析任务。
核心功能¶
六大分析场景¶
Skill 提供了六类预置分析能力：
- 商品诊断：针对“某个商品为什么卖不动”这类问题，做同品类同价位对标、相对位置评估和增长归因。
- 达人诊断：针对“@xxx 的带货能力怎么样”，给出 GPM、视频/直播营收占比、同层级对标。
- 品类选品调研：回答“某站点某类目有什么机会”，输出品类健康度、价格带分布、Top 商品/店铺聚合。
- 达人推荐：按品类、粉丝量、营收、互动率筛选，输出候选达人清单。
- 爆款视频方法论：拆解爆款视频共性，给出 3 套高转化脚本模板。
- 分镜脚本撰写：根据需求写出可直接拍摄的场景化分镜脚本，这一步是纯写作，不消耗 API 额度。
数据查询命令¶
除预置分析外，Skill 提供细粒度查询命令：
product rank / product detail 商品销量、营收排行与详情（价格区间、店铺 ID、营收趋势）
shop rank / shop detail 店铺排行与详情（营收构成、Top 商品）
creator rank / creator detail 达人排行与详情（联系方式、GPM、趋势），另有 creator images 批量取头像
video rank / video detail 带货视频排行（支持 AI 标签筛选）与完整指标
live rank / live detail 直播排行与详情（观看人数、GPM、带货商品）
category rank / category detail / category search 品类排行、详情与关键词查品类 ID
覆盖范围¶
覆盖 15 个 TikTok Shop 站点：US、GB、ID、TH、VN、PH、MY、SG、JP、MX、DE、IT、FR、ES、BR。
时间范围支持近 7 天、近 30 天、指定月份、自定义日期区间；排序维度支持营收、销量、增长率、互动率、GPM 等；筛选条件支持价格区间、粉丝区间、品类、关键词、店铺类型、达人类型等。
安装与启用¶
官方 SkillHub 页面：https://www.skillhub.cn/skills/user_69885abb/kalo-data-query-skill
在已抓取的官方资料中，没有给出具体的安装命令或配置文件路径。根据官方资料，该 Skill 由 kalo CLI（Python，zero install）驱动，需要 KaloData 的 API Key 才能调用数据接口。使用时请以 SkillHub 页面和 Skill 包内说明为准，确认 API Key 的配置方式。
典型用法¶
下面三个工作流来自官方资料，可以按顺序执行。
选品调研¶
1. category search 用关键词查品类 ID
2. category detail 检查品类健康度
3. product rank 拉取该品类商品排行
4. product detail 对候选商品批量取详情
5. shop rank / shop detail 聚合分析相关店铺
达人挖掘¶
1. category search 确定目标品类
2. creator rank 按粉丝量、品类等条件筛选达人
3. creator detail 逐个取达人详情（含邮箱等联系方式）
4. 输出合作清单
爆款视频拆解¶
1. video rank 拉取品类带货视频排行
2. video detail 取爆款视频的完整指标
3. 共性提取 归纳标题、时长、话术等特征
4. 生成脚本模板 套用 Skill 提供的脚本模板输出新脚本
适用场景与注意¶
适合 TikTok Shop 卖家、跨境电商运营、MCN 机构、品牌方和数据分析师。常见用法是选品调研、达人筛选、竞品诊断、爆款视频分析。
几点注意：
- 数据来自 KaloData，实际可查范围和字段以其接口为准。
- 所有查询按 API 额度计费，分镜脚本撰写除外。
- 需要自备 KaloData API Key，Skill 的调用权限取决于该 Key 的套餐。
- 站点和指标口径以 KaloData 定义为准，跨境站点之间不能直接对比绝对值。
结尾¶
这个 Skill 的价值在于把 KaloData 的电商数据查询和分析流程标准化成可被 Agent 调用的命令序列，减少手动翻后台和整理数据的时间。如果工作涉及 TikTok Shop 选品、达人或竞品分析，可以把它作为数据入口。
官方地址：https://www.skillhub.cn/skills/user_69885abb/kalo-data-query-skill
