@oomol-lab/open-connector 1.6.2 → 1.6.4

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

@@ -229,6 +229,206 @@
         "description": "The receipt decision result."
       }
     },
+    {
+      "id": "xiaohongshu_store.create_item",
+      "service": "xiaohongshu_store",
+      "name": "create_item",
+      "description": "Create a Xiaohongshu item with its SKUs. Typical setup order: list_categories, get_category_attributes, search_brands, list_carriage_templates, list_logistics_plans, then upload_material for the images.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item title.",
+            "pattern": "\\S"
+          },
+          "categoryId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The leaf category ID, from list_categories.",
+            "pattern": "\\S"
+          },
+          "shippingTemplateId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The carriage template ID, from list_carriage_templates.",
+            "pattern": "\\S"
+          },
+          "shippingGrossWeight": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The item shipping weight in grams. Required to be positive when the carriage template charges by weight."
+          },
+          "images": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "link": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The image URL returned by upload_material.",
+                  "pattern": "\\S"
+                }
+              },
+              "additionalProperties": true,
+              "description": "One image."
+            },
+            "description": "The main images. Upload files with upload_material first and pass each returned url as link.",
+            "minItems": 1
+          },
+          "createSkuList": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "price": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The SKU price in fen."
+                },
+                "stock": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The SKU stock."
+                },
+                "logisticsPlanId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The logistics plan ID, from list_logistics_plans.",
+                  "pattern": "\\S"
+                },
+                "deliveryTime": {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "integer",
+                      "minimum": 3,
+                      "maximum": 5,
+                      "description": "The delivery time type: 3 for same-day, 4 for relative hours, or 5 for an absolute time."
+                    },
+                    "time": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The delivery time value for the chosen type.",
+                      "pattern": "\\S"
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The SKU delivery time."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One SKU to create. Other upstream SKU fields such as originalPrice, variants, barcode, erpCode, and specImage pass through unchanged."
+            },
+            "description": "The SKUs to create. Each needs price (in fen), stock, logisticsPlanId (from list_logistics_plans), and deliveryTime ({ type, time }).",
+            "minItems": 1
+          },
+          "brandId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The brand ID, from search_brands.",
+            "pattern": "\\S"
+          },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One attribute assignment."
+            },
+            "description": "The category attributes, from get_category_attributes: { propertyId, name, value, valueId, valueList }."
+          },
+          "variantIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A spec type ID.",
+              "pattern": "\\S"
+            },
+            "description": "The spec type IDs of the item."
+          },
+          "articleNo": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The merchant article number.",
+            "pattern": "\\S"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item description, up to 500 characters.",
+            "pattern": "\\S"
+          },
+          "itemShortTitle": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item short title.",
+            "pattern": "\\S"
+          },
+          "deliveryMode": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "The delivery mode: 0 for normal delivery or 1 for no-logistics delivery."
+          },
+          "freeReturn": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2,
+            "description": "The free-return policy: 1 or 2."
+          },
+          "videos": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One video: { link }."
+            },
+            "description": "The main videos, in the same { link } shape as images."
+          },
+          "imageDescriptions": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One description image: { link }."
+            },
+            "description": "The description images, in the same { link } shape as images."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "categoryId",
+          "shippingTemplateId",
+          "images",
+          "createSkuList"
+        ],
+        "description": "The item and SKU data used to create a Xiaohongshu product."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "item": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "A Xiaohongshu item record. Available fields depend on the query form."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The created Xiaohongshu item."
+      }
+    },
     {
       "id": "xiaohongshu_store.deliver_order",
       "service": "xiaohongshu_store",
@@ -697,6 +897,55 @@
         "description": "The Xiaohongshu SKU stock result."
       }
     },
+    {
+      "id": "xiaohongshu_store.list_address_records",
+      "service": "xiaohongshu_store",
+      "name": "list_address_records",
+      "description": "List the seller address records of the Xiaohongshu shop, including return addresses. sellerAddressRecordId is required when agreeing to a return shipment in audit_after_sale.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number. Defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 200,
+            "description": "The number of address records per page. Defaults to 20 and cannot exceed 200."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The pagination used to list seller address records."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "addresses": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A Xiaohongshu seller address record."
+            },
+            "description": "The seller address records."
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The total number of address records reported by Xiaohongshu."
+          }
+        },
+        "additionalProperties": false,
+        "description": "A paginated Xiaohongshu seller address result."
+      }
+    },
     {
       "id": "xiaohongshu_store.list_after_sale_reject_reasons",
       "service": "xiaohongshu_store",
@@ -841,6 +1090,55 @@
         "description": "A paginated Xiaohongshu after-sale result."
       }
     },
+    {
+      "id": "xiaohongshu_store.list_carriage_templates",
+      "service": "xiaohongshu_store",
+      "name": "list_carriage_templates",
+      "description": "List the carriage (freight) templates of the Xiaohongshu shop.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "pageIndex": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number. Defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The number of carriage templates per page. Defaults to 20 and cannot exceed 100."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The pagination used to list carriage templates."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "templates": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A Xiaohongshu carriage template."
+            },
+            "description": "The carriage template records."
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The total number of carriage templates reported by Xiaohongshu."
+          }
+        },
+        "additionalProperties": false,
+        "description": "A paginated Xiaohongshu carriage template result."
+      }
+    },
     {
       "id": "xiaohongshu_store.list_categories",
       "service": "xiaohongshu_store",
@@ -913,10 +1211,10 @@
       }
     },
     {
-      "id": "xiaohongshu_store.list_items",
+      "id": "xiaohongshu_store.list_item_skus",
       "service": "xiaohongshu_store",
-      "name": "list_items",
-      "description": "List Xiaohongshu items with basic fields using ID, time, stock, barcode, or availability filters.",
+      "name": "list_item_skus",
+      "description": "List Xiaohongshu items together with their full SKU details such as price, stock, and logistics plan.",
       "operationType": "read",
       "requiredScopes": [],
       "providerPermissions": [],
@@ -926,7 +1224,7 @@
           "id": {
             "type": "string",
             "minLength": 1,
-            "description": "An exact Xiaohongshu item ID.",
+            "description": "An exact Xiaohongshu SKU ID.",
             "pattern": "\\S"
           },
           "createTimeFrom": {
@@ -969,16 +1267,12 @@
             "description": "An item barcode.",
             "pattern": "\\S"
           },
-          "skucode": {
+          "scSkucode": {
             "type": "string",
             "minLength": 1,
-            "description": "A Xiaohongshu item code.",
+            "description": "A Xiaohongshu SKU code.",
             "pattern": "\\S"
           },
-          "freeze": {
-            "type": "boolean",
-            "description": "Whether to include only frozen items."
-          },
           "singlePackOnly": {
             "type": "boolean",
             "description": "Whether to return only single-item packs."
@@ -1006,7 +1300,7 @@
           }
         },
         "additionalProperties": false,
-        "description": "The filters used to list Xiaohongshu items. Passing an item ID ignores the other filters."
+        "description": "The filters used to list Xiaohongshu items with SKU details. Passing a SKU ID ignores the other filters."
       },
       "outputSchema": {
         "type": "object",
@@ -1017,14 +1311,14 @@
               "type": "object",
               "properties": {},
               "additionalProperties": true,
-              "description": "A Xiaohongshu item record. Available fields depend on the query form."
+              "description": "A Xiaohongshu item and SKU pair."
             },
-            "description": "The Xiaohongshu item records."
+            "description": "The item records, each with its item and sku details."
           },
           "total": {
             "type": "integer",
             "minimum": 0,
-            "description": "The total number of matching items reported by Xiaohongshu."
+            "description": "The total number of matching SKUs reported by Xiaohongshu."
           },
           "pageNo": {
             "type": "integer",
@@ -1034,57 +1328,302 @@
           "pageSize": {
             "type": "integer",
             "minimum": 1,
-            "description": "The requested number of items per page."
+            "description": "The requested number of records per page."
           }
         },
         "additionalProperties": false,
-        "description": "A paginated Xiaohongshu item result."
+        "description": "A paginated Xiaohongshu item and SKU result."
       }
     },
     {
-      "id": "xiaohongshu_store.list_orders",
+      "id": "xiaohongshu_store.list_items",
       "service": "xiaohongshu_store",
-      "name": "list_orders",
-      "description": "List Xiaohongshu orders by creation or update time. startTime and endTime are Unix timestamps in seconds, while the returned order times are in milliseconds. Creation-time windows are limited to 24 hours and update-time windows to 30 minutes.",
+      "name": "list_items",
+      "description": "List Xiaohongshu items with basic fields using ID, time, stock, barcode, or availability filters.",
       "operationType": "read",
       "requiredScopes": [],
       "providerPermissions": [],
       "inputSchema": {
         "type": "object",
         "properties": {
-          "timeType": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 2,
-            "description": "The time field to filter on: 1 for creation time or 2 for update time."
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "An exact Xiaohongshu item ID.",
+            "pattern": "\\S"
           },
-          "startTime": {
+          "createTimeFrom": {
             "type": "integer",
             "minimum": 0,
-            "description": "A Unix timestamp in seconds."
+            "description": "A Unix timestamp in milliseconds."
           },
-          "endTime": {
+          "createTimeTo": {
             "type": "integer",
             "minimum": 0,
-            "description": "A Unix timestamp in seconds."
+            "description": "A Unix timestamp in milliseconds."
           },
-          "orderType": {
+          "updateTimeFrom": {
             "type": "integer",
             "minimum": 0,
-            "maximum": 5,
-            "description": "The order type: 0 for all, 1 for in-stock, 2 for deposit presale, 4 for full-payment presale, or 5 for exchange reshipment."
+            "description": "A Unix timestamp in milliseconds."
           },
-          "orderStatus": {
+          "updateTimeTo": {
             "type": "integer",
             "minimum": 0,
-            "maximum": 10,
-            "description": "The order status: 0 for all, 1 unpaid, 2 paid processing, 3 in customs clearance, 4 pending shipment, 5 partially shipped, 6 shipped, 7 completed, 8 closed, 9 canceled, or 10 exchange requested."
+            "description": "A Unix timestamp in milliseconds."
           },
-          "pageNo": {
-            "type": "integer",
-            "minimum": 1,
-            "maximum": 100,
-            "description": "The one-based page number. Defaults to 1 and cannot exceed 100."
+          "buyable": {
+            "type": "boolean",
+            "description": "Whether to include only items currently on sale."
+          },
+          "stockGte": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The minimum stock quantity to include."
+          },
+          "stockLte": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The maximum stock quantity to include."
+          },
+          "barcode": {
+            "type": "string",
+            "minLength": 1,
+            "description": "An item barcode.",
+            "pattern": "\\S"
+          },
+          "skucode": {
+            "type": "string",
+            "minLength": 1,
+            "description": "A Xiaohongshu item code.",
+            "pattern": "\\S"
+          },
+          "freeze": {
+            "type": "boolean",
+            "description": "Whether to include only frozen items."
+          },
+          "singlePackOnly": {
+            "type": "boolean",
+            "description": "Whether to return only single-item packs."
+          },
+          "lastId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The cursor from the previous page when syncing the whole catalog.",
+            "pattern": "\\S"
+          },
+          "isChannel": {
+            "type": "boolean",
+            "description": "Whether to include only channel items."
+          },
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number. Defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The number of records per page. Defaults to 50 and cannot exceed 100."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The filters used to list Xiaohongshu items. Passing an item ID ignores the other filters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A Xiaohongshu item record. Available fields depend on the query form."
+            },
+            "description": "The Xiaohongshu item records."
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The total number of matching items reported by Xiaohongshu."
+          },
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The requested one-based page number."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The requested number of items per page."
+          }
+        },
+        "additionalProperties": false,
+        "description": "A paginated Xiaohongshu item result."
+      }
+    },
+    {
+      "id": "xiaohongshu_store.list_logistics_plans",
+      "service": "xiaohongshu_store",
+      "name": "list_logistics_plans",
+      "description": "List the logistics plans of the Xiaohongshu shop. planInfoId is the logisticsPlanId used when creating SKUs.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "No input is required to list logistics plans."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "plans": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A Xiaohongshu logistics plan."
+            },
+            "description": "The logistics plan records."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The Xiaohongshu logistics plan result."
+      }
+    },
+    {
+      "id": "xiaohongshu_store.list_materials",
+      "service": "xiaohongshu_store",
+      "name": "list_materials",
+      "description": "List materials in the Xiaohongshu material center, for example to check an upload status.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "materialId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "An exact material ID.",
+            "pattern": "\\S"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "A material file name filter.",
+            "pattern": "\\S"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "IMAGE",
+              "VIDEO"
+            ],
+            "description": "The material type."
+          },
+          "status": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 3,
+            "description": "The upload status: 1 for success, 2 for uploading, or 3 for failed."
+          },
+          "createTimeFrom": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "A Unix timestamp in milliseconds."
+          },
+          "createTimeTo": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "A Unix timestamp in milliseconds."
+          },
+          "ascByCreateTime": {
+            "type": "boolean",
+            "description": "Whether to sort by creation time ascending instead of descending."
+          },
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number. Defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "The number of materials per page. Defaults to 50 and cannot exceed 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The filters used to list Xiaohongshu materials."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "materials": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A Xiaohongshu material record."
+            },
+            "description": "The material records."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The Xiaohongshu material list."
+      }
+    },
+    {
+      "id": "xiaohongshu_store.list_orders",
+      "service": "xiaohongshu_store",
+      "name": "list_orders",
+      "description": "List Xiaohongshu orders by creation or update time. startTime and endTime are Unix timestamps in seconds, while the returned order times are in milliseconds. Creation-time windows are limited to 24 hours and update-time windows to 30 minutes.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "timeType": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2,
+            "description": "The time field to filter on: 1 for creation time or 2 for update time."
+          },
+          "startTime": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "A Unix timestamp in seconds."
+          },
+          "endTime": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "A Unix timestamp in seconds."
+          },
+          "orderType": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 5,
+            "description": "The order type: 0 for all, 1 for in-stock, 2 for deposit presale, 4 for full-payment presale, or 5 for exchange reshipment."
+          },
+          "orderStatus": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10,
+            "description": "The order status: 0 for all, 1 unpaid, 2 paid processing, 3 in customs clearance, 4 pending shipment, 5 partially shipped, 6 shipped, 7 completed, 8 closed, 9 canceled, or 10 exchange requested."
+          },
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The one-based page number. Defaults to 1 and cannot exceed 100."
           },
           "pageSize": {
             "type": "integer",
@@ -1373,6 +1912,65 @@
         "description": "The payment record resend result."
       }
     },
+    {
+      "id": "xiaohongshu_store.search_brands",
+      "service": "xiaohongshu_store",
+      "name": "search_brands",
+      "description": "Search the brands available for a leaf Xiaohongshu category.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "categoryId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The leaf category ID, from list_categories.",
+            "pattern": "\\S"
+          },
+          "keyword": {
+            "type": "string",
+            "minLength": 1,
+            "description": "A brand name keyword.",
+            "pattern": "\\S"
+          },
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number. Defaults to 1."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "The number of brands per page. Defaults to 20 and cannot exceed 20."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "categoryId"
+        ],
+        "description": "The category and keyword used to search Xiaohongshu brands."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "brands": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "A Xiaohongshu brand with id, name, enName, and image."
+            },
+            "description": "The matching brands."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The Xiaohongshu brand search result."
+      }
+    },
     {
       "id": "xiaohongshu_store.search_items",
       "service": "xiaohongshu_store",
@@ -1589,6 +2187,324 @@
         "additionalProperties": false,
         "description": "The stock sync result."
       }
+    },
+    {
+      "id": "xiaohongshu_store.update_item",
+      "service": "xiaohongshu_store",
+      "name": "update_item",
+      "description": "Update a Xiaohongshu item and its SKUs: edit item fields, change existing SKUs through updateSkuList, add new ones through createSkuList, and remove SKUs through deleteSkuIdList.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "itemId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The Xiaohongshu item ID.",
+            "pattern": "\\S"
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item title.",
+            "pattern": "\\S"
+          },
+          "categoryId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The leaf category ID, from list_categories.",
+            "pattern": "\\S"
+          },
+          "shippingTemplateId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The carriage template ID, from list_carriage_templates.",
+            "pattern": "\\S"
+          },
+          "shippingGrossWeight": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The item shipping weight in grams. Required to be positive when the carriage template charges by weight."
+          },
+          "images": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "link": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The image URL returned by upload_material.",
+                  "pattern": "\\S"
+                }
+              },
+              "additionalProperties": true,
+              "description": "One image."
+            },
+            "description": "The main images. Upload files with upload_material first and pass each returned url as link.",
+            "minItems": 1
+          },
+          "updateSkuList": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "skuId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The SKU ID, from list_item_skus or get_item.",
+                  "pattern": "\\S"
+                },
+                "price": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The SKU price in fen."
+                },
+                "stock": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The SKU stock."
+                },
+                "logisticsPlanId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The logistics plan ID, from list_logistics_plans.",
+                  "pattern": "\\S"
+                },
+                "deliveryTime": {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "integer",
+                      "minimum": 3,
+                      "maximum": 5,
+                      "description": "The delivery time type: 3 for same-day, 4 for relative hours, or 5 for an absolute time."
+                    },
+                    "time": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The delivery time value for the chosen type.",
+                      "pattern": "\\S"
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The SKU delivery time."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One SKU to update. Other upstream SKU fields such as originalPrice, variants, barcode, erpCode, and specImage pass through unchanged."
+            },
+            "description": "The existing SKUs to update. Each needs skuId, price (in fen), stock, logisticsPlanId (from list_logistics_plans), and deliveryTime ({ type, time }).",
+            "minItems": 1
+          },
+          "createSkuList": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "price": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The SKU price in fen."
+                },
+                "stock": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The SKU stock."
+                },
+                "logisticsPlanId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "The logistics plan ID, from list_logistics_plans.",
+                  "pattern": "\\S"
+                },
+                "deliveryTime": {
+                  "type": "object",
+                  "properties": {
+                    "type": {
+                      "type": "integer",
+                      "minimum": 3,
+                      "maximum": 5,
+                      "description": "The delivery time type: 3 for same-day, 4 for relative hours, or 5 for an absolute time."
+                    },
+                    "time": {
+                      "type": "string",
+                      "minLength": 1,
+                      "description": "The delivery time value for the chosen type.",
+                      "pattern": "\\S"
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "The SKU delivery time."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One SKU to create. Other upstream SKU fields such as originalPrice, variants, barcode, erpCode, and specImage pass through unchanged."
+            },
+            "description": "The new SKUs to add to the item, in the same shape as updateSkuList without skuId."
+          },
+          "deleteSkuIdList": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A SKU ID.",
+              "pattern": "\\S"
+            },
+            "description": "The SKU IDs to remove from the item."
+          },
+          "brandId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The brand ID, from search_brands.",
+            "pattern": "\\S"
+          },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One attribute assignment."
+            },
+            "description": "The category attributes, from get_category_attributes: { propertyId, name, value, valueId, valueList }."
+          },
+          "variantIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A spec type ID.",
+              "pattern": "\\S"
+            },
+            "description": "The spec type IDs of the item."
+          },
+          "articleNo": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The merchant article number.",
+            "pattern": "\\S"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item description, up to 500 characters.",
+            "pattern": "\\S"
+          },
+          "itemShortTitle": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item short title.",
+            "pattern": "\\S"
+          },
+          "deliveryMode": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "The delivery mode: 0 for normal delivery or 1 for no-logistics delivery."
+          },
+          "freeReturn": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2,
+            "description": "The free-return policy: 1 or 2."
+          },
+          "videos": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One video: { link }."
+            },
+            "description": "The main videos, in the same { link } shape as images."
+          },
+          "imageDescriptions": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One description image: { link }."
+            },
+            "description": "The description images, in the same { link } shape as images."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "itemId",
+          "name",
+          "categoryId",
+          "shippingTemplateId",
+          "images",
+          "updateSkuList"
+        ],
+        "description": "The item and SKU data used to update a Xiaohongshu product."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "item": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "A Xiaohongshu item record. Available fields depend on the query form."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The updated Xiaohongshu item."
+      }
+    },
+    {
+      "id": "xiaohongshu_store.upload_material",
+      "service": "xiaohongshu_store",
+      "name": "upload_material",
+      "description": "Upload an image or video to the Xiaohongshu material center and get its url for use in item images.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The material file name.",
+            "pattern": "\\S"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "IMAGE",
+              "VIDEO"
+            ],
+            "description": "The material type."
+          },
+          "contentBase64": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The file content as a base64 string.",
+            "pattern": "\\S"
+          }
+        },
+        "additionalProperties": false,
+        "description": "The material to upload."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "material": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The material record with materialId, url, and upload status."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The uploaded material."
+      }
     }
   ]
 }