微赞直播

要解决什么问题

在微赞上做直播带货，运营侧经常要在话题生命周期、实时在线、订单履约和退款核销之间来回切后台。官方是 REST API，但鉴权、各接口时间字段格式不一致（毫秒、秒、日期串混用）、Windows 下用 shell 调中文参数容易乱码，还有退款、发货、结束直播等不可逆或涉及资金的操作，若 Agent 直接发请求风险很高。

技能如何工作

本 Skill 用 Node.js 脚本（vzan-token.js / vzan-api.js）统一拿 Token 并 POST JSON，避免把中文参数丢进 CMD。VZAN_ACCOUNT 与 VZAN_SECRET 走环境变量，不在对话里回显密钥。接入后可用 --check 做鉴权自检；业务调用按模块查 references/ 下的参数表（topic / live / shop / coupon）。

典型能力包括：创建与结束话题、开播盯盘（在线人数 / 峰值 / 状态）、直播大盘与交易趋势、订单列表与物流、退款与核销、优惠券发放等。输出侧要求把 JSON 整理成摘要或表格，而不是原样 dump；对退款、发货、改物流、结束直播、发券等高风险接口，须复述订单号、金额等并等用户明确确认后再执行。

适用边界与注意点

• 鉴权成功 ≠ 接口可用：返回 code:-2 表示该 API 未在微赞 SaaS 后台开通，需在后台批量开通，与密钥错误无关。
• 时间参数必须按接口查表：例如 shop/order_list 用毫秒，get_refound_list 用秒，get_live_all_data 的 endDate 最晚只能到昨天，选当天会 4011。
• 统计类请求注意频率（-7），page_size 建议 ≤500；refund_money 退款时原值回传，禁止自行换算。

适合已开通微赞云 API、并在 Agent 平台配置了密钥的团队，由 AI 辅助查数与走标准运维流程，而不是替代 SaaS 后台的权限与合规审批。