Clawver店铺分析

技能简介

Clawver Store Analytics 是面向 Clawver 平台商家的数据分析工具，通过 REST API 获取店铺运营指标，包括营收、订单量、商品表现及客户评价等核心数据。

业务背景

Clawver店铺分析帮助商家实时掌握经营健康度，无需手动汇总多平台数据。通过统一视图追踪营收、订单转化及商品表现，快速识别增长机会与运营短板，为库存调配、营销投入和定价策略提供数据依据，降低决策盲区带来的经营风险。

落地案例：某服饰店主每日早晨调用API获取前一日数据：总营收扣除2%平台费后的净收入自动计算，热销T恤的浏览转化率从3%提升至5%触发补货提醒。每周对比30天趋势发现客单价下降，及时调整满减活动门槛。月末导出90天数据复盘季节性波动，优化下季度上新计划。

能做什么

• 查询店铺总营收、净收入及平台手续费明细
• 统计订单数量、客单价与浏览转化率
• 查看热销商品排行及各单品转化数据
• 按 7天/30天/90天/全部时间 筛选历史趋势
• 获取客户评分分布与具体评价内容

使用说明

1. 环境准备
   设置环境变量：export CLAW_API_KEY="your_api_key_here"
   需完成 Stripe 验证且店铺至少上架一款商品
2. 获取店铺概览

   curl https://api.clawver.store/v1/stores/me/analytics \
     -H "Authorization: Bearer $CLAW_API_KEY"

3. 指定时间范围

   curl "https://api.clawver.store/v1/stores/me/analytics?period=30d" \
     -H "Authorization: Bearer $CLAW_API_KEY"

   可选值：7d、30d（默认）、90d、all

4. 查询单品数据

   curl "https://api.clawver.store/v1/stores/me/products/{productId}/analytics?period=30d" \
     -H "Authorization: Bearer $CLAW_API_KEY"

5. 读取客户评价

   curl https://api.clawver.store/v1/stores/me/reviews \
     -H "Authorization: Bearer $CLAW_API_KEY"

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥泄露可能导致店铺数据被非法访问
• 退款金额已从营收中扣除，需单独核对订单明细
• 转化率计算上限为 100%，异常流量可能扭曲指标
• 未完成 Stripe 验证的店铺无法调用公开列表接口

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nwang783/clawver-store-analytics/SKILL.md
来源类型：GitHub 仓库