gangvy 3 ore în urmă
părinte
comite
2a6a6831f0

+ 57 - 13
social-media/instagram-search/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["query"],
+    "required": [
+      "query"
+    ],
     "properties": {
       "query": {
         "type": "string",
@@ -24,7 +26,10 @@
         "type": "string",
         "description": "搜索类型: 'users'=搜索用户, 'hashtags'=搜索标签",
         "default": "users",
-        "enum": ["users", "hashtags"]
+        "enum": [
+          "users",
+          "hashtags"
+        ]
       }
     }
   },
@@ -47,13 +52,34 @@
             "user": {
               "type": "object",
               "properties": {
-                "pk": { "type": "string", "description": "用户数字 ID(用于获取帖子)" },
-                "username": { "type": "string", "description": "用户名" },
-                "full_name": { "type": "string", "description": "显示名称" },
-                "is_verified": { "type": "boolean", "description": "是否认证" },
-                "profile_pic_url": { "type": "string", "description": "头像 URL" },
-                "follower_count": { "type": "integer", "description": "粉丝数" },
-                "is_private": { "type": "boolean", "description": "是否私密账号" }
+                "pk": {
+                  "type": "string",
+                  "description": "用户数字 ID(用于获取帖子)"
+                },
+                "username": {
+                  "type": "string",
+                  "description": "用户名"
+                },
+                "full_name": {
+                  "type": "string",
+                  "description": "显示名称"
+                },
+                "is_verified": {
+                  "type": "boolean",
+                  "description": "是否认证"
+                },
+                "profile_pic_url": {
+                  "type": "string",
+                  "description": "头像 URL"
+                },
+                "follower_count": {
+                  "type": "integer",
+                  "description": "粉丝数"
+                },
+                "is_private": {
+                  "type": "boolean",
+                  "description": "是否私密账号"
+                }
               }
             }
           }
@@ -65,17 +91,35 @@
   "usageExamples": [
     {
       "name": "搜索 NEST New York 品牌",
-      "input": { "query": "NEST New York", "select": "users" },
+      "input": {
+        "query": "NEST New York",
+        "select": "users"
+      },
       "description": "搜索 NEST New York 的 Instagram 品牌账号"
     },
     {
       "name": "搜索 Paddywax 品牌",
-      "input": { "query": "Paddywax", "select": "users" },
+      "input": {
+        "query": "Paddywax",
+        "select": "users"
+      },
       "description": "搜索 Paddywax 的 Instagram 品牌账号"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)", "知识中心(Slide11)"],
-    "dataPoints": ["品牌IG账号发现", "粉丝数初步数据"]
+    "slides": [
+      "竞品对标(Slide4)",
+      "知识中心(Slide11)"
+    ],
+    "dataPoints": [
+      "品牌IG账号发现",
+      "粉丝数初步数据"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 77 - 18
social-media/instagram-user-info/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["username"],
+    "required": [
+      "username"
+    ],
     "properties": {
       "username": {
         "type": "string",
@@ -34,18 +36,54 @@
       "user": {
         "type": "object",
         "properties": {
-          "pk": { "type": "string", "description": "用户数字 ID" },
-          "username": { "type": "string", "description": "用户名" },
-          "full_name": { "type": "string", "description": "显示名称" },
-          "biography": { "type": "string", "description": "个人简介" },
-          "follower_count": { "type": "integer", "description": "粉丝数" },
-          "following_count": { "type": "integer", "description": "关注数" },
-          "media_count": { "type": "integer", "description": "帖子总数" },
-          "is_verified": { "type": "boolean", "description": "是否蓝V认证" },
-          "is_business": { "type": "boolean", "description": "是否商业账号" },
-          "category": { "type": "string", "description": "账号类别" },
-          "external_url": { "type": "string", "description": "外部链接(如品牌官网)" },
-          "profile_pic_url_hd": { "type": "string", "description": "高清头像 URL" }
+          "pk": {
+            "type": "string",
+            "description": "用户数字 ID"
+          },
+          "username": {
+            "type": "string",
+            "description": "用户名"
+          },
+          "full_name": {
+            "type": "string",
+            "description": "显示名称"
+          },
+          "biography": {
+            "type": "string",
+            "description": "个人简介"
+          },
+          "follower_count": {
+            "type": "integer",
+            "description": "粉丝数"
+          },
+          "following_count": {
+            "type": "integer",
+            "description": "关注数"
+          },
+          "media_count": {
+            "type": "integer",
+            "description": "帖子总数"
+          },
+          "is_verified": {
+            "type": "boolean",
+            "description": "是否蓝V认证"
+          },
+          "is_business": {
+            "type": "boolean",
+            "description": "是否商业账号"
+          },
+          "category": {
+            "type": "string",
+            "description": "账号类别"
+          },
+          "external_url": {
+            "type": "string",
+            "description": "外部链接(如品牌官网)"
+          },
+          "profile_pic_url_hd": {
+            "type": "string",
+            "description": "高清头像 URL"
+          }
         }
       }
     }
@@ -54,22 +92,43 @@
   "usageExamples": [
     {
       "name": "获取 NEST New York IG 详情",
-      "input": { "username": "nestnewyork" },
+      "input": {
+        "username": "nestnewyork"
+      },
       "description": "获取 NEST New York 的 IG 粉丝数(报告中显示 144,102)、帖子数等"
     },
     {
       "name": "获取 Paddywax IG 详情",
-      "input": { "username": "paddywax" },
+      "input": {
+        "username": "paddywax"
+      },
       "description": "获取 Paddywax 的 IG 粉丝数(报告中显示 126,441)和帖子数(3,095 条)"
     },
     {
       "name": "获取 SpaRoom IG 详情",
-      "input": { "username": "sparoom" },
+      "input": {
+        "username": "sparoom"
+      },
       "description": "获取 SpaRoom 的 IG 数据(报告中显示极低存在感)"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)", "知识中心(Slide11)"],
-    "dataPoints": ["IG粉丝数", "帖子总数", "认证状态", "品牌简介", "外部链接"]
+    "slides": [
+      "竞品对标(Slide4)",
+      "知识中心(Slide11)"
+    ],
+    "dataPoints": [
+      "IG粉丝数",
+      "帖子总数",
+      "认证状态",
+      "品牌简介",
+      "外部链接"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 67 - 15
social-media/instagram-user-posts/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["user_id"],
+    "required": [
+      "user_id"
+    ],
     "properties": {
       "user_id": {
         "type": "string",
@@ -49,18 +51,39 @@
         "items": {
           "type": "object",
           "properties": {
-            "id": { "type": "string", "description": "帖子 ID" },
-            "code": { "type": "string", "description": "帖子短码(URL 用)" },
+            "id": {
+              "type": "string",
+              "description": "帖子 ID"
+            },
+            "code": {
+              "type": "string",
+              "description": "帖子短码(URL 用)"
+            },
             "caption": {
               "type": "object",
               "properties": {
-                "text": { "type": "string", "description": "帖子文案" }
+                "text": {
+                  "type": "string",
+                  "description": "帖子文案"
+                }
               }
             },
-            "like_count": { "type": "integer", "description": "点赞数" },
-            "comment_count": { "type": "integer", "description": "评论数" },
-            "taken_at": { "type": "integer", "description": "发布时间戳" },
-            "media_type": { "type": "integer", "description": "媒体类型: 1=图片, 2=视频, 8=轮播" },
+            "like_count": {
+              "type": "integer",
+              "description": "点赞数"
+            },
+            "comment_count": {
+              "type": "integer",
+              "description": "评论数"
+            },
+            "taken_at": {
+              "type": "integer",
+              "description": "发布时间戳"
+            },
+            "media_type": {
+              "type": "integer",
+              "description": "媒体类型: 1=图片, 2=视频, 8=轮播"
+            },
             "image_versions2": {
               "type": "object",
               "description": "图片版本列表"
@@ -69,25 +92,54 @@
               "type": "array",
               "description": "视频版本列表(仅视频帖子)"
             },
-            "view_count": { "type": "integer", "description": "视频观看次数(仅视频帖子)" }
+            "view_count": {
+              "type": "integer",
+              "description": "视频观看次数(仅视频帖子)"
+            }
           }
         }
       },
-      "has_more": { "type": "boolean", "description": "是否有更多帖子" },
-      "end_cursor": { "type": "string", "description": "下一页游标" }
+      "has_more": {
+        "type": "boolean",
+        "description": "是否有更多帖子"
+      },
+      "end_cursor": {
+        "type": "string",
+        "description": "下一页游标"
+      }
     }
   },
   "notes": "user_id 需先通过 instagram_user_info 接口获取 pk 字段。帖子的互动率可通过 (like_count + comment_count) / follower_count 计算。",
-  "relatedSkills": ["instagram_user_info", "instagram_search"],
+  "relatedSkills": [
+    "instagram_user_info",
+    "instagram_search"
+  ],
   "usageExamples": [
     {
       "name": "获取品牌最近帖子",
-      "input": { "user_id": "12345678", "count": 12 },
+      "input": {
+        "user_id": "12345678",
+        "count": 12
+      },
       "description": "获取品牌最近 12 条帖子的互动数据,分析内容策略"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)", "社媒聆听(Slide14)"],
-    "dataPoints": ["帖子互动率", "发帖频率", "内容类型分布", "品牌视觉风格"]
+    "slides": [
+      "竞品对标(Slide4)",
+      "社媒聆听(Slide14)"
+    ],
+    "dataPoints": [
+      "帖子互动率",
+      "发帖频率",
+      "内容类型分布",
+      "品牌视觉风格"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 41 - 9
social-media/tiktok-hashtag-detail/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ch_id"],
+    "required": [
+      "ch_id"
+    ],
     "properties": {
       "ch_id": {
         "type": "string",
@@ -34,11 +36,26 @@
       "ch_info": {
         "type": "object",
         "properties": {
-          "cha_name": { "type": "string", "description": "话题名称" },
-          "cid": { "type": "string", "description": "话题 ID" },
-          "desc": { "type": "string", "description": "话题描述" },
-          "view_count": { "type": "integer", "description": "话题总播放量" },
-          "use_count": { "type": "integer", "description": "使用该话题的视频数" }
+          "cha_name": {
+            "type": "string",
+            "description": "话题名称"
+          },
+          "cid": {
+            "type": "string",
+            "description": "话题 ID"
+          },
+          "desc": {
+            "type": "string",
+            "description": "话题描述"
+          },
+          "view_count": {
+            "type": "integer",
+            "description": "话题总播放量"
+          },
+          "use_count": {
+            "type": "integer",
+            "description": "使用该话题的视频数"
+          }
         }
       }
     }
@@ -46,12 +63,27 @@
   "usageExamples": [
     {
       "name": "获取 #candlewarmer 话题详情",
-      "input": { "ch_id": "1234567" },
+      "input": {
+        "ch_id": "1234567"
+      },
       "description": "获取 candlewarmer 话题的总播放量(报告中显示 2750 万播放)"
     }
   ],
   "reportMapping": {
-    "slides": ["TikTok热度排名(Slide6)", "趋势雷达(Slide12)"],
-    "dataPoints": ["话题总播放量", "使用该话题的视频数", "话题增长率"]
+    "slides": [
+      "TikTok热度排名(Slide6)",
+      "趋势雷达(Slide12)"
+    ],
+    "dataPoints": [
+      "话题总播放量",
+      "使用该话题的视频数",
+      "话题增长率"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 55 - 15
social-media/tiktok-hashtag-videos/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ch_id"],
+    "required": [
+      "ch_id"
+    ],
     "properties": {
       "ch_id": {
         "type": "string",
@@ -49,41 +51,79 @@
         "items": {
           "type": "object",
           "properties": {
-            "aweme_id": { "type": "string" },
-            "desc": { "type": "string" },
+            "aweme_id": {
+              "type": "string"
+            },
+            "desc": {
+              "type": "string"
+            },
             "statistics": {
               "type": "object",
               "properties": {
-                "play_count": { "type": "integer" },
-                "digg_count": { "type": "integer" },
-                "comment_count": { "type": "integer" },
-                "share_count": { "type": "integer" }
+                "play_count": {
+                  "type": "integer"
+                },
+                "digg_count": {
+                  "type": "integer"
+                },
+                "comment_count": {
+                  "type": "integer"
+                },
+                "share_count": {
+                  "type": "integer"
+                }
               }
             },
             "author": {
               "type": "object",
               "properties": {
-                "unique_id": { "type": "string" },
-                "nickname": { "type": "string" },
-                "follower_count": { "type": "integer" }
+                "unique_id": {
+                  "type": "string"
+                },
+                "nickname": {
+                  "type": "string"
+                },
+                "follower_count": {
+                  "type": "integer"
+                }
               }
             }
           }
         }
       },
-      "has_more": { "type": "boolean" },
-      "cursor": { "type": "integer" }
+      "has_more": {
+        "type": "boolean"
+      },
+      "cursor": {
+        "type": "integer"
+      }
     }
   },
   "usageExamples": [
     {
       "name": "获取话题视频",
-      "input": { "ch_id": "1234567", "count": 20 },
+      "input": {
+        "ch_id": "1234567",
+        "count": 20
+      },
       "description": "获取 #candlewarmer 话题下的热门视频列表"
     }
   ],
   "reportMapping": {
-    "slides": ["趋势雷达(Slide12)", "社媒聆听(Slide14)"],
-    "dataPoints": ["话题热门视频", "内容灵感", "热门创作者发现"]
+    "slides": [
+      "趋势雷达(Slide12)",
+      "社媒聆听(Slide14)"
+    ],
+    "dataPoints": [
+      "话题热门视频",
+      "内容灵感",
+      "热门创作者发现"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 55 - 14
social-media/tiktok-user-posts/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["sec_user_id"],
+    "required": [
+      "sec_user_id"
+    ],
     "properties": {
       "sec_user_id": {
         "type": "string",
@@ -49,36 +51,75 @@
         "items": {
           "type": "object",
           "properties": {
-            "aweme_id": { "type": "string", "description": "视频 ID" },
-            "desc": { "type": "string", "description": "视频描述" },
+            "aweme_id": {
+              "type": "string",
+              "description": "视频 ID"
+            },
+            "desc": {
+              "type": "string",
+              "description": "视频描述"
+            },
             "statistics": {
               "type": "object",
               "properties": {
-                "play_count": { "type": "integer" },
-                "digg_count": { "type": "integer" },
-                "comment_count": { "type": "integer" },
-                "share_count": { "type": "integer" }
+                "play_count": {
+                  "type": "integer"
+                },
+                "digg_count": {
+                  "type": "integer"
+                },
+                "comment_count": {
+                  "type": "integer"
+                },
+                "share_count": {
+                  "type": "integer"
+                }
               }
             },
-            "create_time": { "type": "integer", "description": "发布时间戳" }
+            "create_time": {
+              "type": "integer",
+              "description": "发布时间戳"
+            }
           }
         }
       },
-      "has_more": { "type": "boolean" },
-      "cursor": { "type": "integer" }
+      "has_more": {
+        "type": "boolean"
+      },
+      "cursor": {
+        "type": "integer"
+      }
     }
   },
   "notes": "sec_user_id 需先通过 tiktok_user_profile 获取。该接口可用于分析竞品品牌的内容发布频率和互动表现。",
-  "relatedSkills": ["tiktok_user_profile"],
+  "relatedSkills": [
+    "tiktok_user_profile"
+  ],
   "usageExamples": [
     {
       "name": "获取品牌视频列表",
-      "input": { "sec_user_id": "MS4wLjABAAAA...", "count": 20 },
+      "input": {
+        "sec_user_id": "MS4wLjABAAAA...",
+        "count": 20
+      },
       "description": "获取品牌最近 20 条视频的播放和互动数据"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)", "社媒聆听(Slide14)"],
-    "dataPoints": ["内容发布频率", "视频平均播放量", "内容类型分布"]
+    "slides": [
+      "竞品对标(Slide4)",
+      "社媒聆听(Slide14)"
+    ],
+    "dataPoints": [
+      "内容发布频率",
+      "视频平均播放量",
+      "内容类型分布"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 77 - 18
social-media/tiktok-user-profile/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["uniqueId"],
+    "required": [
+      "uniqueId"
+    ],
     "properties": {
       "uniqueId": {
         "type": "string",
@@ -34,24 +36,63 @@
       "user": {
         "type": "object",
         "properties": {
-          "id": { "type": "string", "description": "用户 ID" },
-          "uniqueId": { "type": "string", "description": "用户名" },
-          "nickname": { "type": "string", "description": "昵称" },
-          "signature": { "type": "string", "description": "个人简介" },
-          "verified": { "type": "boolean", "description": "是否认证" },
-          "avatarLarger": { "type": "string", "description": "头像 URL" },
-          "secUid": { "type": "string", "description": "安全用户 ID(用于获取帖子)" }
+          "id": {
+            "type": "string",
+            "description": "用户 ID"
+          },
+          "uniqueId": {
+            "type": "string",
+            "description": "用户名"
+          },
+          "nickname": {
+            "type": "string",
+            "description": "昵称"
+          },
+          "signature": {
+            "type": "string",
+            "description": "个人简介"
+          },
+          "verified": {
+            "type": "boolean",
+            "description": "是否认证"
+          },
+          "avatarLarger": {
+            "type": "string",
+            "description": "头像 URL"
+          },
+          "secUid": {
+            "type": "string",
+            "description": "安全用户 ID(用于获取帖子)"
+          }
         }
       },
       "stats": {
         "type": "object",
         "properties": {
-          "followerCount": { "type": "integer", "description": "粉丝数" },
-          "followingCount": { "type": "integer", "description": "关注数" },
-          "heart": { "type": "integer", "description": "获赞总数" },
-          "heartCount": { "type": "integer", "description": "获赞总数(别名)" },
-          "videoCount": { "type": "integer", "description": "作品总数" },
-          "diggCount": { "type": "integer", "description": "点赞数" }
+          "followerCount": {
+            "type": "integer",
+            "description": "粉丝数"
+          },
+          "followingCount": {
+            "type": "integer",
+            "description": "关注数"
+          },
+          "heart": {
+            "type": "integer",
+            "description": "获赞总数"
+          },
+          "heartCount": {
+            "type": "integer",
+            "description": "获赞总数(别名)"
+          },
+          "videoCount": {
+            "type": "integer",
+            "description": "作品总数"
+          },
+          "diggCount": {
+            "type": "integer",
+            "description": "点赞数"
+          }
         }
       }
     }
@@ -60,17 +101,35 @@
   "usageExamples": [
     {
       "name": "查看竞品品牌 TikTok 账号",
-      "input": { "uniqueId": "nestnewyork" },
+      "input": {
+        "uniqueId": "nestnewyork"
+      },
       "description": "获取 NEST New York 的 TikTok 粉丝数和互动数据(报告中显示 12,700 粉丝)"
     },
     {
       "name": "查看达人详情",
-      "input": { "uniqueId": "dealwhisperer" },
+      "input": {
+        "uniqueId": "dealwhisperer"
+      },
       "description": "获取达人 @dealwhisperer 的完整资料(报告中显示 2.1M 粉丝)"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)", "红人达人库(Slide11)"],
-    "dataPoints": ["TikTok粉丝数", "获赞总数", "作品数", "互动率"]
+    "slides": [
+      "竞品对标(Slide4)",
+      "红人达人库(Slide11)"
+    ],
+    "dataPoints": [
+      "TikTok粉丝数",
+      "获赞总数",
+      "作品数",
+      "互动率"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 58 - 13
social-media/tiktok-user-search/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["keyword"],
+    "required": [
+      "keyword"
+    ],
     "properties": {
       "keyword": {
         "type": "string",
@@ -53,14 +55,38 @@
             "user_info": {
               "type": "object",
               "properties": {
-                "unique_id": { "type": "string", "description": "用户名" },
-                "nickname": { "type": "string", "description": "昵称" },
-                "follower_count": { "type": "integer", "description": "粉丝数" },
-                "following_count": { "type": "integer", "description": "关注数" },
-                "total_favorited": { "type": "integer", "description": "获赞总数" },
-                "video_count": { "type": "integer", "description": "作品数" },
-                "avatar_larger": { "type": "object", "description": "头像(大图)" },
-                "signature": { "type": "string", "description": "个人简介" }
+                "unique_id": {
+                  "type": "string",
+                  "description": "用户名"
+                },
+                "nickname": {
+                  "type": "string",
+                  "description": "昵称"
+                },
+                "follower_count": {
+                  "type": "integer",
+                  "description": "粉丝数"
+                },
+                "following_count": {
+                  "type": "integer",
+                  "description": "关注数"
+                },
+                "total_favorited": {
+                  "type": "integer",
+                  "description": "获赞总数"
+                },
+                "video_count": {
+                  "type": "integer",
+                  "description": "作品数"
+                },
+                "avatar_larger": {
+                  "type": "object",
+                  "description": "头像(大图)"
+                },
+                "signature": {
+                  "type": "string",
+                  "description": "个人简介"
+                }
               }
             }
           }
@@ -71,17 +97,36 @@
   "usageExamples": [
     {
       "name": "搜索香薰达人",
-      "input": { "keyword": "candle warmer", "count": 15 },
+      "input": {
+        "keyword": "candle warmer",
+        "count": 15
+      },
       "description": "搜索与 candle warmer 相关的 TikTok 达人"
     },
     {
       "name": "搜索品牌账号",
-      "input": { "keyword": "NEST New York", "count": 5 },
+      "input": {
+        "keyword": "NEST New York",
+        "count": 5
+      },
       "description": "搜索竞品品牌的 TikTok 官方账号"
     }
   ],
   "reportMapping": {
-    "slides": ["红人达人库(Slide11)"],
-    "dataPoints": ["达人粉丝数", "互动率", "作品数", "品类契合度"]
+    "slides": [
+      "红人达人库(Slide11)"
+    ],
+    "dataPoints": [
+      "达人粉丝数",
+      "互动率",
+      "作品数",
+      "品类契合度"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 61 - 14
social-media/tiktok-video-comments/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["aweme_id"],
+    "required": [
+      "aweme_id"
+    ],
     "properties": {
       "aweme_id": {
         "type": "string",
@@ -49,35 +51,80 @@
         "items": {
           "type": "object",
           "properties": {
-            "cid": { "type": "string", "description": "评论 ID" },
-            "text": { "type": "string", "description": "评论内容" },
-            "digg_count": { "type": "integer", "description": "评论点赞数" },
-            "reply_comment_total": { "type": "integer", "description": "回复数" },
-            "create_time": { "type": "integer", "description": "评论时间戳" },
+            "cid": {
+              "type": "string",
+              "description": "评论 ID"
+            },
+            "text": {
+              "type": "string",
+              "description": "评论内容"
+            },
+            "digg_count": {
+              "type": "integer",
+              "description": "评论点赞数"
+            },
+            "reply_comment_total": {
+              "type": "integer",
+              "description": "回复数"
+            },
+            "create_time": {
+              "type": "integer",
+              "description": "评论时间戳"
+            },
             "user": {
               "type": "object",
               "properties": {
-                "nickname": { "type": "string", "description": "评论者昵称" },
-                "unique_id": { "type": "string", "description": "评论者用户名" }
+                "nickname": {
+                  "type": "string",
+                  "description": "评论者昵称"
+                },
+                "unique_id": {
+                  "type": "string",
+                  "description": "评论者用户名"
+                }
               }
             }
           }
         }
       },
-      "has_more": { "type": "boolean", "description": "是否有更多评论" },
-      "cursor": { "type": "integer", "description": "下一页游标" },
-      "total": { "type": "integer", "description": "评论总数" }
+      "has_more": {
+        "type": "boolean",
+        "description": "是否有更多评论"
+      },
+      "cursor": {
+        "type": "integer",
+        "description": "下一页游标"
+      },
+      "total": {
+        "type": "integer",
+        "description": "评论总数"
+      }
     }
   },
   "usageExamples": [
     {
       "name": "获取视频评论",
-      "input": { "aweme_id": "7300000000000000000", "count": 20 },
+      "input": {
+        "aweme_id": "7300000000000000000",
+        "count": 20
+      },
       "description": "获取视频前 20 条评论用于 AI 情感分析"
     }
   ],
   "reportMapping": {
-    "slides": ["社媒聆听(Slide14)"],
-    "dataPoints": ["视频评论内容", "用户情感倾向", "需求关键词提取"]
+    "slides": [
+      "社媒聆听(Slide14)"
+    ],
+    "dataPoints": [
+      "视频评论内容",
+      "用户情感倾向",
+      "需求关键词提取"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 69 - 17
social-media/tiktok-video-detail/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["aweme_id"],
+    "required": [
+      "aweme_id"
+    ],
     "properties": {
       "aweme_id": {
         "type": "string",
@@ -31,32 +33,68 @@
     "type": "object",
     "description": "视频详情对象",
     "properties": {
-      "aweme_id": { "type": "string", "description": "视频 ID" },
-      "desc": { "type": "string", "description": "视频描述" },
+      "aweme_id": {
+        "type": "string",
+        "description": "视频 ID"
+      },
+      "desc": {
+        "type": "string",
+        "description": "视频描述"
+      },
       "statistics": {
         "type": "object",
         "properties": {
-          "play_count": { "type": "integer", "description": "播放量" },
-          "digg_count": { "type": "integer", "description": "点赞数" },
-          "comment_count": { "type": "integer", "description": "评论数" },
-          "share_count": { "type": "integer", "description": "分享数" }
+          "play_count": {
+            "type": "integer",
+            "description": "播放量"
+          },
+          "digg_count": {
+            "type": "integer",
+            "description": "点赞数"
+          },
+          "comment_count": {
+            "type": "integer",
+            "description": "评论数"
+          },
+          "share_count": {
+            "type": "integer",
+            "description": "分享数"
+          }
         }
       },
       "author": {
         "type": "object",
         "properties": {
-          "nickname": { "type": "string" },
-          "unique_id": { "type": "string" },
-          "follower_count": { "type": "integer" }
+          "nickname": {
+            "type": "string"
+          },
+          "unique_id": {
+            "type": "string"
+          },
+          "follower_count": {
+            "type": "integer"
+          }
         }
       },
-      "create_time": { "type": "integer", "description": "视频创建时间戳" },
-      "cha_list": { "type": "array", "description": "关联话题列表" },
+      "create_time": {
+        "type": "integer",
+        "description": "视频创建时间戳"
+      },
+      "cha_list": {
+        "type": "array",
+        "description": "关联话题列表"
+      },
       "video": {
         "type": "object",
         "properties": {
-          "cover": { "type": "object", "description": "封面图信息" },
-          "duration": { "type": "integer", "description": "视频时长(ms)" }
+          "cover": {
+            "type": "object",
+            "description": "封面图信息"
+          },
+          "duration": {
+            "type": "integer",
+            "description": "视频时长(ms)"
+          }
         }
       }
     }
@@ -64,12 +102,26 @@
   "usageExamples": [
     {
       "name": "获取视频详情",
-      "input": { "aweme_id": "7300000000000000000" },
+      "input": {
+        "aweme_id": "7300000000000000000"
+      },
       "description": "获取指定视频的完整播放和互动数据"
     }
   ],
   "reportMapping": {
-    "slides": ["社媒聆听(Slide14)"],
-    "dataPoints": ["视频播放量", "互动数据", "作者信息"]
+    "slides": [
+      "社媒聆听(Slide14)"
+    ],
+    "dataPoints": [
+      "视频播放量",
+      "互动数据",
+      "作者信息"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 79 - 18
social-media/tiktok-video-search/api-config.json

@@ -14,7 +14,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["keyword"],
+    "required": [
+      "keyword"
+    ],
     "properties": {
       "keyword": {
         "type": "string",
@@ -52,23 +54,50 @@
         "items": {
           "type": "object",
           "properties": {
-            "aweme_id": { "type": "string", "description": "视频唯一 ID" },
-            "desc": { "type": "string", "description": "视频描述/标题" },
+            "aweme_id": {
+              "type": "string",
+              "description": "视频唯一 ID"
+            },
+            "desc": {
+              "type": "string",
+              "description": "视频描述/标题"
+            },
             "statistics": {
               "type": "object",
               "properties": {
-                "play_count": { "type": "integer", "description": "播放量" },
-                "digg_count": { "type": "integer", "description": "点赞数" },
-                "comment_count": { "type": "integer", "description": "评论数" },
-                "share_count": { "type": "integer", "description": "分享数" }
+                "play_count": {
+                  "type": "integer",
+                  "description": "播放量"
+                },
+                "digg_count": {
+                  "type": "integer",
+                  "description": "点赞数"
+                },
+                "comment_count": {
+                  "type": "integer",
+                  "description": "评论数"
+                },
+                "share_count": {
+                  "type": "integer",
+                  "description": "分享数"
+                }
               }
             },
             "author": {
               "type": "object",
               "properties": {
-                "nickname": { "type": "string", "description": "作者昵称" },
-                "unique_id": { "type": "string", "description": "作者用户名" },
-                "follower_count": { "type": "integer", "description": "作者粉丝数" }
+                "nickname": {
+                  "type": "string",
+                  "description": "作者昵称"
+                },
+                "unique_id": {
+                  "type": "string",
+                  "description": "作者用户名"
+                },
+                "follower_count": {
+                  "type": "integer",
+                  "description": "作者粉丝数"
+                }
               }
             },
             "cha_list": {
@@ -77,8 +106,14 @@
               "items": {
                 "type": "object",
                 "properties": {
-                  "cha_name": { "type": "string", "description": "话题名称" },
-                  "cha_id": { "type": "string", "description": "话题 ID" }
+                  "cha_name": {
+                    "type": "string",
+                    "description": "话题名称"
+                  },
+                  "cha_id": {
+                    "type": "string",
+                    "description": "话题 ID"
+                  }
                 }
               }
             }
@@ -89,25 +124,51 @@
         "type": "array",
         "description": "备选数据路径(当 aweme_list 为空时从此取 aweme_info)"
       },
-      "has_more": { "type": "boolean", "description": "是否有更多数据" },
-      "cursor": { "type": "integer", "description": "下一页游标" }
+      "has_more": {
+        "type": "boolean",
+        "description": "是否有更多数据"
+      },
+      "cursor": {
+        "type": "integer",
+        "description": "下一页游标"
+      }
     }
   },
   "notes": "响应数据可能在 aweme_list 或 search_item_list[].aweme_info 中,需做兼容处理。前端已封装 searchVideosV2 方法自动处理两种结构。",
   "usageExamples": [
     {
       "name": "搜索 candle warmer 视频",
-      "input": { "keyword": "candle warmer", "count": 20 },
+      "input": {
+        "keyword": "candle warmer",
+        "count": 20
+      },
       "description": "搜索 candle warmer 相关视频,获取播放量和互动数据(报告中显示 2750 万播放)"
     },
     {
       "name": "搜索 reed diffuser 视频",
-      "input": { "keyword": "reed diffuser", "count": 20 },
+      "input": {
+        "keyword": "reed diffuser",
+        "count": 20
+      },
       "description": "搜索 reed diffuser 相关视频用于社媒聆听分析"
     }
   ],
   "reportMapping": {
-    "slides": ["TikTok热度排名(Slide6)", "社媒聆听(Slide14)"],
-    "dataPoints": ["品类TikTok总播放量", "视频互动率", "爆款视频列表", "相关话题标签"]
+    "slides": [
+      "TikTok热度排名(Slide6)",
+      "社媒聆听(Slide14)"
+    ],
+    "dataPoints": [
+      "品类TikTok总播放量",
+      "视频互动率",
+      "爆款视频列表",
+      "相关话题标签"
+    ]
+  },
+  "timeout": 15000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1500,
+    "backoffMultiplier": 2
   }
 }

+ 40 - 9
voc/asin-reverse-keywords/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ASIN"],
+    "required": [
+      "ASIN"
+    ],
     "properties": {
       "ASIN": {
         "type": "string",
@@ -31,7 +33,9 @@
     "template": {
       "path": "/api/ASINRequestKeyword",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "ASIN": "{{ASIN}}"
       }
@@ -43,22 +47,49 @@
     "items": {
       "type": "object",
       "properties": {
-        "Keyword": { "type": "string", "description": "关键词" },
-        "SearchVolume": { "type": "integer", "description": "月搜索量" },
-        "Rank": { "type": "integer", "description": "该ASIN在此关键词下的排名" },
-        "CompetitorCount": { "type": "integer", "description": "竞争产品数" }
+        "Keyword": {
+          "type": "string",
+          "description": "关键词"
+        },
+        "SearchVolume": {
+          "type": "integer",
+          "description": "月搜索量"
+        },
+        "Rank": {
+          "type": "integer",
+          "description": "该ASIN在此关键词下的排名"
+        },
+        "CompetitorCount": {
+          "type": "integer",
+          "description": "竞争产品数"
+        }
       }
     }
   },
   "usageExamples": [
     {
       "name": "反查竞品关键词",
-      "input": { "ASIN": "B0B24QJ217", "domain": 1 },
+      "input": {
+        "ASIN": "B0B24QJ217",
+        "domain": 1
+      },
       "description": "查看 COCORRINA Reed Diffuser 排名靠前的搜索关键词"
     }
   ],
   "reportMapping": {
-    "slides": ["广告关键词引擎(Slide15)"],
-    "dataPoints": ["竞品关键词列表", "搜索排名", "搜索量"]
+    "slides": [
+      "广告关键词引擎(Slide15)"
+    ],
+    "dataPoints": [
+      "竞品关键词列表",
+      "搜索排名",
+      "搜索量"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 45 - 10
voc/asin-sales-volume/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ASIN"],
+    "required": [
+      "ASIN"
+    ],
     "properties": {
       "ASIN": {
         "type": "string",
@@ -31,7 +33,9 @@
     "template": {
       "path": "/api/AsinSalesVolume",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "ASIN": "{{ASIN}}"
       }
@@ -41,22 +45,53 @@
     "type": "object",
     "description": "销量数据",
     "properties": {
-      "DailySales": { "type": "integer", "description": "日均销量" },
-      "WeeklySales": { "type": "integer", "description": "周均销量" },
-      "MonthlySales": { "type": "integer", "description": "月均销量" },
-      "Revenue": { "type": "number", "description": "估算收入(美元)" },
-      "SalesTrend": { "type": "array", "description": "销量趋势数据点" }
+      "DailySales": {
+        "type": "integer",
+        "description": "日均销量"
+      },
+      "WeeklySales": {
+        "type": "integer",
+        "description": "周均销量"
+      },
+      "MonthlySales": {
+        "type": "integer",
+        "description": "月均销量"
+      },
+      "Revenue": {
+        "type": "number",
+        "description": "估算收入(美元)"
+      },
+      "SalesTrend": {
+        "type": "array",
+        "description": "销量趋势数据点"
+      }
     }
   },
   "usageExamples": [
     {
       "name": "查询产品销量",
-      "input": { "ASIN": "B0CSVRWJ1H", "domain": 1 },
+      "input": {
+        "ASIN": "B0CSVRWJ1H",
+        "domain": 1
+      },
       "description": "查询该产品的日/周/月销量和收入估算"
     }
   ],
   "reportMapping": {
-    "slides": ["市场全景(Slide3)", "品类矩阵(Slide6)"],
-    "dataPoints": ["周均销量", "周均销售额", "销量趋势"]
+    "slides": [
+      "市场全景(Slide3)",
+      "品类矩阵(Slide6)"
+    ],
+    "dataPoints": [
+      "周均销量",
+      "周均销售额",
+      "销量趋势"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 55 - 13
voc/category-products/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["NodeId"],
+    "required": [
+      "NodeId"
+    ],
     "properties": {
       "NodeId": {
         "type": "string",
@@ -30,7 +32,9 @@
     "template": {
       "path": "/api/CategoryProducts",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "NodeId": "{{NodeId}}"
       }
@@ -42,26 +46,64 @@
     "items": {
       "type": "object",
       "properties": {
-        "Asin": { "type": "string", "description": "产品 ASIN" },
-        "Title": { "type": "string", "description": "产品标题" },
-        "Price": { "type": "number", "description": "售价" },
-        "Rating": { "type": "number", "description": "评分" },
-        "RatingsCount": { "type": "integer", "description": "评论数" },
-        "BSR": { "type": "integer", "description": "BSR 排名" },
-        "Brand": { "type": "string", "description": "品牌" }
+        "Asin": {
+          "type": "string",
+          "description": "产品 ASIN"
+        },
+        "Title": {
+          "type": "string",
+          "description": "产品标题"
+        },
+        "Price": {
+          "type": "number",
+          "description": "售价"
+        },
+        "Rating": {
+          "type": "number",
+          "description": "评分"
+        },
+        "RatingsCount": {
+          "type": "integer",
+          "description": "评论数"
+        },
+        "BSR": {
+          "type": "integer",
+          "description": "BSR 排名"
+        },
+        "Brand": {
+          "type": "string",
+          "description": "品牌"
+        }
       }
     }
   },
-  "relatedSkills": ["category_tree"],
+  "relatedSkills": [
+    "category_tree"
+  ],
   "usageExamples": [
     {
       "name": "获取类目产品列表",
-      "input": { "NodeId": "3734931", "domain": 1 },
+      "input": {
+        "NodeId": "3734931",
+        "domain": 1
+      },
       "description": "获取指定类目下的产品列表"
     }
   ],
   "reportMapping": {
-    "slides": ["市场全景(Slide3)"],
-    "dataPoints": ["品类产品列表", "品牌分布", "价格带分析"]
+    "slides": [
+      "市场全景(Slide3)"
+    ],
+    "dataPoints": [
+      "品类产品列表",
+      "品牌分布",
+      "价格带分析"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 33 - 8
voc/category-tree/api-config.json

@@ -25,7 +25,9 @@
     "template": {
       "path": "/api/CategoryTree",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {}
     }
   },
@@ -35,22 +37,45 @@
     "items": {
       "type": "object",
       "properties": {
-        "NodeId": { "type": "string", "description": "类目节点 ID" },
-        "Name": { "type": "string", "description": "类目名称" },
-        "Children": { "type": "array", "description": "子类目列表" }
+        "NodeId": {
+          "type": "string",
+          "description": "类目节点 ID"
+        },
+        "Name": {
+          "type": "string",
+          "description": "类目名称"
+        },
+        "Children": {
+          "type": "array",
+          "description": "子类目列表"
+        }
       }
     }
   },
-  "relatedSkills": ["category_products"],
+  "relatedSkills": [
+    "category_products"
+  ],
   "usageExamples": [
     {
       "name": "获取美国站类目树",
-      "input": { "domain": 1 },
+      "input": {
+        "domain": 1
+      },
       "description": "获取 amazon.com 的完整类目层级结构"
     }
   ],
   "reportMapping": {
-    "slides": ["市场全景(Slide3)"],
-    "dataPoints": ["品类类目定位"]
+    "slides": [
+      "市场全景(Slide3)"
+    ],
+    "dataPoints": [
+      "品类类目定位"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 52 - 12
voc/keyword-product-ranking/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["Keyword"],
+    "required": [
+      "Keyword"
+    ],
     "properties": {
       "Keyword": {
         "type": "string",
@@ -30,7 +32,9 @@
     "template": {
       "path": "/api/KeywordProductRanking",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "Keyword": "{{Keyword}}"
       }
@@ -42,25 +46,61 @@
     "items": {
       "type": "object",
       "properties": {
-        "Asin": { "type": "string", "description": "产品 ASIN" },
-        "Title": { "type": "string", "description": "产品标题" },
-        "Rank": { "type": "integer", "description": "在该关键词下的排名" },
-        "Price": { "type": "number", "description": "售价" },
-        "Rating": { "type": "number", "description": "评分" },
-        "RatingsCount": { "type": "integer", "description": "评论数" },
-        "IsSponsored": { "type": "boolean", "description": "是否为广告产品" }
+        "Asin": {
+          "type": "string",
+          "description": "产品 ASIN"
+        },
+        "Title": {
+          "type": "string",
+          "description": "产品标题"
+        },
+        "Rank": {
+          "type": "integer",
+          "description": "在该关键词下的排名"
+        },
+        "Price": {
+          "type": "number",
+          "description": "售价"
+        },
+        "Rating": {
+          "type": "number",
+          "description": "评分"
+        },
+        "RatingsCount": {
+          "type": "integer",
+          "description": "评论数"
+        },
+        "IsSponsored": {
+          "type": "boolean",
+          "description": "是否为广告产品"
+        }
       }
     }
   },
   "usageExamples": [
     {
       "name": "查询关键词产品排名",
-      "input": { "Keyword": "reed diffuser", "domain": 1 },
+      "input": {
+        "Keyword": "reed diffuser",
+        "domain": 1
+      },
       "description": "获取 'reed diffuser' 搜索结果页产品排名"
     }
   ],
   "reportMapping": {
-    "slides": ["趋势雷达(Slide12)", "广告关键词引擎(Slide15)"],
-    "dataPoints": ["关键词排名", "竞品在关键词下的位置"]
+    "slides": [
+      "趋势雷达(Slide12)",
+      "广告关键词引擎(Slide15)"
+    ],
+    "dataPoints": [
+      "关键词排名",
+      "竞品在关键词下的位置"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 35 - 8
voc/keyword-search-trend/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["Keyword"],
+    "required": [
+      "Keyword"
+    ],
     "properties": {
       "Keyword": {
         "type": "string",
@@ -30,7 +32,9 @@
     "template": {
       "path": "/api/KeywordSearchResultTrend",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "Keyword": "{{Keyword}}"
       }
@@ -46,9 +50,18 @@
         "items": {
           "type": "object",
           "properties": {
-            "Date": { "type": "string", "description": "日期" },
-            "SearchVolume": { "type": "integer", "description": "搜索量" },
-            "ProductCount": { "type": "integer", "description": "搜索结果产品数" }
+            "Date": {
+              "type": "string",
+              "description": "日期"
+            },
+            "SearchVolume": {
+              "type": "integer",
+              "description": "搜索量"
+            },
+            "ProductCount": {
+              "type": "integer",
+              "description": "搜索结果产品数"
+            }
           }
         }
       }
@@ -57,12 +70,26 @@
   "usageExamples": [
     {
       "name": "查询关键词搜索趋势",
-      "input": { "Keyword": "candle warmer lamp aesthetic", "domain": 1 },
+      "input": {
+        "Keyword": "candle warmer lamp aesthetic",
+        "domain": 1
+      },
       "description": "查看 'candle warmer lamp aesthetic' 的搜索量变化趋势"
     }
   ],
   "reportMapping": {
-    "slides": ["趋势雷达(Slide12)"],
-    "dataPoints": ["关键词搜索趋势", "飙升卖点词增幅"]
+    "slides": [
+      "趋势雷达(Slide12)"
+    ],
+    "dataPoints": [
+      "关键词搜索趋势",
+      "飙升卖点词增幅"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 51 - 11
voc/keyword-search/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["Keyword"],
+    "required": [
+      "Keyword"
+    ],
     "properties": {
       "Keyword": {
         "type": "string",
@@ -30,7 +32,9 @@
     "template": {
       "path": "/api/KeywordQuery",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "Keyword": "{{Keyword}}"
       }
@@ -40,23 +44,59 @@
     "type": "object",
     "description": "关键词查询结果",
     "properties": {
-      "SearchVolume": { "type": "integer", "description": "月搜索量" },
-      "SearchVolumeGrowth": { "type": "number", "description": "搜索量增长率 (%)" },
-      "CompetitionLevel": { "type": "string", "description": "竞争度: 低/中/高/极高" },
-      "CPC": { "type": "number", "description": "建议广告出价 (美元)" },
-      "ConversionRate": { "type": "number", "description": "转化率 (%)" },
-      "RelatedKeywords": { "type": "array", "description": "相关关键词列表" }
+      "SearchVolume": {
+        "type": "integer",
+        "description": "月搜索量"
+      },
+      "SearchVolumeGrowth": {
+        "type": "number",
+        "description": "搜索量增长率 (%)"
+      },
+      "CompetitionLevel": {
+        "type": "string",
+        "description": "竞争度: 低/中/高/极高"
+      },
+      "CPC": {
+        "type": "number",
+        "description": "建议广告出价 (美元)"
+      },
+      "ConversionRate": {
+        "type": "number",
+        "description": "转化率 (%)"
+      },
+      "RelatedKeywords": {
+        "type": "array",
+        "description": "相关关键词列表"
+      }
     }
   },
   "usageExamples": [
     {
       "name": "查询关键词搜索量",
-      "input": { "Keyword": "natural reed diffuser", "domain": 1 },
+      "input": {
+        "Keyword": "natural reed diffuser",
+        "domain": 1
+      },
       "description": "查询 'natural reed diffuser' 在美国站的搜索量和竞争度"
     }
   ],
   "reportMapping": {
-    "slides": ["趋势雷达(Slide12)", "广告关键词引擎(Slide15)"],
-    "dataPoints": ["关键词搜索量", "增长率", "竞争度", "建议出价", "VOC匹配度"]
+    "slides": [
+      "趋势雷达(Slide12)",
+      "广告关键词引擎(Slide15)"
+    ],
+    "dataPoints": [
+      "关键词搜索量",
+      "增长率",
+      "竞争度",
+      "建议出价",
+      "VOC匹配度"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 148 - 33
voc/product-detail-query/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ASIN"],
+    "required": [
+      "ASIN"
+    ],
     "properties": {
       "ASIN": {
         "type": "string",
@@ -24,13 +26,25 @@
         "type": "integer",
         "description": "Amazon 站点 ID: 1=amazon.com, 2=amazon.co.uk, 3=amazon.de, 4=amazon.co.jp, 5=amazon.fr, 6=amazon.it, 7=amazon.es, 8=amazon.ca",
         "default": 1,
-        "enum": [1, 2, 3, 4, 5, 6, 7, 8]
+        "enum": [
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8
+        ]
       },
       "Trend": {
         "type": "integer",
         "description": "是否返回趋势数据: 1=是, 0=否",
         "default": 1,
-        "enum": [0, 1]
+        "enum": [
+          0,
+          1
+        ]
       },
       "QueryTrendStartDt": {
         "type": "string",
@@ -49,7 +63,9 @@
     "template": {
       "path": "/api/ProductRequest",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "ASIN": "{{ASIN}}",
         "Trend": "{{Trend}}",
@@ -62,43 +78,142 @@
     "type": "object",
     "description": "产品详情对象",
     "properties": {
-      "Title": { "type": "string", "description": "产品标题" },
-      "Price": { "type": "number", "description": "当前售价(美元)" },
-      "SalesPrice": { "type": "number", "description": "促销价(美元)" },
-      "Brand": { "type": "string", "description": "品牌名称" },
-      "StoreName": { "type": "string", "description": "店铺名称" },
-      "Rating": { "type": "number", "description": "平均评分 (0-5)" },
-      "RatingsCount": { "type": "integer", "description": "评论总数" },
-      "fiveStartRatings": { "type": "number", "description": "5星评分百分比" },
-      "fourStartRatings": { "type": "number", "description": "4星评分百分比" },
-      "threeStartRatings": { "type": "number", "description": "3星评分百分比" },
-      "twoStartRatings": { "type": "number", "description": "2星评分百分比" },
-      "oneStartRatings": { "type": "number", "description": "1星评分百分比" },
-      "MonthlySales": { "type": "integer", "description": "月销量估算" },
-      "BSR": { "type": "integer", "description": "Best Sellers Rank 大类排名" },
-      "Category": { "type": "array", "description": "类目层级" },
-      "BsrCategory": { "type": "array", "description": "BSR 类目层级" },
-      "Photo": { "type": "array", "description": "产品图片 URL 列表" },
-      "Feature": { "type": "object", "description": "产品 Bullet Points 卖点" },
-      "Description": { "type": "string", "description": "产品描述" },
-      "Property": { "type": "string", "description": "产品属性(JSON 字符串)" },
-      "VariationASIN": { "type": "array", "description": "变体 ASIN 列表" },
-      "Size": { "type": "array", "description": "尺寸选项" },
-      "ShipsFrom": { "type": "string", "description": "发货地" },
-      "ProductType": { "type": "string", "description": "配送类型 (FBA/FBM)" },
-      "DealType": { "type": "string", "description": "促销类型" },
-      "UpdateDate": { "type": "string", "description": "数据更新日期" }
+      "Title": {
+        "type": "string",
+        "description": "产品标题"
+      },
+      "Price": {
+        "type": "number",
+        "description": "当前售价(美元)"
+      },
+      "SalesPrice": {
+        "type": "number",
+        "description": "促销价(美元)"
+      },
+      "Brand": {
+        "type": "string",
+        "description": "品牌名称"
+      },
+      "StoreName": {
+        "type": "string",
+        "description": "店铺名称"
+      },
+      "Rating": {
+        "type": "number",
+        "description": "平均评分 (0-5)"
+      },
+      "RatingsCount": {
+        "type": "integer",
+        "description": "评论总数"
+      },
+      "fiveStartRatings": {
+        "type": "number",
+        "description": "5星评分百分比"
+      },
+      "fourStartRatings": {
+        "type": "number",
+        "description": "4星评分百分比"
+      },
+      "threeStartRatings": {
+        "type": "number",
+        "description": "3星评分百分比"
+      },
+      "twoStartRatings": {
+        "type": "number",
+        "description": "2星评分百分比"
+      },
+      "oneStartRatings": {
+        "type": "number",
+        "description": "1星评分百分比"
+      },
+      "MonthlySales": {
+        "type": "integer",
+        "description": "月销量估算"
+      },
+      "BSR": {
+        "type": "integer",
+        "description": "Best Sellers Rank 大类排名"
+      },
+      "Category": {
+        "type": "array",
+        "description": "类目层级"
+      },
+      "BsrCategory": {
+        "type": "array",
+        "description": "BSR 类目层级"
+      },
+      "Photo": {
+        "type": "array",
+        "description": "产品图片 URL 列表"
+      },
+      "Feature": {
+        "type": "object",
+        "description": "产品 Bullet Points 卖点"
+      },
+      "Description": {
+        "type": "string",
+        "description": "产品描述"
+      },
+      "Property": {
+        "type": "string",
+        "description": "产品属性(JSON 字符串)"
+      },
+      "VariationASIN": {
+        "type": "array",
+        "description": "变体 ASIN 列表"
+      },
+      "Size": {
+        "type": "array",
+        "description": "尺寸选项"
+      },
+      "ShipsFrom": {
+        "type": "string",
+        "description": "发货地"
+      },
+      "ProductType": {
+        "type": "string",
+        "description": "配送类型 (FBA/FBM)"
+      },
+      "DealType": {
+        "type": "string",
+        "description": "促销类型"
+      },
+      "UpdateDate": {
+        "type": "string",
+        "description": "数据更新日期"
+      }
     }
   },
   "usageExamples": [
     {
       "name": "查询单个产品详情",
-      "input": { "ASIN": "B0CSVRWJ1H", "domain": 1, "Trend": 1 },
+      "input": {
+        "ASIN": "B0CSVRWJ1H",
+        "domain": 1,
+        "Trend": 1
+      },
       "description": "获取美国站产品 B0CSVRWJ1H 的完整信息和趋势数据"
     }
   ],
   "reportMapping": {
-    "slides": ["市场全景(Slide3)", "竞品对标(Slide4)", "品类矩阵(Slide6)"],
-    "dataPoints": ["价格", "评分", "月销量", "BSR", "品牌", "类目"]
+    "slides": [
+      "市场全景(Slide3)",
+      "竞品对标(Slide4)",
+      "品类矩阵(Slide6)"
+    ],
+    "dataPoints": [
+      "价格",
+      "评分",
+      "月销量",
+      "BSR",
+      "品牌",
+      "类目"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 42 - 9
voc/product-monitor/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ASIN"],
+    "required": [
+      "ASIN"
+    ],
     "properties": {
       "ASIN": {
         "type": "string",
@@ -31,7 +33,9 @@
     "template": {
       "path": "/api/MonitorQuery",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "ASIN": "{{ASIN}}"
       }
@@ -41,21 +45,50 @@
     "type": "object",
     "description": "监控数据",
     "properties": {
-      "PriceHistory": { "type": "array", "description": "价格历史数据" },
-      "RankHistory": { "type": "array", "description": "排名历史数据" },
-      "RatingHistory": { "type": "array", "description": "评分历史数据" },
-      "ReviewCountHistory": { "type": "array", "description": "评论数历史数据" }
+      "PriceHistory": {
+        "type": "array",
+        "description": "价格历史数据"
+      },
+      "RankHistory": {
+        "type": "array",
+        "description": "排名历史数据"
+      },
+      "RatingHistory": {
+        "type": "array",
+        "description": "评分历史数据"
+      },
+      "ReviewCountHistory": {
+        "type": "array",
+        "description": "评论数历史数据"
+      }
     }
   },
   "usageExamples": [
     {
       "name": "监控竞品价格变化",
-      "input": { "ASIN": "B0B24QJ217", "domain": 1 },
+      "input": {
+        "ASIN": "B0B24QJ217",
+        "domain": 1
+      },
       "description": "获取 COCORRINA Reed Diffuser 的价格和排名变化历史"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)", "智能仪表盘(Slide10)"],
-    "dataPoints": ["价格变化", "BSR排名变化", "评分变化", "竞品动态预警"]
+    "slides": [
+      "竞品对标(Slide4)",
+      "智能仪表盘(Slide10)"
+    ],
+    "dataPoints": [
+      "价格变化",
+      "BSR排名变化",
+      "评分变化",
+      "竞品动态预警"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 120 - 26
voc/product-reviews-query/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ASIN"],
+    "required": [
+      "ASIN"
+    ],
     "properties": {
       "ASIN": {
         "type": "string",
@@ -24,7 +26,14 @@
         "type": "string",
         "description": "筛选星级: 空=全部, '1'=1星, '2'=2星, '3'=3星, '4'=4星, '5'=5星",
         "default": "",
-        "enum": ["", "1", "2", "3", "4", "5"]
+        "enum": [
+          "",
+          "1",
+          "2",
+          "3",
+          "4",
+          "5"
+        ]
       },
       "PageIndex": {
         "type": "integer",
@@ -35,7 +44,10 @@
         "type": "integer",
         "description": "仅显示验证购买评论: 0=全部, 1=仅验证购买",
         "default": 0,
-        "enum": [0, 1]
+        "enum": [
+          0,
+          1
+        ]
       },
       "QueryStartDt": {
         "type": "string",
@@ -53,7 +65,9 @@
     "template": {
       "path": "/api/ProductReviewsQuery",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "ASIN": "{{ASIN}}",
         "Star": "{{Star}}",
@@ -67,29 +81,80 @@
     "type": "object",
     "description": "评论查询结果",
     "properties": {
-      "TotalCount": { "type": "integer", "description": "评论总数" },
+      "TotalCount": {
+        "type": "integer",
+        "description": "评论总数"
+      },
       "Reviews": {
         "type": "array",
         "description": "评论列表",
         "items": {
           "type": "object",
           "properties": {
-            "Star": { "type": "integer", "description": "评论星级 (1-5)" },
-            "Title": { "type": "string", "description": "评论标题" },
-            "Content": { "type": "string", "description": "评论正文" },
-            "ConsumerName": { "type": "string", "description": "评论者名称" },
-            "ReviewsDate": { "type": "string", "description": "评论日期,格式 '20260204'" },
-            "ReviewedCountry": { "type": "string", "description": "评论者国家,如 'United States'" },
-            "IsVP": { "type": "boolean", "description": "是否验证购买" },
-            "Helpful": { "type": "integer", "description": "有用数" },
-            "Asin": { "type": "string", "description": "关联产品 ASIN" },
-            "AsinProperty": { "type": "string", "description": "变体属性" },
-            "Resource": { "type": "array", "description": "评论附图 URL" },
-            "Videos": { "type": "array", "description": "评论视频 URL" },
-            "ConsumerURL": { "type": "string", "description": "评论者主页链接" },
-            "ReviewsLink": { "type": "string", "description": "评论详情链接" },
-            "ConsumerBadge": { "type": "string", "description": "评论者徽章" },
-            "UpdateTime": { "type": "string", "description": "数据更新时间,格式 '2026-02-06 17:39'" }
+            "Star": {
+              "type": "integer",
+              "description": "评论星级 (1-5)"
+            },
+            "Title": {
+              "type": "string",
+              "description": "评论标题"
+            },
+            "Content": {
+              "type": "string",
+              "description": "评论正文"
+            },
+            "ConsumerName": {
+              "type": "string",
+              "description": "评论者名称"
+            },
+            "ReviewsDate": {
+              "type": "string",
+              "description": "评论日期,格式 '20260204'"
+            },
+            "ReviewedCountry": {
+              "type": "string",
+              "description": "评论者国家,如 'United States'"
+            },
+            "IsVP": {
+              "type": "boolean",
+              "description": "是否验证购买"
+            },
+            "Helpful": {
+              "type": "integer",
+              "description": "有用数"
+            },
+            "Asin": {
+              "type": "string",
+              "description": "关联产品 ASIN"
+            },
+            "AsinProperty": {
+              "type": "string",
+              "description": "变体属性"
+            },
+            "Resource": {
+              "type": "array",
+              "description": "评论附图 URL"
+            },
+            "Videos": {
+              "type": "array",
+              "description": "评论视频 URL"
+            },
+            "ConsumerURL": {
+              "type": "string",
+              "description": "评论者主页链接"
+            },
+            "ReviewsLink": {
+              "type": "string",
+              "description": "评论详情链接"
+            },
+            "ConsumerBadge": {
+              "type": "string",
+              "description": "评论者徽章"
+            },
+            "UpdateTime": {
+              "type": "string",
+              "description": "数据更新时间,格式 '2026-02-06 17:39'"
+            }
           }
         }
       }
@@ -99,22 +164,51 @@
   "usageExamples": [
     {
       "name": "获取全部评论(第一页)",
-      "input": { "ASIN": "B0B24QJ217", "domain": 1 },
+      "input": {
+        "ASIN": "B0B24QJ217",
+        "domain": 1
+      },
       "description": "获取 COCORRINA Reed Diffuser 的全部评论第一页"
     },
     {
       "name": "获取差评(1-2星)",
-      "input": { "ASIN": "B0B24QJ217", "Star": "1", "PageIndex": 1, "domain": 1 },
+      "input": {
+        "ASIN": "B0B24QJ217",
+        "Star": "1",
+        "PageIndex": 1,
+        "domain": 1
+      },
       "description": "仅获取1星差评,用于痛点分析"
     },
     {
       "name": "获取近期验证购买评论",
-      "input": { "ASIN": "B0B24QJ217", "OnlyPurchase": 1, "QueryStartDt": "20250101", "domain": 1 },
+      "input": {
+        "ASIN": "B0B24QJ217",
+        "OnlyPurchase": 1,
+        "QueryStartDt": "20250101",
+        "domain": 1
+      },
       "description": "获取2025年以来的验证购买评论"
     }
   ],
   "reportMapping": {
-    "slides": ["VOC用户洞察(Slide5)", "AI深度洞察(Slide13)"],
-    "dataPoints": ["评论总量", "好评率", "差评率", "痛点标签及占比", "喜爱点标签及占比", "使用场景分布"]
+    "slides": [
+      "VOC用户洞察(Slide5)",
+      "AI深度洞察(Slide13)"
+    ],
+    "dataPoints": [
+      "评论总量",
+      "好评率",
+      "差评率",
+      "痛点标签及占比",
+      "喜爱点标签及占比",
+      "使用场景分布"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 68 - 15
voc/product-search/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["Pattern"],
+    "required": [
+      "Pattern"
+    ],
     "properties": {
       "Pattern": {
         "type": "string",
@@ -35,7 +37,9 @@
     "template": {
       "path": "/api/ProductQuery",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "Page": "{{Page}}",
         "Query": "1",
@@ -50,15 +54,42 @@
     "items": {
       "type": "object",
       "properties": {
-        "Asin": { "type": "string", "description": "产品 ASIN" },
-        "Title": { "type": "string", "description": "产品标题" },
-        "Price": { "type": "number", "description": "售价(美元)" },
-        "Rating": { "type": "number", "description": "平均评分" },
-        "RatingsCount": { "type": "integer", "description": "评论总数" },
-        "MonthlySales": { "type": "integer", "description": "月销量估算" },
-        "Brand": { "type": "string", "description": "品牌" },
-        "BSR": { "type": "integer", "description": "BSR 排名" },
-        "Photo": { "type": "array", "description": "图片列表" }
+        "Asin": {
+          "type": "string",
+          "description": "产品 ASIN"
+        },
+        "Title": {
+          "type": "string",
+          "description": "产品标题"
+        },
+        "Price": {
+          "type": "number",
+          "description": "售价(美元)"
+        },
+        "Rating": {
+          "type": "number",
+          "description": "平均评分"
+        },
+        "RatingsCount": {
+          "type": "integer",
+          "description": "评论总数"
+        },
+        "MonthlySales": {
+          "type": "integer",
+          "description": "月销量估算"
+        },
+        "Brand": {
+          "type": "string",
+          "description": "品牌"
+        },
+        "BSR": {
+          "type": "integer",
+          "description": "BSR 排名"
+        },
+        "Photo": {
+          "type": "array",
+          "description": "图片列表"
+        }
       }
     }
   },
@@ -66,17 +97,39 @@
   "usageExamples": [
     {
       "name": "搜索香薰扩散器产品",
-      "input": { "Pattern": "aroma diffuser", "Page": 1, "domain": 1 },
+      "input": {
+        "Pattern": "aroma diffuser",
+        "Page": 1,
+        "domain": 1
+      },
       "description": "在美国站搜索 aroma diffuser 关键词的产品列表"
     },
     {
       "name": "搜索蜡烛加热器",
-      "input": { "Pattern": "candle warmer", "Page": 1, "domain": 1 },
+      "input": {
+        "Pattern": "candle warmer",
+        "Page": 1,
+        "domain": 1
+      },
       "description": "在美国站搜索 candle warmer 关键词的产品列表"
     }
   ],
   "reportMapping": {
-    "slides": ["市场全景(Slide3)"],
-    "dataPoints": ["品类Top100产品列表", "周均销量", "周均销售额", "品牌数量", "中国卖家占比"]
+    "slides": [
+      "市场全景(Slide3)"
+    ],
+    "dataPoints": [
+      "品类Top100产品列表",
+      "周均销量",
+      "周均销售额",
+      "品牌数量",
+      "中国卖家占比"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }

+ 33 - 8
voc/similar-products/api-config.json

@@ -13,7 +13,9 @@
   },
   "parameters": {
     "type": "object",
-    "required": ["ASIN"],
+    "required": [
+      "ASIN"
+    ],
     "properties": {
       "ASIN": {
         "type": "string",
@@ -31,7 +33,9 @@
     "template": {
       "path": "/api/SimilarProductRealtimeRequest",
       "method": "POST",
-      "query": { "domain": "{{domain}}" },
+      "query": {
+        "domain": "{{domain}}"
+      },
       "body": {
         "ASIN": "{{ASIN}}"
       }
@@ -41,21 +45,42 @@
     "type": "object",
     "description": "相似产品查询结果(异步任务)",
     "properties": {
-      "TaskId": { "type": "string", "description": "异步任务 ID,需通过 similar_products_status 查询结果" },
-      "Status": { "type": "string", "description": "任务状态" }
+      "TaskId": {
+        "type": "string",
+        "description": "异步任务 ID,需通过 similar_products_status 查询结果"
+      },
+      "Status": {
+        "type": "string",
+        "description": "任务状态"
+      }
     }
   },
   "notes": "此接口为异步任务,返回 TaskId 后需通过 /api/SimilarProductRealtimeRequestStatusQuery 查询状态,状态完成后通过 /api/SimilarProductRealtimeRequestCollection 获取分页结果。",
-  "relatedSkills": ["product_detail_query"],
+  "relatedSkills": [
+    "product_detail_query"
+  ],
   "usageExamples": [
     {
       "name": "查找相似产品",
-      "input": { "ASIN": "B0B24QJ217", "domain": 1 },
+      "input": {
+        "ASIN": "B0B24QJ217",
+        "domain": 1
+      },
       "description": "查找与 COCORRINA Reed Diffuser 相似的产品"
     }
   ],
   "reportMapping": {
-    "slides": ["竞品对标(Slide4)"],
-    "dataPoints": ["相似竞品列表"]
+    "slides": [
+      "竞品对标(Slide4)"
+    ],
+    "dataPoints": [
+      "相似竞品列表"
+    ]
+  },
+  "timeout": 10000,
+  "retry": {
+    "maxAttempts": 3,
+    "delay": 1000,
+    "backoffMultiplier": 2
   }
 }