KaloData 电商洞察

解决什么问题

手动分析 TikTok Shop 数据通常需要在后台反复筛选，难以快速对比商品、店铺、达人、视频、直播和类目的排行与变化。该技能将 KaloData 的电商分析能力封装为命令行工具 kalo，让你在终端中直接查询排行榜与明细。

核心能力与工作方式

技能自带 scripts/kalo.py，仅依赖 Python 3.11+ 标准库，无需额外安装。首次查询前先运行 kalo config 检查 api_key，通过 kalo config set --key 或环境变量 KALODATA_API_KEY 配置凭证。

主要命令包括：

• 商品：kalo product rank 获取商品榜，kalo product detail 查看价格区间、店铺 ID 和营收趋势。
• 店铺：kalo shop rank 按品牌或零售商筛选，kalo shop detail 查看营收构成与爆款商品。
• 达人：kalo creator rank 按粉丝量、互动或带货商品筛选，kalo creator detail 获取联系邮箱和 GPM。
• 内容：kalo video rank、kalo video detail、kalo live rank、kalo live detail 分别覆盖短视频与直播数据。
• 类目：kalo category search、kalo category rank、kalo category detail 用于类目下钻。

列表命令统一支持 --region、--range、--page、--limit、--sort、--fields 等参数，地区覆盖 US、GB、ID、TH 等多个站点，时间范围支持 last7Day、last30Day 或自定义区间。默认输出 TOON 格式，追加 --json 可获取原始 JSON。错误信息会输出可操作提示，退出码区分成功、错误与用法问题。

适用边界与注意点

使用前需拥有 KaloData API key，且每次查询都会消耗 API 额度：基础查询约 0.2–0.4，分析或诊断类 playbook 可能消耗 1–2。涉及批量抓取或 playbook 时，建议先用 kalo credit 查看剩余额度。复杂分析任务需要阅读 references/playbooks.md，并遵循同行基准对比的要求，避免得出无参照的结论。达人 handle 匹配为模糊匹配，使用前需核对返回的 creator_handle。