蝉妈妈电商数据查询

解决的问题

调用蝉妈妈数据接口时，真实任务往往不是单次查询，而是要连续完成鉴权、名称转 ID、主实体判断、字段拼装和结果解释。若把达人名、商品名、店铺名直接当成 ID 传入，或把 1000W+ 当成精确数值合计，都会得到错误结论。

技能如何工作

• 权限与版本：先调用 permission/list 检查 CMM_API_KEY、会员版本、可用模块和数据周期，避免在无权模块上反复试错。
• 实体解析：只有名称时，先用通用搜索得到 author_id、promotion_id、shop_id、brand_code 或 aweme_id。
• 选择参考文档：按主查询实体读取 product.md、author.md、shop.md、brand.md、live.md、video.md 或 category.md。
• 执行查询：按 API 字段构造 api 和 query，使用 scripts/call_cmm_api.py 发起请求，并在 code != 0 时透出 msg。
• 解释指标：对销售额、销量等区间值保留原始字符串，只做排序或高低判断，不做加减乘除。

适用边界

数据通常是 T+1，“近 7 天”的结束日期应设为昨天。榜单、周期合计、画像和明细字段依赖会员权限；平台返回的是区间值，不适合作为财务口径精确加总。