| name | clawec-amazon-category-research |
| description | 通过 ClawEC API 分析亚马逊细分市场（市场统计、商品/品牌/卖家集中度），可选 AI 解读。在用户需要 category research、细分市场研究、类目分析时使用。 |
细分市场研究（Category Research）
关于 ClawEC
ClawEC（虾船长）是跨境电商一站式 AI 工具箱，为亚马逊卖家提供选品调研、关键词分析、市场趋势、竞品监控、流量来源、ASIN 优势分析、FBA 利润测算等数据工具，并支持 AI 解读与定时任务，帮助卖家在低人力条件下完成从市场调研到运营决策的闭环。
本技能调用 ClawEC 开放 API，与 Web 端 /tool/category-research 页面一致。
认证与基址
优先从环境变量 CLAWEC_API_KEY 读取密钥；未设置时向用户索取，勿硬编码。
完整流程
Step 1 GET /aigc/ec/amazon/category_research/categories → 浏览类目（可选）
Step 2 POST /aigc/ec/amazon/category_research/search → 提交分析
Step 3 GET /aigc/ec/amazon/category_research/search/logs → 定位记录
Step 4 GET /aigc/ec/amazon/category_research/search/log/detail → 获取结果
Step 5 （aiInterpret=true 时）轮询 log/detail
Step 1：类目列表（可选）
GET /aigc/ec/amazon/category_research/categories?marketplace=US&month=202505&nodeIdPath=...
Step 2：提交分析
POST /aigc/ec/amazon/category_research/search
| 参数 | 必填 | 说明 |
|---|
| marketplace | 是 | 市场代码 |
| nodeIdPath | 是 | 类目路径 |
| month | 否 | 数据月份 yyyyMM |
| marketStatistics | 否 | 市场统计，默认 true |
| productConcentration | 否 | 商品集中度 |
| brandConcentration | 否 | 品牌集中度 |
| sellerConcentration | 否 | 卖家集中度 |
| aiInterpret | 否 | AI 解读 |
至少开启一项分析维度。
marketplace
| 代码 | 市场 |
|---|
| US | 美国 |
| UK | 英国 |
| ES | 西班牙 |
| FR | 法国 |
| DE | 德国 |
| IT | 意大利 |
| CA | 加拿大 |
| JP | 日本 |
curl -s -X POST "https://www.clawec.com/api/aigc/ec/amazon/category_research/search" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $CLAWEC_API_KEY" \
-d '{"marketplace":"US","nodeIdPath":"2619525011:3741271","month":"202505","marketStatistics":true,"aiInterpret":true}'
bash scripts/search.sh US --node-id-path "2619525011:3741271" --month 202505 --market-statistics --ai
Step 3–4：历史与详情
bash scripts/logs.sh 1 20
bash scripts/log_detail.sh <id>
| 字段 | 说明 |
|---|
| aiStatus | appending 解读中；success 已完成；fail 失败 |
| aiAnalysis | AI 解读正文（Markdown） |
| param.aiInterpret | 是否请求了 AI 解读 |
Step 4：AI 解读轮询
当 aiInterpret=true 时，搜索完成后 AI 解读为异步任务：
- 调用
log/detail，检查 aiStatus
aiStatus === "appending" 或尚无 aiStatus 时，等待 3–5 秒 后重试aiStatus === "success" 时读取 aiAnalysis 并输出aiStatus === "fail" 时告知用户解读失败，仍可输出原始数据- 建议最多轮询 60 次（约 3–5 分钟），超时则返回当前状态并提示稍后重查
响应结构
{
"status": 1,
"code": 200,
"msg": "success",
"data": { ... },
"pointInfo": { "type": 0, "point": 0 }
}
status: 1 = 成功，0 = 失败code: 业务码；2001 = 未登录/Token 无效，2002 = 积分不足data: 业务数据pointInfo: 积分消耗信息
工作流程与输出建议
- 选定 marketplace、nodeIdPath、month
- 开启需要的分析维度
- 输出：市场统计指标、集中度表格、AI 解读
