微信小店运营 API 助手（wxshop-ops）
面向微信小店（视频号小店）商家/运营团队的运营能力包：官方 channels/ec API、罗盘数据 API、后台浏览器常驻服务。
> 前置：已开通微信小店并取得 AppID/AppSecret（微信公众平台「小店」模块），调用方需自行保管凭证。本技能仅提供通用接入方法，不含任何店铺私有凭证。
1. 凭证与 access_token
- 每个店铺一对
appid + secret，建议存本地私有配置文件（勿提交到公开仓库）。 - 获取 token：
POST https://api.weixin.qq.com/cgi-bin/stable_token，body{"grant_type":"client_credential","appid":"...","secret":"..."}，TTL 7200s。按 appid 缓存 token 文件复用。 - 该 access_token 同源可用：罗盘 API 与 小店 channels/ec API 共用。
2. 小店开放 API（channels/ec）
关键端点（均 POST https://api.weixin.qq.com/channels/ec/...，带 access_token query，仅服务器端调用）。具体参数以官方最新文档为准：
| 能力 | 端点 | 说明 |
|---|---|---|
| 商品上架 | product/listing |
body {product_id} |
| 商品下架 | product/delisting |
— |
| 免审更新 | product/auditfree |
只改线上版不动草稿 |
| 获取商品 | product/get |
{product_id, data_type: 1线上/2草稿/3都取} |
| 更新库存 | product/stock/update |
批量库存另有 batchstock |
| 订单搜索 | order/search |
按状态/时间窗 |
| 订单详情 | order/get |
{order_id} |
| 售后发起 | aftersale/genaftersaleorder |
代用户发起 |
| 售后协商 | aftersale/merchantupdateaftersale |
商家协商 |
| 售后查询 | aftersale/getaftersaleorder |
— |
- 无开放 API 的活动报名/平台激励等（限时秒杀、专区活动、成长激励）只能后台 UI 操作，见第 4 节。
3. 罗盘数据 API（T+1，只读）
- 日报/周报/月报、直播复盘、运营看板均可基于罗盘只读接口构建定时任务。
- 常见坑：
- 罗盘接口数值字段多为字符串，需 float() 转换。
- 商品列表拿 product_ids 后逐个查详情标题。
- 标题可做当天有效的本地缓存，减少重复请求。
- 平台佣金/运费模板以实查接口为准，别信本地静态配置的佣金字段。
4. 后台浏览器常驻服务（无 API 场景）
平台不开放的 UI 操作（活动报名/激励领取等）可用浏览器自动化兜底：
- 方案：Playwright 持久化上下文 + 独立 user-data-dir 登录态，常驻进程用「命令文件」驱动（写 cmd json → 读 result json），实现 ping/nav/screenshot/点击等原语。
- 铁律：
1. 单实例：两个实例抢同一 profile 会互杀崩溃，先查进程再拉起。
2. 命令文件必须 UTF-8 无 BOM，否则解析报错。
3. 登录过期 → 导航到店铺设置页触发「重新登录」→ 截图二维码发给店长扫码（扫码是唯一人工动作），扫码后恢复。
4. 定时拉起用计划任务，避免整点重复触发双实例。
5. 合规红线
- 商品标题/描述/对外文案不出现竞品品牌名；不用「自有工厂/源头工厂/同厂代工」类表述；代工信息用真实工厂名。
- AI 生成/合成内容按平台要求标注；避免绝对化夸大用语（最/第一/100% 等）。
- 所有对外内容注意品牌一致性与广告法合规。
6. 参考
- 微信小店官方文档：developers.weixin.qq.com/doc/store/shop/（商品管理/订单/售后指南）
- 用 SpecFusion 等 API 文档检索工具搜
source=wechat-shop拿精确参数表。
