Skill: anyunzhong/clawec-amazon-category-opportunity (version 1.0.1)

--- name: amazon-category-opportunity description: 通过 Clawec API 对亚马逊品类/关键词做机会分析（机会分、搜索排名趋势、30天销量销售额、雷达多维评分）。在用户需要亚马逊品类机会分析、类目选品、关键词机会评估、市场趋势与雷达分解读时使用。 --- # 亚马逊品类机会分析 ## 关于 ClawEC ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。 本技能调用 ClawEC 开放 API「产品搜索并总结 v2」，输出品类/关键词层面的机会评分与趋势摘要。 ## 认证与基址 - **Base URL**: `https://www.clawec.com/api` - **API Key**: 在 https://www.clawec.com/?source=q-clawhub 注册帐号 然后去https://www.clawec.com/api-key?source=q-clawhub 获取key - **请求头**: - `Content-Type: application/json` - `Authorization: Bearer <API_KEY>` 优先从环境变量 `CLAWEC_API_KEY` 读取密钥；未设置时向用户索取，勿硬编码。 ## 接口 `POST /aigc/ec/product_search_v2` | 参数 | 位置 | 必填 | 说明 | |------|------|------|------| | keyword | body | 是 | 品类/关键词（可多个相关词由 API 展开为 `keywordList`） | | target_platform | body | 是 | **固定传 `amazon`** | | region | body | 是 | 目标市场（亚马逊站点代码，见下表） | | table | body | 否 | 是否下发表格数据：`0` 否，`1` 是；默认 `0` | ### region 取值（Amazon） | 代码 | 市场 | |------|------| | US | 美国 | | UK | 英国 | | ES | 西班牙 | | FR | 法国 | | DE | 德国 | | IT | 意大利 | | CA | 加拿大 | | JP | 日本 | 未指定 `region` 时默认 `US`。 ## 调用 ```bash curl -s -X POST "https://www.clawec.com/api/aigc/ec/product_search_v2" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLAWEC_API_KEY" \ -d '{"keyword":"wireless earbuds","target_platform":"amazon","region":"US","table":0}' ``` 或使用脚本（脚本内已固定 `target_platform=amazon`）： ```bash # 关键词 + 市场（默认 US） bash scripts/analyze.sh "wireless earbuds" US # 需要表格数据时 bash scripts/analyze.sh "wireless earbuds" US 1 ``` ## 响应结构 ```json { "status": 1, "data": { "keywordList": [ ... ] }, "pointInfo": { "type": 0, "point": 0 } } ``` - `status`: `1` = 成功，`0` = 失败 - `data.keywordList`: 关键词机会分析列表 - `pointInfo`: 积分/扣点信息 `{ type, point }` ### keywordList 核心字段 | 字段 | 说明 | |------|------| | keyword / keywordCn | 原始关键词 / 中文名 | | oppScore / oppScoreDesc | 市场机会综合分及解读（越高机会越大） | | searchRank / searchRankDesc | 最新月核心指标（Amazon 为搜索排名）及说明 | | rankTrends | 近 12 个月趋势 `{ x: 月份, y: 数值 }` | | soldCnt30d / soldCnt30dGrowthRate | 近 30 天销量及环比 | | soldAmt30d / soldAmt30dGrowthRate | 近 30 天销售额及环比 | | radar | 雷达多维分（市场需求、评价、新品、销售、供给等） | 完整字段见 [references/response-schema.md](references/response-schema.md)。 ## 工作流程 1. 确认分析关键词与目标 `region`（亚马逊市场代码） 2. 确认是否需要 `table=1` 下发结构化表格 3. 检查 `CLAWEC_API_KEY` 是否可用 4. 请求体中 **`target_platform` 固定传 `amazon`** 5. `status !== 1` 或请求失败时，说明错误并提示检查密钥、关键词与市场代码 6. 遍历 `data.keywordList`，按 `oppScore` 排序并解读趋势与雷达分 7. 输出中文机会分析报告 ## 输出建议 默认中文报告，包含： - 分析关键词、市场（`region`）、返回关键词数量 - **机会榜**：`keywordCn`、机会分、搜索排名、30 天销量/销售额及环比 - **趋势**：对头部词的 `rankTrends` 用 1–2 句话概括升降（结合 `rankTrendsDesc`） - **雷达**：列出 `radar.propertyList` 各维度得分，指出强项与短板 - **结论**：推荐优先关注的 1–3 个词及理由；若机会分接近，说明需结合供给/新品分综合判断 ## 示例 **输入**：美国站分析品类关键词「phone case」 **输出摘要**： | 关键词 | 机会分 | 搜索排名 | 30天销量 | 销量环比 | 销售额环比 | |--------|--------|----------|----------|----------|------------| | phone case | 85 | ... | ... | UP 1.2% | DOWN -0.5% | | ... | ... | ... | ... | ... | ... | **雷达（示例）**：市场需求 78、市场销售 82、市场供给 65 … （详细解读见各词的 `oppScoreDesc` 与 `radar.radarDescription`。）


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)