{ "name": "category-landscape", "displayName": "品类格局分析", "description": "品类全景分析，计算CR5/HHI市场集中度，生成风险预警汇总和优先行动清单，输出《品类认知校准表》", "category": "synthesis", "version": "1.3.0", "type": "orchestration", "parameters": { "keywords": { "type": "array", "items": { "type": "string" }, "required": true, "description": "品类核心关键词列表" }, "domain": { "type": "integer", "required": false, "default": 1, "description": "Amazon站点（1=美国）" }, "topN": { "type": "integer", "required": false, "default": 100, "description": "分析的产品数量" } }, "pipeline": [ { "step": 1, "name": "搜索品类Top N产品", "forEach": "keywords", "api": { "service": "SorftimeApiService.searchProductsByQuery", "endpoint": "/api/ProductQuery", "method": "POST", "forwardUrl": "https://server.fmode.cn/api/voc-ecom/forward", "headers": { "Authorization": "Bearer {{vocToken}}" }, "requestBody": { "Page": 1, "Query": "1", "QueryType": "7", "Pattern": "${keyword}" }, "queryParams": { "domain": "${domain}" } }, "output": "searchResults", "responseExtract": "Array<{ Asin, Title, Price, Rating, RatingsCount, MonthlySales, Brand, BSR, Photo }>" }, { "step": 2, "name": "批量获取销量数据", "forEach": "searchResults[].Asin (去重)", "api": { "service": "SorftimeApiService.getAsinSalesVolume", "endpoint": "/api/AsinSalesVolume", "method": "POST", "requestBody": { "ASIN": "${asin}" }, "queryParams": { "domain": "${domain}" } }, "output": "salesData" }, { "step": 3, "name": "定位品类类目", "api": { "service": "SorftimeApiService.getCategoryTree", "endpoint": "/api/CategoryTree", "method": "POST", "requestBody": { "keyword": "${keywords[0]}" }, "queryParams": { "domain": "${domain}" } }, "output": "categoryTree" }, { "step": 4, "name": "获取核心关键词搜索量和竞争度", "forEach": "keywords", "api": { "service": "SorftimeApiService.searchKeywords", "endpoint": "/api/KeywordQuery", "method": "POST", "requestBody": { "Keyword": "${keyword}" }, "queryParams": { "domain": "${domain}" } }, "output": "keywordData" }, { "step": 5, "name": "获取关键词趋势", "forEach": "keywords", "api": { "service": "SorftimeApiService.getKeywordTrend", "endpoint": "/api/KeywordSearchTrend", "method": "POST", "requestBody": { "Keyword": "${keyword}" }, "queryParams": { "domain": "${domain}" } }, "output": "keywordTrend" }, { "step": 6, "name": "市场集中度+价格带+增长判断计算", "type": "compute", "logic": "analyzeMarket(searchResults, salesData, keywordData, keywordTrend)", "algorithm": { "cr5": "前5品牌销售额占品类总销售额的比例", "cr10": "前10品牌销售额占比", "hhi": "赫芬达尔-赫希曼指数（各品牌市场份额平方和 × 10000）", "marketSize": "品类月销量总和、月销售额总和", "priceBands": "按价格区间统计产品数量和销量占比", "brandConcentration": "Top 10 品牌的市场份额", "ratingDistribution": "品类整体评分水平", "growthStage": "基于搜索趋势判断品类处于增长/成熟/衰退期" }, "output": "marketAnalysis" }, { "step": 7, "name": "风险预警汇总", "type": "compute", "logic": "generateRiskAlerts(marketAnalysis)", "algorithm": { "brandConcentrationRisk": "品牌集中度风险", "lowSalesRisk": "低销量风险", "ratingRisk": "评分风险", "priceWarRisk": "价格战风险", "inventoryRisk": "库存风险", "complianceRisk": "合规风险", "levelLabels": "每项风险标注级别(high/medium/low)和具体描述" }, "output": "riskAlerts" }, { "step": 8, "name": "优先行动清单", "type": "compute", "logic": "generatePriorityActions(marketAnalysis, riskAlerts)", "algorithm": { "triggers": "条件触发式优先级: Listing优化→SKU聚焦→促销→产品迭代→库存→差异化" }, "output": "priorityActions" } ], "response": { "type": "object", "properties": { "marketOverview": { "type": "object", "properties": { "totalProducts": { "type": "integer" }, "totalMonthlySales": { "type": "integer" }, "totalMonthlyRevenue": { "type": "number" }, "avgPrice": { "type": "number" }, "medianPrice": { "type": "number" }, "avgRating": { "type": "number" }, "categoryStage": { "type": "string" } } }, "concentration": { "type": "object", "properties": { "cr5": { "type": "number" }, "cr10": { "type": "number" }, "hhi": { "type": "integer" }, "interpretation": { "type": "string" } } }, "topBrands": { "type": "array", "items": { "type": "object", "properties": { "brand": { "type": "string" }, "marketShare": { "type": "number" }, "productCount": { "type": "integer" }, "avgPrice": { "type": "number" }, "avgRating": { "type": "number" } } } }, "priceBands": { "type": "array", "items": { "type": "object", "properties": { "range": { "type": "string" }, "productCount": { "type": "integer" }, "salesShare": { "type": "number" }, "avgRating": { "type": "number" } } } }, "searchTrend": { "type": "object", "properties": { "mainKeyword": { "type": "string" }, "monthlySearchVolume": { "type": "integer" }, "trendDirection": { "type": "string" }, "growthRate": { "type": "number" } } }, "calibrationTable": { "type": "string", "description": "品类认知校准表(Markdown格式)" }, "riskAlerts": { "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string", "enum": [ "high", "medium", "low" ] }, "title": { "type": "string" }, "description": { "type": "string" } } } }, "priorityActions": { "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "priority": { "type": "integer" }, "trigger": { "type": "string" } } } } } }, "timeout": 300000, "retry": { "maxAttempts": 2, "delay": 2000, "backoffMultiplier": 2 }, "tokenConfig": { "type": "bearer", "configFile": "~/.openclaw/voc-credentials.json", "tokenField": "vocToken", "resolutionOrder": [ "configFile" ], "apigId": "7HwdQZk55B", "paymentUrlResolution": { "description": "动态构建充值URL：在已存在 session token 时查出用户 objectId，拼接到专属充值页面", "steps": [ "1. 从 voc-credentials.json 获取当前 session token", "2. 调用 GET https://server.fmode.cn/parse/users/me （Header: X-Parse-Application-Id: ncloudmaster, X-Parse-Session-Token: {token}）获取用户 objectId", "3. 拼接充值URL: https://app.fmode.cn/dev/apig-pay/?user={objectId}&apigid=7HwdQZk55B&fun_id=HOkkX72PMF", "4. 将该URL展示给用户，引导扫码支付" ], "userResolveEndpoint": "https://server.fmode.cn/parse/users/me", "userResolveHeaders": { "X-Parse-Application-Id": "ncloudmaster", "X-Parse-Session-Token": "{vocToken}" }, "paymentBaseUrl": "https://app.fmode.cn/dev/apig-pay/", "paymentParams": { "user": "{resolvedUserId}", "apigid": "7HwdQZk55B", "fun_id": "HOkkX72PMF" }, "balanceCheckEndpoint": "https://server.fmode.cn/api/apig/getApig" }, "onMissing": { "action": "showPaymentQR", "qrCodeUrl": "https://app.fmode.cn/dev/apig-pay/?apigid=7HwdQZk55B&fun_id=HOkkX72PMF", "title": "扫码开通 VOC-AI 数据服务", "message": "此 Skill 需要有效的 API Token。请先打开充值页面完成登录和充值；当用户提供 session token 后，请由 OpenClaw 运行 node scripts/tools/set-voc-token.js 写入 ~/.openclaw/voc-credentials.json 的 vocToken 字段，再重试当前 Skill。", "tokenSetupCommandTemplate": "node scripts/tools/set-voc-token.js {sessionToken}", "tokenSetupInstructions": "当用户完成登录和充值后，如果用户把 session token 发给你，请直接运行 node scripts/tools/set-voc-token.js 写入 ~/.openclaw/voc-credentials.json，然后重试当前 Skill。" }, "onBalanceInsufficient": { "action": "resolveUserThenShowPayment", "title": "VOC-AI Token 余额不足，请扫码充值", "message": "当前 Token 余额不足，我将为你生成专属充值链接，扫码支付后即可继续使用。" } }, "errorHandling": { "balanceInsufficient": { "conditions": [ { "responseField": "code", "operator": "in", "value": [ -2, -3, -10, 402, 429 ] }, { "responseField": "msg", "operator": "contains", "value": [ "余额不足", "insufficient", "balance", "quota", "没有开通", "权限或余额" ] }, { "responseField": "mess", "operator": "contains", "value": [ "余额不足", "insufficient", "balance", "quota", "没有开通", "权限或余额" ] }, { "responseField": "message", "operator": "contains", "value": [ "余额不足", "insufficient", "balance", "没有开通", "权限或余额" ] } ], "matchMode": "any", "trigger": "tokenConfig.onBalanceInsufficient" }, "unauthorized": { "conditions": [ { "responseField": "code", "operator": "in", "value": [ 401, 403 ] }, { "responseField": "msg", "operator": "contains", "value": [ "unauthorized", "token", "invalid", "auth" ] } ], "matchMode": "any", "trigger": "tokenConfig.onMissing" } } }