@oomol-lab/open-connector 1.9.0 → 1.9.2

package/assets/open-connector/catalog/apps/weixin_store.json

@@ -1,7 +1,7 @@
 {
   "service": "weixin_store",
   "displayName": "WeChat Store",
-  "description": "Run a WeChat Store (微信小店) through the WeChat Store Open Platform APIs: upload product images, create and update products, list and delist them, manage stock, query and ship orders, look up freight templates and addresses, and process after-sale requests. If the store has an IP whitelist configured in the WeChat Store admin console (微信小店后台 → 服务市场 → 经营工具 → 自研 → IP 白名单), the runtime's public egress IP must be added to it, otherwise every call fails with HTTP 403.",
+  "description": "Run a WeChat Store (微信小店) through the WeChat Store Open Platform APIs: upload product images, create and update products, list and delist them, manage stock, query and ship orders, look up freight templates and addresses, process after-sale requests, send talent cooperation invitations, manage existing promotion plans, inspect merchant alliance talents and product scene restrictions, and read historical Compass product metrics. If the store has an IP whitelist configured in the WeChat Store admin console (微信小店后台 → 服务市场 → 经营工具 → 自研 → IP 白名单), the runtime's public egress IP must be added to it, otherwise every call fails with HTTP 403.",
   "categories": [
     "E-commerce"
   ],
@@ -872,6 +872,124 @@
         "description": "The category's product publishing rules."
       }
     },
+    {
+      "id": "weixin_store.get_compass_product_data",
+      "service": "weixin_store",
+      "name": "get_compass_product_data",
+      "description": "Read historical Compass product click and transaction data. T+1 only: date must be yesterday or earlier in Asia/Shanghai. Monetary values and counts retain upstream string units.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store Compass data access; service providers require permission set 175"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "pattern": "^[0-9]{8}$",
+            "description": "A valid historical date as YYYYMMDD, yesterday or earlier in Asia/Shanghai.",
+            "examples": [
+              "20240520"
+            ]
+          },
+          "productId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The product id, no greater than JavaScript's maximum safe integer."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "date",
+          "productId"
+        ],
+        "description": "A historical product data query."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "product_info": {
+            "type": "object",
+            "properties": {
+              "product_id": {
+                "type": "string",
+                "description": "The product id."
+              },
+              "head_img_url": {
+                "type": "string",
+                "description": "The product image URL."
+              },
+              "title": {
+                "type": "string",
+                "description": "The title."
+              },
+              "price": {
+                "type": "string",
+                "description": "The price in fen, as an upstream string."
+              },
+              "first_category_id": {
+                "type": "string",
+                "description": "The first-level category id."
+              },
+              "second_category_id": {
+                "type": "string",
+                "description": "The second-level category id."
+              },
+              "third_category_id": {
+                "type": "string",
+                "description": "The third-level category id."
+              },
+              "data": {
+                "type": "object",
+                "properties": {
+                  "product_click_uv": {
+                    "type": "string",
+                    "description": "Unique product click visitors."
+                  },
+                  "product_click_cnt": {
+                    "type": "string",
+                    "description": "Product clicks."
+                  },
+                  "pay_gmv": {
+                    "type": "string",
+                    "description": "Paid GMV in fen."
+                  },
+                  "pay_cnt": {
+                    "type": "string",
+                    "description": "Paid orders."
+                  },
+                  "pay_uv": {
+                    "type": "string",
+                    "description": "Paying users."
+                  },
+                  "pay_product_cnt": {
+                    "type": "string",
+                    "description": "Paid product quantity."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Raw Compass metrics; monetary values are in fen and ratios can be null."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The product and historical metrics."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Historical product data; upstream fields and nullable ratios are preserved."
+      }
+    },
     {
       "id": "weixin_store.get_freight_template",
       "service": "weixin_store",
@@ -909,6 +1027,240 @@
         "description": "The upstream WeChat freight template detail."
       }
     },
+    {
+      "id": "weixin_store.get_league_plan",
+      "service": "weixin_store",
+      "name": "get_league_plan",
+      "description": "Read an existing alliance plan's activation, eligibility and commission. The returned item.type uses legacy values 1/2/3; do not reuse it as request type 100/300.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "anyOf": [
+              {
+                "const": 100,
+                "type": "number"
+              },
+              {
+                "const": 300,
+                "type": "number"
+              }
+            ],
+            "description": "100 = all talents, 300 = specified talents. These endpoints do not support filtered audience type 200."
+          },
+          "productId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The existing product id; must be a safe positive integer."
+          },
+          "promotionPlanId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The existing promotion plan id; must be a safe positive integer."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "type",
+          "productId"
+        ],
+        "description": "An existing all-talent or specified-talent plan; include promotionPlanId to inspect a specific plan."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "item": {
+            "type": "object",
+            "properties": {
+              "product_id": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "description": "Product id as a number."
+                  },
+                  {
+                    "type": "string",
+                    "description": "Product id as an upstream string."
+                  }
+                ]
+              },
+              "type": {
+                "type": "integer",
+                "description": "Legacy response type: 1 ordinary, 2 targeted, 3 exclusive; not request audience type."
+              },
+              "status": {
+                "type": "integer",
+                "description": "1 active, 2 delisted, 4 deleted, 5 ineligible, 7 product delisted, 8 expired, 9 banned, 10 pending activation."
+              },
+              "ratio": {
+                "type": "number",
+                "description": "Commission percentage, 0–90; not the 0–1000000 talent-data scale."
+              },
+              "exclusive_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "Upstream plan identity, timing and talent information."
+              },
+              "ext_info": {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "Upstream restriction flags."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The existing plan."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Alliance plan detail."
+      }
+    },
+    {
+      "id": "weixin_store.get_league_promoter",
+      "service": "weixin_store",
+      "name": "get_league_promoter",
+      "description": "Read a known alliance talent's profile, sales metrics and blacklist status. Supply exactly one talent identifier, not a nickname.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "talentAppid": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The talent_appid returned by list_league_promoters."
+          },
+          "talentSearchKey": {
+            "type": "string",
+            "minLength": 1,
+            "description": "A talent appid or WeChat Channels finder_id; not a nickname or a third-party search id."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Exactly one known talent identifier.",
+        "oneOf": [
+          {
+            "required": [
+              "talentAppid"
+            ]
+          },
+          {
+            "required": [
+              "talentSearchKey"
+            ]
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "talent": {
+            "type": "object",
+            "properties": {
+              "base_talent_info": {
+                "type": "object",
+                "properties": {
+                  "talent_appid": {
+                    "type": "string",
+                    "description": "The talent appid."
+                  },
+                  "nickname": {
+                    "type": "string",
+                    "description": "The nickname."
+                  },
+                  "head_img": {
+                    "type": "string",
+                    "description": "The avatar URL."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Talent identity."
+              },
+              "data": {
+                "type": "object",
+                "properties": {
+                  "total_sale_gmv": {
+                    "type": "number",
+                    "description": "Lifetime sales GMV, in upstream units."
+                  },
+                  "sale_gmv_30d": {
+                    "type": "number",
+                    "description": "30-day sales GMV, in upstream units."
+                  },
+                  "total_order_num": {
+                    "type": "number",
+                    "description": "Lifetime orders."
+                  },
+                  "order_num_30d": {
+                    "type": "number",
+                    "description": "30-day orders."
+                  },
+                  "sale_product_num_30d": {
+                    "type": "number",
+                    "description": "Products sold in 30 days."
+                  },
+                  "window_product_num": {
+                    "type": "number",
+                    "description": "Products in the talent window."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Upstream sales and window metrics."
+              },
+              "feature_info": {
+                "type": "object",
+                "properties": {
+                  "level": {
+                    "type": "integer",
+                    "description": "The upstream level, 0 through 5."
+                  },
+                  "is_blacklisted": {
+                    "type": "boolean",
+                    "description": "Whether the talent is blacklisted."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Talent features."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The talent profile and metrics."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The alliance talent detail."
+      }
+    },
     {
       "id": "weixin_store.get_order",
       "service": "weixin_store",
@@ -1009,6 +1361,150 @@
         "description": "The upstream WeChat product data."
       }
     },
+    {
+      "id": "weixin_store.get_product_audit_strategy",
+      "service": "weixin_store",
+      "name": "get_product_audit_strategy",
+      "description": "Read store-wide product listing policy switches. This is not a historical delisting-reason log and does not change any policy.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store product access; service providers require permission set 129"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "This action takes no input."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "audit_strategy": {
+            "type": "object",
+            "properties": {
+              "hide_err_field_flag": {
+                "type": "integer",
+                "description": "List with erroneous product information hidden."
+              },
+              "hit_duplicated_flag": {
+                "type": "integer",
+                "description": "Allow similar products."
+              },
+              "hit_low_risk_rule_flag": {
+                "type": "integer",
+                "description": "Allow products matching low-risk rules."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Each switch is 1 enabled or 2 disabled."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Store listing policy."
+      }
+    },
+    {
+      "id": "weixin_store.get_product_restricted_info",
+      "service": "weixin_store",
+      "name": "get_product_restricted_info",
+      "description": "Read restricted sales scenes for 1 to 50 products, including alliance and talent-window restrictions. This does not change product status. Merchant quota: 100 calls per minute.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store product access; service providers require permission set 129"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "productIds": {
+            "type": "array",
+            "items": {
+              "anyOf": [
+                {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "The id as a number."
+                },
+                {
+                  "type": "string",
+                  "pattern": "^[1-9][0-9]*$",
+                  "description": "The id as a numeric string."
+                }
+              ],
+              "description": "A product id."
+            },
+            "description": "Product ids, each no greater than JavaScript's maximum safe integer.",
+            "minItems": 1,
+            "maxItems": 50
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "productIds"
+        ],
+        "description": "Products to inspect for scene restrictions."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "restricted_info_list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "product_id": {
+                      "anyOf": [
+                        {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "The id as a number."
+                        },
+                        {
+                          "type": "string",
+                          "pattern": "^[1-9][0-9]*$",
+                          "description": "The id as a numeric string."
+                        }
+                      ],
+                      "description": "The product id, returned as a number or numeric string."
+                    },
+                    "scene_info": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "scene": {
+                            "type": "integer",
+                            "description": "1 live, 2 short video, 3 store home/talent window, 4 search, 5 ads, 6 orders/cards, 7 alliance, 8 recommendation, 9 selling, 10 invalid-product hiding."
+                          },
+                          "source": {
+                            "type": "integer",
+                            "description": "1 low-risk policy, 2 similar-product policy, 3 hidden-image policy, 4 trial category, 5 window hiding, 6 minimal mode, 7 selling restriction, 8 inventory restriction."
+                          }
+                        },
+                        "additionalProperties": true,
+                        "description": "One restriction."
+                      },
+                      "description": "Restricted scenes and policy sources."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "One product's restricted scenes."
+                },
+                "description": "Restrictions per product."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The restriction response data."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Product scene restrictions."
+      }
+    },
     {
       "id": "weixin_store.get_shop_info",
       "service": "weixin_store",
@@ -1062,6 +1558,52 @@
         "description": "The upstream WeChat shop information."
       }
     },
+    {
+      "id": "weixin_store.invite_league_promoter",
+      "service": "weixin_store",
+      "name": "invite_league_promoter",
+      "description": "Invite one known talent to cooperate with the shop. This sends an external invitation: obtain approval for the exact recipient first. Supply promoterId or the deprecated finderId, never infer promoterId from talent_appid. Do not retry blindly after a timeout; WeChat rejects duplicate invitations within 24 hours and already-cooperating talents.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "promoterId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The verified talent promoter_id (talent selling id), not an unverified talent_appid or third-party id."
+          },
+          "finderId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The verified WeChat Channels finder_id. Deprecated upstream; prefer promoterId when known."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Exactly one verified invitation recipient.",
+        "oneOf": [
+          {
+            "required": [
+              "promoterId"
+            ]
+          },
+          {
+            "required": [
+              "finderId"
+            ]
+          }
+        ]
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": true,
+        "description": "The upstream WeChat response. It carries no fields on success."
+      }
+    },
     {
       "id": "weixin_store.list_addresses",
       "service": "weixin_store",
@@ -1343,22 +1885,303 @@
           }
         },
         "additionalProperties": false,
-        "description": "The freight template page to list."
+        "description": "The freight template page to list."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "template_id_list": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One freight template id."
+            },
+            "description": "The freight template ids in this page."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The upstream WeChat freight template page."
+      }
+    },
+    {
+      "id": "weixin_store.list_league_products",
+      "service": "weixin_store",
+      "name": "list_league_products",
+      "description": "List existing alliance products and eligibility status. Pagination is bounded by pageSize multiplied by pageIndex <= 5000; no undocumented cursor is sent.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The 1-based page index.",
+            "default": 1
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Page size, at most 100.",
+            "default": 20
+          },
+          "productId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The existing product id; must be a safe positive integer."
+          },
+          "needTotalNum": {
+            "type": "boolean",
+            "description": "Request the total count."
+          }
+        },
+        "additionalProperties": false,
+        "description": "An alliance product page."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "product_id": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "minimum": 1,
+                      "description": "The id as a number."
+                    },
+                    {
+                      "type": "string",
+                      "pattern": "^[1-9][0-9]*$",
+                      "description": "The id as a numeric string."
+                    }
+                  ],
+                  "description": "The product id, returned as a number or numeric string."
+                },
+                "status": {
+                  "type": "integer",
+                  "description": "1 active, 2 delisted, 4 deleted, 5 ineligible, 7 product delisted, 8 expired, 9 banned, 10 pending activation."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One alliance product."
+            },
+            "description": "Products and eligibility."
+          },
+          "has_more": {
+            "type": "boolean",
+            "description": "Whether more products exist."
+          },
+          "total_num": {
+            "type": "integer",
+            "description": "Total products when requested."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Alliance products."
+      }
+    },
+    {
+      "id": "weixin_store.list_league_promoter_products",
+      "service": "weixin_store",
+      "name": "list_league_promoter_products",
+      "description": "Read a known cooperating talent's current window products or products sold in the last 30 days. This does not discover new talents or add products to a window.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "talentAppid": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The cooperating talent appid."
+          },
+          "dataType": {
+            "anyOf": [
+              {
+                "const": 1,
+                "type": "number"
+              },
+              {
+                "const": 2,
+                "type": "number"
+              }
+            ],
+            "description": "1 = products with sales in the last 30 days, 2 = current window products."
+          },
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The 1-based page index.",
+            "default": 1
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "Page size, at most 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "talentAppid",
+          "dataType"
+        ],
+        "description": "A cooperating talent's product data page."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "total_num": {
+            "type": "integer",
+            "description": "Total matching products."
+          },
+          "continue_flag": {
+            "type": "boolean",
+            "description": "Whether another page exists."
+          },
+          "list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "spu_id": {
+                  "type": "integer",
+                  "description": "The product id."
+                },
+                "product_data": {
+                  "type": "object",
+                  "properties": {
+                    "total_sale_gmv": {
+                      "type": "number",
+                      "description": "Lifetime sales GMV, in upstream units."
+                    },
+                    "sale_gmv_30d": {
+                      "type": "number",
+                      "description": "30-day sales GMV, in upstream units."
+                    },
+                    "total_order_num": {
+                      "type": "number",
+                      "description": "Lifetime orders."
+                    },
+                    "order_num_30d": {
+                      "type": "number",
+                      "description": "30-day orders."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Sales metrics."
+                },
+                "talent_commission_info": {
+                  "type": "object",
+                  "properties": {
+                    "commission_type": {
+                      "type": "integer",
+                      "description": "1 ordinary, 2 targeted, 3 exclusive."
+                    },
+                    "ratio": {
+                      "type": "integer",
+                      "description": "Commission ratio on the upstream 0–1000000 scale; 1000000 means 100%."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Commission information; read only."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One product."
+            },
+            "description": "Product data."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Talent product data page."
+      }
+    },
+    {
+      "id": "weixin_store.list_league_promoters",
+      "service": "weixin_store",
+      "name": "list_league_promoters",
+      "description": "List the connected merchant's alliance talents. This is not a platform-wide talent search; follow continue_flag to paginate.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The 1-based page index.",
+            "default": 1
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "The number of talents per page, at most 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "description": "Merchant alliance talent pagination."
       },
       "outputSchema": {
         "type": "object",
         "properties": {
-          "template_id_list": {
+          "total_num": {
+            "type": "integer",
+            "description": "The total number of talents."
+          },
+          "continue_flag": {
+            "type": "boolean",
+            "description": "Whether another page is available."
+          },
+          "list": {
             "type": "array",
             "items": {
-              "type": "string",
-              "description": "One freight template id."
+              "type": "object",
+              "properties": {
+                "talent_appid": {
+                  "type": "string",
+                  "description": "The talent appid used by get_league_promoter."
+                },
+                "nickname": {
+                  "type": "string",
+                  "description": "The talent nickname; not a lookup identifier."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One talent."
             },
-            "description": "The freight template ids in this page."
+            "description": "The talents in this page."
           }
         },
         "additionalProperties": true,
-        "description": "The upstream WeChat freight template page."
+        "description": "The merchant alliance talent page."
       }
     },
     {
@@ -1473,6 +2296,260 @@
         "description": "The upstream WeChat order page."
       }
     },
+    {
+      "id": "weixin_store.list_product_promotion_plans",
+      "service": "weixin_store",
+      "name": "list_product_promotion_plans",
+      "description": "List an existing product's alliance promotion plan identifiers before inspecting or changing a specific plan. Filtered audience type 200 is supported by this list only, not get_league_plan or update_league_plan.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "productId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The existing product id; must be a safe positive integer."
+          },
+          "promotionPlanType": {
+            "anyOf": [
+              {
+                "const": 100,
+                "type": "number"
+              },
+              {
+                "const": 200,
+                "type": "number"
+              },
+              {
+                "const": 300,
+                "type": "number"
+              }
+            ],
+            "description": "100 all, 200 filtered, 300 specified talents."
+          },
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The 1-based page index.",
+            "default": 1
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "Page size, at most 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "productId"
+        ],
+        "description": "The product's existing promotion plans."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "total_num": {
+            "type": "integer",
+            "description": "Total matching records."
+          },
+          "continue_flag": {
+            "type": "boolean",
+            "description": "Whether another page exists."
+          },
+          "list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "promotion_plan_id": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "description": "The plan id."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "The plan id."
+                },
+                "promotion_plan_type": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "description": "100 all, 200 filtered, 300 specified talents."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "100 all, 200 filtered, 300 specified talents."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One plan."
+            },
+            "description": "Existing plan identifiers."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The promotion plan page."
+      }
+    },
+    {
+      "id": "weixin_store.list_product_promotion_talents",
+      "service": "weixin_store",
+      "name": "list_product_promotion_talents",
+      "description": "Read talents related to one existing product promotion plan and their promotion relationship status. This is not platform-wide discovery and does not prove that a product is in a talent's window.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "productId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The existing product id; must be a safe positive integer."
+          },
+          "promotionPlanId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The existing promotion plan id; must be a safe positive integer."
+          },
+          "talentAppid": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Optional talent appid filter."
+          },
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The 1-based page index.",
+            "default": 1
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "description": "Page size, at most 10.",
+            "default": 10
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "productId",
+          "promotionPlanId"
+        ],
+        "description": "One existing promotion plan's talent page."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "total_num": {
+            "type": "integer",
+            "description": "Total matching records."
+          },
+          "continue_flag": {
+            "type": "boolean",
+            "description": "Whether another page exists."
+          },
+          "list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "base_talent_info": {
+                  "type": "object",
+                  "properties": {
+                    "nickname": {
+                      "type": "string",
+                      "description": "The nickname."
+                    },
+                    "head_img": {
+                      "type": "string",
+                      "description": "The avatar URL."
+                    },
+                    "talent_appid": {
+                      "type": "string",
+                      "description": "The talent appid."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Talent identity."
+                },
+                "commission_info": {
+                  "type": "object",
+                  "properties": {
+                    "promotion_plan_id": {
+                      "type": "integer",
+                      "description": "The plan id."
+                    },
+                    "promotion_plan_type": {
+                      "type": "integer",
+                      "description": "The plan type."
+                    },
+                    "ratio": {
+                      "type": "integer",
+                      "description": "Upstream scale: 1000000 means 100%; not the 0–90 percentage scale of update_league_plan."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Read-only commission terms."
+                },
+                "talent_relation_status": {
+                  "type": "integer",
+                  "description": "1 promoting, 4 removed, 10 blacklisted."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One relationship."
+            },
+            "description": "Related talents."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Promotion talent relationships."
+      }
+    },
     {
       "id": "weixin_store.list_products",
       "service": "weixin_store",
@@ -1846,6 +2923,178 @@
         "description": "The upstream WeChat response. It carries no fields on success."
       }
     },
+    {
+      "id": "weixin_store.update_league_plan",
+      "service": "weixin_store",
+      "name": "update_league_plan",
+      "description": "Change one existing alliance promotion plan: edit commission and activate (1), delist (2), or activate (4). Obtain approval for the exact plan and change first; activation or commission changes can incur commission spending. Read the plan before and after; no automatic fallback, audience changes, new plan creation or deletion is provided.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "WeChat Store alliance access must be enabled and approved; service providers require permission set 141"
+      ],
+      "inputSchema": {
+        "oneOf": [
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "anyOf": [
+                  {
+                    "const": 100,
+                    "type": "number"
+                  },
+                  {
+                    "const": 300,
+                    "type": "number"
+                  }
+                ],
+                "description": "100 = all talents, 300 = specified talents. These endpoints do not support filtered audience type 200."
+              },
+              "productId": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "The id as a number."
+                  },
+                  {
+                    "type": "string",
+                    "pattern": "^[1-9][0-9]*$",
+                    "description": "The id as a numeric string."
+                  }
+                ],
+                "description": "The existing product id; must be a safe positive integer."
+              },
+              "promotionPlanId": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "The id as a number."
+                  },
+                  {
+                    "type": "string",
+                    "pattern": "^[1-9][0-9]*$",
+                    "description": "The id as a numeric string."
+                  }
+                ],
+                "description": "The existing promotion plan id; must be a safe positive integer."
+              },
+              "operateType": {
+                "const": 1,
+                "type": "number",
+                "description": "Edit commission and activate."
+              },
+              "ratio": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 90,
+                "description": "Commission percentage, 0–90 (not the 0–1000000 read scale)."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "type",
+              "productId",
+              "promotionPlanId",
+              "operateType",
+              "ratio"
+            ],
+            "description": "Approved commission edit and activation."
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "anyOf": [
+                  {
+                    "const": 100,
+                    "type": "number"
+                  },
+                  {
+                    "const": 300,
+                    "type": "number"
+                  }
+                ],
+                "description": "100 = all talents, 300 = specified talents. These endpoints do not support filtered audience type 200."
+              },
+              "productId": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "The id as a number."
+                  },
+                  {
+                    "type": "string",
+                    "pattern": "^[1-9][0-9]*$",
+                    "description": "The id as a numeric string."
+                  }
+                ],
+                "description": "The existing product id; must be a safe positive integer."
+              },
+              "promotionPlanId": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 1,
+                    "description": "The id as a number."
+                  },
+                  {
+                    "type": "string",
+                    "pattern": "^[1-9][0-9]*$",
+                    "description": "The id as a numeric string."
+                  }
+                ],
+                "description": "The existing promotion plan id; must be a safe positive integer."
+              },
+              "operateType": {
+                "anyOf": [
+                  {
+                    "const": 2,
+                    "type": "number"
+                  },
+                  {
+                    "const": 4,
+                    "type": "number"
+                  }
+                ],
+                "description": "2 = delist, 4 = activate. No commission fields accepted."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "type",
+              "productId",
+              "promotionPlanId",
+              "operateType"
+            ],
+            "description": "Approved activation-state change only."
+          }
+        ],
+        "description": "One approved existing-plan update; commission is required only for edit-and-activate."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "promotion_plan_id": {
+            "type": "integer",
+            "description": "The updated plan id."
+          },
+          "fail_talent_appids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "A talent appid."
+            },
+            "description": "Talents that failed to update; a nonempty list means partial failure."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The upstream update result; inspect failures and reread actual state."
+      }
+    },
     {
       "id": "weixin_store.update_order_merchant_notes",
       "service": "weixin_store",