酷特海外运营平台报表查询

要解决什么问题

海外运营团队在复盘营销投放、客户转化和分组业绩时，往往要在多个微服务里分别查接口：活动花费、客户汇总、订单分页、优惠券核销、分组客单与客单价等。人工拼 URL 和请求体容易漏字段，也容易把「导出」类写操作混进只读分析流程。

本技能把 kutetailor 正式环境（https://www.kutetailor.com/api）上已文档化的报表查询动作收敛成一张动作表，让 Agent 用统一参数模型（如 BusinessReportRequest、OrderReportTimeParam）发起 GET/POST 只读请求，直接拿到后端返回的统计结构，而不是在对话里臆造数字。

技能如何工作

技能按 action 映射到具体路径，例如：

• marketing_campaign_report：GET /campaign-group/reportMarketingCampaign，营销活动花费报表
• customer_report / customer_order_report：客户报表与客户订单分页报表
• coupon_report：按 day、userId 查优惠券报表
• group_*_report：分组维度下的消费数、客单数、客单价
• query_sales：营销活动销售查询（MarketingCampaignSalesRequest）

另有 all_customer_by_user，按用户维度拉取其下客户报表信息。接口来源对应 rcmtm-cloud-marketing、rcmtm-cloud-customer、rcmtm-cloud-coupon、rcmtm-cloud-order 等模块（详见 doc/interface-list.md）。

边界与注意点

• 只读 BI：不调用导出文件接口；答案必须以接口返回为准。
• 权限在后端：财务或客户敏感报表由服务端鉴权决定可见范围，技能不绕过权限。
• 分组类报表 Query 里月份字段在文档中写作 mouth，对接时需与后端约定保持一致。