用途:KaloData 提供 TikTok Shop 电商数据分析,通过本技能内置的 kalo CLI 查询商品、店铺、达人、视频、直播和类目的榜单与详情。
主要能力:product/shop/creator/video/live/category 的 rank(榜单)与 detail(详情);另有 product comments(评论洞察:痛点、好评、使用场景)、product specs(卖点与规格,--lang zh-CN 可翻译)、product images、creator images、video url(可播放 mp4)、category search(按关键词查类目 id)、credit(余额,免费)、credit logs(免费)等。
使用方式:命令形如 python3 <this-skill-dir>/scripts/kalo.py product rank --region US;下文以 kalo 代指该脚本。输出为 TOON 文本,加 --json 返回原始 JSON;错误在 stdout 结构化提示,退出码 0 成功、1 错误、2 用法问题。首次查询前先运行 kalo config 查看 api_key,若缺失不要猜测密钥也不要重试,引导用户在 https://www.kalodata.com/open-center/account 登录并生成密钥(无账号先在 https://www.kalodata.com/open-center/home 注册;若已按积分计费调用 KaloData API,同一密钥可用),再用 kalo config set --key <API_KEY> 保存到 ~/.config/kalodata/config.toml(权限 0600),或设置环境变量 KALODATA_API_KEY。
计费:每次查询消耗 KaloData 积分。榜单/详情查询 0.2,商品图片 0.01,达人图片 0.1,商品规格 0.1,视频 URL 0.5,商品评论每次缓存刷新 1,余额与积分日志免费。余额用 kalo credit 查看,充值见 https://www.kalodata.com/pricing。若一次请求会展开为多次调用,需先告知积分成本。
常见筛选:所有列表命令支持 --region --range --page(1-5)--limit(5-100)--sort --asc --fields --json;区域包括 US GB ID TH VN PH MY SG JP MX DE IT FR ES BR;时间范围如 last7Day、last30Day、yyyy-MM 或 yyyy-MM-dd~yyyy-MM-dd;数值范围写为 "min-max"。
限制:签名媒体 URL(商品图片、达人图片、视频 URL)约 5 分钟后过期,须立即交给用户或下载,不可缓存。达人详情中 handle 匹配为模糊匹配,需核对返回的 creator_handle。复杂分析(商品/达人诊断、类目选品、达人推荐、爆款视频方法论、分镜脚本)应先阅读 references/playbooks.md 并遵循其强制步骤,对比同类目、同价位、同粉丝层级的对手后再下结论。各命令详细参数见 kalo <command> --help。其他未在资料中说明的信息暂未提供。