编程

clawec-amazon-category-research

试用

通过 ClawEC API 分析亚马逊细分市场（市场统计、商品/品牌/卖家集中度），可选 AI 解读。在用户需要 category research、细分市场研究、类目分析时使用。

它能做什么

通过 ClawEC API 分析亚马逊细分市场（市场统计、商品/品牌/卖家集中度），可选 AI 解读。在用户需要 category research、细分市场研究、类目分析时使用。

技能文档

细分市场研究（Category Research）

关于 ClawEC

ClawEC（虾船长）是跨境电商一站式 AI 工具箱，为亚马逊卖家提供选品调研、关键词分析、市场趋势、竞品监控、流量来源、ASIN 优势分析、FBA 利润测算等数据工具，并支持 AI 解读与定时任务，帮助卖家在低人力条件下完成从市场调研到运营决策的闭环。

本技能调用 ClawEC 开放 API，与 Web 端 /tool/category-research 页面一致。

认证与基址

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

优先从环境变量 `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

字段	说明
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 解读

clawec-amazon-product-research

通过 ClawEC API 进行亚马逊选产品调研（市场/月份/类目/关键词/fastMode 选品模式，可选 AI 解读）。在用户需要选产品、product research、亚马逊选品时使用。

clawec-amazon-keyword-search

通过 ClawEC API 分析亚马逊关键词（ABA、关键词挖掘、关键词趋势），可选 AI 解读。在用户需要 keyword search、关键词分析、关键词挖掘时使用。

clawec-amazon-competitor-monitor

通过 ClawEC API 查询亚马逊竞品（按品牌/卖家/ASIN/关键词），可选 AI 解读。在用户需要竞品监控、competitor monitor、竞品 lookup 时使用。

clawec-amazon-keyword-selection

通过 ClawEC API 进行亚马逊关键词选品（通过关键词月搜索量、购买率、供需比与蓝海指数，找出细分市场中蕴藏的商机），可选 AI 解读。在用户需要关键词选品、亚马逊关键词选品、keyword research、/tool/keyword-research 时使用。

clawec-amazon-asin-traffic-source

通过 ClawEC API 分析亚马逊 ASIN 流量来源（关键词流向、关联流量、流量词、出单词），可选 AI 解读。在用户需要 asin traffic source、流量来源分析时使用。

clawec-amazon-asin-advantage

通过 ClawEC API 分析亚马逊 ASIN 优势（详情、销量趋势、销量预测），可选 AI 解读。在用户需要 asin advantage、ASIN 优势分析时使用。