@oomol-lab/open-connector 1.9.1 → 1.9.3

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

@@ -0,0 +1,1227 @@
+{
+  "service": "kolsprite_mcp",
+  "displayName": "KOLSprite MCP",
+  "homepageUrl": "https://www.kolsprite.com",
+  "categories": [
+    "E-commerce",
+    "Data",
+    "Marketing"
+  ],
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "MCP Key",
+      "placeholder": "Paste your KOLSprite MCP Key",
+      "description": "Follow https://o.kolsprite.com/doc/api.html#mcp-config to contact the administrator, enable MCP access, and obtain your secret-key. MCP Keys and HTTP API Keys are separate and cannot be used interchangeably.",
+      "extraFields": []
+    }
+  ],
+  "actions": [
+    {
+      "id": "kolsprite_mcp.asin_analysis_video",
+      "service": "kolsprite_mcp",
+      "name": "asin_analysis_video",
+      "description": "Find TikTok video signals related to an Amazon ASIN and marketplace. Results do not establish Amazon sales attribution.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "market": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Amazon marketplace code, such as US or GB."
+          },
+          "asin": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Amazon product ASIN."
+          },
+          "region": {
+            "type": "string",
+            "description": "TikTok region code; defaults to US, or to market for ASIN analysis."
+          },
+          "page_num": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number, starting at 1. Page number multiplied by page size must not exceed 1000.",
+            "default": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Results per page, from 1 to 100; defaults to 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "market",
+          "asin"
+        ],
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Results per page."
+              },
+              "list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "An upstream record with its available metrics and links."
+                },
+                "description": "Matching records."
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "list"
+            ],
+            "description": "Paginated search results."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.caption_extract_url",
+      "service": "kolsprite_mcp",
+      "name": "caption_extract_url",
+      "description": "Extract captions from a video URL through KOLSprite. Set is_southeast_asia for Southeast Asian videos.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Video URL for KOLSprite to fetch."
+          },
+          "is_southeast_asia": {
+            "type": "boolean",
+            "description": "Whether the video is from Southeast Asia; defaults to false.",
+            "default": false
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "url"
+        ],
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "string",
+            "description": "Caption text."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.creator_category_list",
+      "service": "kolsprite_mcp",
+      "name": "creator_category_list",
+      "description": "List creator categories and their values for creator_search.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "An upstream category record."
+            },
+            "description": "Category records."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.creator_search",
+      "service": "kolsprite_mcp",
+      "name": "creator_search",
+      "description": "Search TikTok creators by keyword, audience, engagement, and sales. Query creator_category_list or product_category_list before selecting a category.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "description": "Search keyword."
+          },
+          "search_type": {
+            "type": "string",
+            "description": "Search mode: N for nickname (creators) or ID (products and shops), K for keyword.",
+            "enum": [
+              "N",
+              "K"
+            ]
+          },
+          "region": {
+            "type": "string",
+            "description": "TikTok region code; defaults to US, or to market for ASIN analysis."
+          },
+          "category_list": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One upstream identifier."
+            },
+            "description": "One creator category value returned by creator_category_list.",
+            "maxItems": 1
+          },
+          "product_category_list": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One upstream identifier."
+            },
+            "description": "One product category ID returned by product_category_list.",
+            "maxItems": 1
+          },
+          "fans_cnt_from": {
+            "type": "integer",
+            "description": "Lower bound for follower count."
+          },
+          "fans_cnt_to": {
+            "type": "integer",
+            "description": "Upper bound for follower count."
+          },
+          "fans_gr_from": {
+            "type": "number",
+            "description": "Lower bound for follower growth rate."
+          },
+          "fans_gr_to": {
+            "type": "number",
+            "description": "Upper bound for follower growth rate."
+          },
+          "interact_from": {
+            "type": "number",
+            "description": "Lower bound for engagement rate."
+          },
+          "interact_to": {
+            "type": "number",
+            "description": "Upper bound for engagement rate."
+          },
+          "avg_like_from": {
+            "type": "number",
+            "description": "Lower bound for average likes."
+          },
+          "avg_like_to": {
+            "type": "number",
+            "description": "Upper bound for average likes."
+          },
+          "play_cnt_from": {
+            "type": "integer",
+            "description": "Lower bound for video views (average views for creator searches)."
+          },
+          "play_cnt_to": {
+            "type": "integer",
+            "description": "Upper bound for video views (average views for creator searches)."
+          },
+          "video_cnt_from": {
+            "type": "integer",
+            "description": "Lower bound for video count."
+          },
+          "video_cnt_to": {
+            "type": "integer",
+            "description": "Upper bound for video count."
+          },
+          "product_cnt_from": {
+            "type": "integer",
+            "description": "Lower bound for product count."
+          },
+          "product_cnt_to": {
+            "type": "integer",
+            "description": "Upper bound for product count."
+          },
+          "sales_volume_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume."
+          },
+          "sales_volume_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume."
+          },
+          "order_field": {
+            "type": "string",
+            "description": "Upstream sort field."
+          },
+          "order_type": {
+            "type": "integer",
+            "description": "Sort direction: 0 descending, 1 ascending.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "page_num": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number, starting at 1. Page number multiplied by page size must not exceed 1000.",
+            "default": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Results per page, from 1 to 100; defaults to 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Results per page."
+              },
+              "list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "An upstream record with its available metrics and links."
+                },
+                "description": "Matching records."
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "list"
+            ],
+            "description": "Paginated search results."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.product_category_list",
+      "service": "kolsprite_mcp",
+      "name": "product_category_list",
+      "description": "List the product category tree used by product, shop, video, and creator searches.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "An upstream category record."
+            },
+            "description": "Category records."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.product_related_creator",
+      "service": "kolsprite_mcp",
+      "name": "product_related_creator",
+      "description": "List creators promoting a TikTok Shop product, with optional contact availability and sorting filters.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "minLength": 1,
+            "description": "TikTok Shop product ID."
+          },
+          "region": {
+            "type": "string",
+            "description": "TikTok region code; defaults to US, or to market for ASIN analysis."
+          },
+          "contact_exist": {
+            "type": "integer",
+            "description": "Filter contact availability: 1 with contact details, 0 without.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "order_field": {
+            "type": "string",
+            "description": "Upstream sort field."
+          },
+          "order_type": {
+            "type": "integer",
+            "description": "Sort direction: 0 descending, 1 ascending.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "page_num": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number, starting at 1. Page number multiplied by page size must not exceed 1000.",
+            "default": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Results per page, from 1 to 100; defaults to 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "product_id"
+        ],
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Results per page."
+              },
+              "list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "An upstream record with its available metrics and links."
+                },
+                "description": "Matching records."
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "list"
+            ],
+            "description": "Paginated search results."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.product_search",
+      "service": "kolsprite_mcp",
+      "name": "product_search",
+      "description": "Search TikTok Shop products by keyword, price, sales, ratings, and category. Query product_category_list for category IDs.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "description": "Search keyword."
+          },
+          "search_type": {
+            "type": "string",
+            "description": "Search mode: N for nickname (creators) or ID (products and shops), K for keyword.",
+            "enum": [
+              "N",
+              "K"
+            ]
+          },
+          "region": {
+            "type": "string",
+            "description": "TikTok region code; defaults to US, or to market for ASIN analysis."
+          },
+          "cat_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One upstream identifier."
+            },
+            "description": "One product category ID returned by product_category_list.",
+            "maxItems": 1
+          },
+          "exclude_keyword": {
+            "type": "string",
+            "description": "Keywords to exclude."
+          },
+          "ft": {
+            "type": "string",
+            "description": "Fulfillment type: fbt for managed fulfillment, pop for merchant operations.",
+            "enum": [
+              "fbt",
+              "pop"
+            ]
+          },
+          "lt": {
+            "type": "string",
+            "description": "Logistics type: local or crossborder.",
+            "enum": [
+              "local",
+              "crossborder"
+            ]
+          },
+          "shop_id": {
+            "type": "string",
+            "description": "TikTok Shop ID."
+          },
+          "price_from": {
+            "type": "number",
+            "description": "Lower bound for price."
+          },
+          "price_to": {
+            "type": "number",
+            "description": "Upper bound for price."
+          },
+          "rating_from": {
+            "type": "number",
+            "description": "Lower bound for rating."
+          },
+          "rating_to": {
+            "type": "number",
+            "description": "Upper bound for rating."
+          },
+          "reviews_from": {
+            "type": "integer",
+            "description": "Lower bound for review count."
+          },
+          "reviews_to": {
+            "type": "integer",
+            "description": "Upper bound for review count."
+          },
+          "sales_volume_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume."
+          },
+          "sales_volume_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume."
+          },
+          "sales_volume_lst7d_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume in the last 7 days."
+          },
+          "sales_volume_lst7d_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume in the last 7 days."
+          },
+          "sales_volume_lst30d_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume in the last 30 days."
+          },
+          "sales_volume_lst30d_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume in the last 30 days."
+          },
+          "sales_lst30d_from": {
+            "type": "number",
+            "description": "Lower bound for sales revenue in the last 30 days."
+          },
+          "sales_lst30d_to": {
+            "type": "number",
+            "description": "Upper bound for sales revenue in the last 30 days."
+          },
+          "sales_volume_gr7d_from": {
+            "type": "number",
+            "description": "Lower bound for sales volume growth rate over 7 days."
+          },
+          "sales_volume_gr7d_to": {
+            "type": "number",
+            "description": "Upper bound for sales volume growth rate over 7 days."
+          },
+          "sales_volume_gr30d_from": {
+            "type": "number",
+            "description": "Lower bound for sales volume growth rate over 30 days."
+          },
+          "sales_volume_gr30d_to": {
+            "type": "number",
+            "description": "Upper bound for sales volume growth rate over 30 days."
+          },
+          "influencer_from": {
+            "type": "integer",
+            "description": "Lower bound for promoting creator count."
+          },
+          "influencer_to": {
+            "type": "integer",
+            "description": "Upper bound for promoting creator count."
+          },
+          "videos_from": {
+            "type": "integer",
+            "description": "Lower bound for video count."
+          },
+          "videos_to": {
+            "type": "integer",
+            "description": "Upper bound for video count."
+          },
+          "listing_date_from": {
+            "type": "string",
+            "description": "Lower bound for listing date (yyyy-mm-dd).",
+            "format": "date"
+          },
+          "listing_date_to": {
+            "type": "string",
+            "description": "Upper bound for listing date (yyyy-mm-dd).",
+            "format": "date"
+          },
+          "order_field": {
+            "type": "string",
+            "description": "Upstream sort field."
+          },
+          "order_type": {
+            "type": "integer",
+            "description": "Sort direction: 0 descending, 1 ascending.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "page_num": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number, starting at 1. Page number multiplied by page size must not exceed 1000.",
+            "default": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Results per page, from 1 to 100; defaults to 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Results per page."
+              },
+              "list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "An upstream record with its available metrics and links."
+                },
+                "description": "Matching records."
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "list"
+            ],
+            "description": "Paginated search results."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.shop_search",
+      "service": "kolsprite_mcp",
+      "name": "shop_search",
+      "description": "Search TikTok Shop stores by keyword, category, ratings, sales, and operating model.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "description": "Search keyword."
+          },
+          "search_type": {
+            "type": "string",
+            "description": "Search mode: N for nickname (creators) or ID (products and shops), K for keyword.",
+            "enum": [
+              "N",
+              "K"
+            ]
+          },
+          "region": {
+            "type": "string",
+            "description": "TikTok region code; defaults to US, or to market for ASIN analysis."
+          },
+          "category": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One upstream identifier."
+            },
+            "description": "One shop category ID returned by product_category_list.",
+            "maxItems": 1
+          },
+          "shop_type": {
+            "type": "string",
+            "description": "Upstream seller type."
+          },
+          "service_type": {
+            "type": "string",
+            "description": "Upstream operating model."
+          },
+          "price_from": {
+            "type": "number",
+            "description": "Lower bound for price."
+          },
+          "price_to": {
+            "type": "number",
+            "description": "Upper bound for price."
+          },
+          "rating_from": {
+            "type": "number",
+            "description": "Lower bound for rating."
+          },
+          "rating_to": {
+            "type": "number",
+            "description": "Upper bound for rating."
+          },
+          "products_from": {
+            "type": "integer",
+            "description": "Lower bound for listed product count."
+          },
+          "products_to": {
+            "type": "integer",
+            "description": "Upper bound for listed product count."
+          },
+          "sales_volume_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume."
+          },
+          "sales_volume_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume."
+          },
+          "sales_volume_lst30d_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume in the last 30 days."
+          },
+          "sales_volume_lst30d_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume in the last 30 days."
+          },
+          "sales_volume_gr30d_from": {
+            "type": "number",
+            "description": "Lower bound for sales volume growth rate over 30 days."
+          },
+          "sales_volume_gr30d_to": {
+            "type": "number",
+            "description": "Upper bound for sales volume growth rate over 30 days."
+          },
+          "influencer_from": {
+            "type": "integer",
+            "description": "Lower bound for promoting creator count."
+          },
+          "influencer_to": {
+            "type": "integer",
+            "description": "Upper bound for promoting creator count."
+          },
+          "videos_from": {
+            "type": "integer",
+            "description": "Lower bound for video count."
+          },
+          "videos_to": {
+            "type": "integer",
+            "description": "Upper bound for video count."
+          },
+          "order_field": {
+            "type": "string",
+            "description": "Upstream sort field."
+          },
+          "order_type": {
+            "type": "integer",
+            "description": "Sort direction: 0 descending, 1 ascending.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "page_num": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number, starting at 1. Page number multiplied by page size must not exceed 1000.",
+            "default": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Results per page, from 1 to 100; defaults to 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Results per page."
+              },
+              "list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "An upstream record with its available metrics and links."
+                },
+                "description": "Matching records."
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "list"
+            ],
+            "description": "Paginated search results."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    },
+    {
+      "id": "kolsprite_mcp.video_search",
+      "service": "kolsprite_mcp",
+      "name": "video_search",
+      "description": "Search TikTok videos by keyword, IDs, engagement, sales, dates, and linked products or shops.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "keyword": {
+            "type": "string",
+            "description": "Search keyword."
+          },
+          "region": {
+            "type": "string",
+            "description": "TikTok region code; defaults to US, or to market for ASIN analysis."
+          },
+          "video_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One upstream identifier."
+            },
+            "description": "Up to 50 TikTok video IDs.",
+            "maxItems": 50
+          },
+          "video_type": {
+            "type": "string",
+            "description": "Upstream video type."
+          },
+          "product": {
+            "type": "boolean",
+            "description": "Whether the video promotes a product."
+          },
+          "product_id": {
+            "type": "string",
+            "description": "TikTok Shop product ID."
+          },
+          "shop_id": {
+            "type": "string",
+            "description": "TikTok Shop ID."
+          },
+          "product_category_list": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "One upstream identifier."
+            },
+            "description": "One product category ID returned by product_category_list.",
+            "maxItems": 1
+          },
+          "play_cnt_from": {
+            "type": "integer",
+            "description": "Lower bound for video views (average views for creator searches)."
+          },
+          "play_cnt_to": {
+            "type": "integer",
+            "description": "Upper bound for video views (average views for creator searches)."
+          },
+          "like_cnt_from": {
+            "type": "integer",
+            "description": "Lower bound for like count."
+          },
+          "like_cnt_to": {
+            "type": "integer",
+            "description": "Upper bound for like count."
+          },
+          "interact_from": {
+            "type": "number",
+            "description": "Lower bound for engagement rate."
+          },
+          "interact_to": {
+            "type": "number",
+            "description": "Upper bound for engagement rate."
+          },
+          "price_from": {
+            "type": "number",
+            "description": "Lower bound for price."
+          },
+          "price_to": {
+            "type": "number",
+            "description": "Upper bound for price."
+          },
+          "sales_volume_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume."
+          },
+          "sales_volume_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume."
+          },
+          "sales_volume_lst30d_from": {
+            "type": "integer",
+            "description": "Lower bound for sales volume in the last 30 days."
+          },
+          "sales_volume_lst30d_to": {
+            "type": "integer",
+            "description": "Upper bound for sales volume in the last 30 days."
+          },
+          "sales_lst30d_from": {
+            "type": "number",
+            "description": "Lower bound for sales revenue in the last 30 days."
+          },
+          "sales_lst30d_to": {
+            "type": "number",
+            "description": "Upper bound for sales revenue in the last 30 days."
+          },
+          "seconds_from": {
+            "type": "integer",
+            "description": "Lower bound for video duration in seconds."
+          },
+          "seconds_to": {
+            "type": "integer",
+            "description": "Upper bound for video duration in seconds."
+          },
+          "pub_date_from": {
+            "type": "string",
+            "description": "Lower bound for publication date (yyyy-mm-dd).",
+            "format": "date"
+          },
+          "pub_date_to": {
+            "type": "string",
+            "description": "Upper bound for publication date (yyyy-mm-dd).",
+            "format": "date"
+          },
+          "order_field": {
+            "type": "string",
+            "description": "Upstream sort field."
+          },
+          "order_type": {
+            "type": "integer",
+            "description": "Sort direction: 0 descending, 1 ascending.",
+            "enum": [
+              0,
+              1
+            ]
+          },
+          "page_num": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Page number, starting at 1. Page number multiplied by page size must not exceed 1000.",
+            "default": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Results per page, from 1 to 100; defaults to 20.",
+            "default": 20
+          }
+        },
+        "additionalProperties": false,
+        "description": "KOLSprite tool arguments."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "Upstream business status code."
+          },
+          "message": {
+            "type": "string",
+            "description": "Upstream message."
+          },
+          "success": {
+            "type": "boolean",
+            "description": "Upstream success flag."
+          },
+          "data": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "integer",
+                "description": "Total matching records."
+              },
+              "pageNum": {
+                "type": "integer",
+                "description": "Current page number."
+              },
+              "pageSize": {
+                "type": "integer",
+                "description": "Results per page."
+              },
+              "list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "description": "An upstream record with its available metrics and links."
+                },
+                "description": "Matching records."
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "list"
+            ],
+            "description": "Paginated search results."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "data"
+        ],
+        "description": "KOLSprite response with additional upstream fields preserved."
+      }
+    }
+  ]
+}