编程

clawec-amazon-asin-traffic-source

试用

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

它能做什么

技能文档

ASIN 流量来源（Traffic Source）

关于 ClawEC

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

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

认证与基址

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  POST /aigc/ec/amazon/traffic_source/search              → 提交搜索
Step 2  GET  /aigc/ec/amazon/traffic_source/search/logs          → 定位记录
Step 3  GET  /aigc/ec/amazon/traffic_source/search/log/detail   → 获取结果
Step 4  （aiInterpret=true 时）轮询 log/detail

Web 端通过 WebSocket traffic_source_result_refresh 推送刷新；脚本场景用 轮询 log/detail 即可。

Step 1：提交搜索

POST /aigc/ec/amazon/traffic_source/search

参数	必填	说明
marketplace	是	市场代码
asin	是	ASIN
month	是	数据月份 yyyyMM
trafficSource	否	流量来源，Web 默认 true
trafficListingStat	否	关联流量统计
trafficKeyword	否	关键词反查
keywordOrder	否	出单词反查
aiInterpret	否	AI 解读

至少开启一项查询维度。

marketplace

代码	市场
US	美国
UK	英国
ES	西班牙
FR	法国
DE	德国
IT	意大利
CA	加拿大
JP	日本

curl -s -X POST "https://www.clawec.com/api/aigc/ec/amazon/traffic_source/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"marketplace":"US","asin":"B0XXXXXX","month":"202505","trafficSource":true,"trafficKeyword":true,"aiInterpret":true}'

bash scripts/search.sh US --asin B0XXXXXX --month 202505 --traffic-source --traffic-keyword --ai

Step 2–3：历史与详情

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: 积分消耗信息

工作流程与输出建议

ASIN、month 必填；至少一项流量维度
输出：流量渠道分布、流量词表、出单词、AI 解读

clawec-amazon-asin-advantage

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

clawec-amazon-keyword-search

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

clawec-amazon-category-research

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

clawec-amazon-competitor-monitor

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

clawec-amazon-product-research

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

clawec-amazon-keyword-selection

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