clawec-shopee-shop-trend

name	clawec-shopee-shop-trend
description	通过 Clawec API 查询 Shopee 店铺趋势（月/季/年颗粒度，销量销售额、动销率、粉丝等时间序列；可按类目过滤）。在用户需要虾皮店铺趋势、竞店走势、店铺经营变化分析时使用。

Shopee 店铺趋势

关于 ClawEC

ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。

本技能调用 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/json
  • Authorization: Bearer <API_KEY>

优先从环境变量 CLAWEC_API_KEY 读取密钥；未设置时向用户索取，勿硬编码。

接口

POST /aigc/ec/shopee/data/shop/trend

参数	位置	必填	说明
site	body	是	站点：tw my id th ph sg vn br
shopId	body	是	店铺 ID
granularity	body	是	统计颗粒度：1=自然月 2=自然季度 3=年
startDate	body	是	数据范围开始，yyyy-MM-dd
endDate	body	是	数据范围结束，yyyy-MM-dd
catId	body	否	类目 ID；不传则查店铺整体趋势（一级类目见下表）
pageNo	body	否	分页页码，从 1 开始；默认 1
pageSize	body	否	分页大小，最大 10；默认 10

site 站点对照

代码	站点
tw	台湾
my	马来西亚
id	印度尼西亚
th	泰国
ph	菲律宾
sg	新加坡
vn	越南
br	巴西

catId 一级类目对照（可选）

ID	类目
100001	保健
100009	时尚配饰
100010	家用电器
100011	男装服饰
100012	男士鞋
100013	手机平板与配件
100015	旅行&行李箱
100016	女士包
100017	女装服饰
100531	美食外送
100532	女鞋
100533	男士包
100534	手表
100535	音响设备
100629	美食、伴手礼
100630	美妆保养
100631	宠物
100632	母婴用品
100633	婴幼童时装
100634	游戏 & 电玩
100635	相机 & 无人机
100636	居家生活
100637	运动与户外活动
100638	文具
100639	珍藏品
100640	汽车类
100641	摩托车类
100642	票务、优惠券与服务
100643	书籍 & 杂志
100644	电脑 & 配件
102053	附近优惠
102187	车辆备件和配件

调用

店铺整体趋势：

curl -s -X POST "https://www.clawec.com/api/aigc/ec/shopee/data/shop/trend" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"site":"tw","shopId":12345678,"granularity":1,"startDate":"2025-05-27","endDate":"2026-05-27"}'

按类目过滤：

curl -s -X POST "https://www.clawec.com/api/aigc/ec/shopee/data/shop/trend" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"site":"tw","shopId":12345678,"catId":100630,"granularity":1,"startDate":"2025-05-27","endDate":"2026-05-27","pageNo":1,"pageSize":10}'

或使用脚本：

# 站点 + 店铺 ID + 颗粒度(1月/2季/3年) + 开始日 + 结束日（均必填）
bash scripts/query.sh tw 12345678 1 2025-05-27 2026-05-27

# 指定类目 + 分页
bash scripts/query.sh tw 12345678 1 2025-05-27 2026-05-27 100630 1 10

脚本参数顺序：site shopId granularity startDate endDate [catId] [pageNo] [pageSize]

响应结构

{
  "status": 1,
  "data": {
    "success": true,
    "errorCode": "",
    "errorMessage": "",
    "data": [ ... ],
    "total": 12,
    "pageNo": 1,
    "pageSize": 10
  }
}

• 顶层 status: 1 = 成功，0 = 失败
• data.success / errorCode / errorMessage: 业务层成功与错误信息
• data.data: 当前页趋势时间序列
• data.total / pageNo / pageSize: 分页元数据

趋势核心字段（data.data[]）

字段	说明
date / site / shopId / shopName	账期、站点、店铺
productTypeName / shopTypeName / shopAddress	产品类型、店铺类型、地址
itemCount / activeItemCount / activeRate	产品数、有销量产品数、动销率（%）
sales / gmv	销量、销售额
mainCatName / ratingStar	主营类目、评分
followerCount / followingCount / ctime	粉丝、关注中、开店时间

账期格式随颗粒度变化：月 yyyy-MM、季度 yyyy-Nq、年 yyyy。

完整字段见 references/response-schema.md。

工作流程

1. 确认站点、店铺 ID、颗粒度、起止日期；按需指定类目过滤
2. 检查 CLAWEC_API_KEY 是否可用
3. 执行 API 请求（pageSize 不超过 10）
4. 顶层 status !== 1，或 data.success === false，或请求失败时，说明错误并提示检查密钥与参数
5. 按 date 排序解读升降；结合 total 判断是否需翻页
6. 输出中文店铺趋势报告

输出建议

默认中文报告，包含：

• 查询条件：站点、店铺、类目（若有）、颗粒度、时间范围、分页
• 趋势表：账期、销量、GMV、产品数、动销率、粉丝、评分
• 走势解读：销量/GMV 升降、动销与供给是否同步、粉丝增长
• 结论：店铺是否扩张/收缩，给出 2–3 条竞店观察

示例

输入：台湾站店铺 12345678，自然月，2025-05-27 ~ 2026-05-27

输出摘要：

账期	销量	GMV	产品数	动销率	粉丝	评分
2025-06	…	…	…	…	…	…
2025-07	…	…	…	…	…	…

观察：（结合销量与动销变化给出趋势结论）