Shopee类目趋势概览
关于 clawEC
clawEC Work 是 AI 驱动的跨境电商工作台:说出要求、开始执行任务、交付完整成果。无缝连接 Amazon、TikTok、Shopee、Ozon 等主流平台,自主规划并调用工具生成选品报告与素材,你的跨境好搭子。
本技能调用 clawEC 开放 API,用于查询Shopee类目趋势概览。
认证与基址
- Base URL:
https://www.clawec.com/api - API Key: 在 https://www.clawec.com/?source=q-github-agent 注册帐号 然后去https://www.clawec.com/api-key?source=q-github-agent 获取key
- 请求头:
Content-Type: application/jsonAuthorization: Bearer <API_KEY>
优先从环境变量 CLAWEC_API_KEY 读取密钥;未设置时向用户索取,勿硬编码。
接口
POST /aigc/ec/shopee/data/category/trend
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| sites | body | 是 | 站点列表(支持多选):tw=台湾, my=马来西亚, id=印度尼西亚, th=泰国, ph=菲律宾, sg=新加坡, vn=越南, br=巴西 |
| catId | body | 是 | 类目ID。一级类目对照:100001=保健, 100009=时尚配饰, 100010=家用电器, 100011=男装服饰, 100012=男士鞋, 100013=手机平板与配件, 100015=旅行&行李箱, 100016=女士包, … |
| granularity | body | 是 | 数据统计颗粒度:1=自然月 2=自然季度 3=年 |
| startDate | body | 是 | 查看数据范围开始时间,yyyy-MM-dd |
| endDate | body | 是 | 查看数据范围结束时间,yyyy-MM-dd |
| productType | body | 否 | 产品类型:0=全部 1=虾皮优选 2=虾皮商城 3=其他(默认0) |
| location | body | 否 | 商品所在地:0=全部 1=本地 2=跨境(默认0) |
site / sites 取值
| 代码 | 站点 |
|---|---|
| tw | 台湾 |
| my | 马来西亚 |
| id | 印度尼西亚 |
| th | 泰国 |
| ph | 菲律宾 |
| sg | 新加坡 |
| vn | 越南 |
| br | 巴西 |
sites 为多选站点列表时,传 JSON 数组字符串,例如 ["tw","my"]。
调用
bashcurl -s -X POST "https://www.clawec.com/api/aigc/ec/shopee/data/category/trend" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLAWEC_API_KEY" \ -d '{"sites": "[\"tw\"]", "catId": "123456", "granularity": "1", "startDate": "2025-05-27", "endDate": "2026-05-27"}'
筛选参数较多时,推荐直接传 JSON body(或 @payload.json)。
或使用脚本:
bashbash scripts/query.sh '{"sites": "[\"tw\"]", "catId": "123456", "granularity": "1", "startDate": "2025-05-27", "endDate": "2026-05-27"}' bash scripts/query.sh @payload.json
响应结构
json{ "status": 1, "data": { ... } }
status:1= 成功,0= 失败- 成功时解析
data按用户需求整理为中文摘要即可(无需卡片组件)
工作流程
- 确认 sites、catId、granularity、startDate、endDate;参数较多时用 JSON 传入
- 检查
CLAWEC_API_KEY是否可用 - 执行 API 请求
- 失败时说明错误并提示检查密钥与关键参数
- 解析返回数据,整理为中文摘要
输出建议
- 查询条件与关键参数
- Shopee类目趋势概览核心指标摘要(以返回字段为准)
- 给出 1–2 条可行动观察


