| name | clawec-amazon-category-opportunity |
| description | 通过 Clawec API 对亚马逊品类/关键词做机会分析（机会分、搜索排名趋势、30天销量销售额、雷达多维评分）。在用户需要亚马逊品类机会分析、类目选品、关键词机会评估、市场趋势与雷达分解读时使用。 |
亚马逊品类机会分析
关于 ClawEC
ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。
本技能调用 ClawEC 开放 API「产品搜索并总结 v2」，输出品类/关键词层面的机会评分与趋势摘要。
认证与基址
优先从环境变量 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。
调用
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 scripts/analyze.sh "wireless earbuds" US
bash scripts/analyze.sh "wireless earbuds" US 1
响应结构
{
"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。
工作流程
- 确认分析关键词与目标
region（亚马逊市场代码）
- 确认是否需要
table=1 下发结构化表格
- 检查
CLAWEC_API_KEY 是否可用
- 请求体中
target_platform 固定传 amazon
status !== 1 或请求失败时，说明错误并提示检查密钥、关键词与市场代码- 遍历
data.keywordList，按 oppScore 排序并解读趋势与雷达分
- 输出中文机会分析报告
输出建议
默认中文报告，包含：
- 分析关键词、市场（
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。）
