核心用法
Clawver Store Analytics 是一款面向数字商品卖家的专业数据分析工具，通过 RESTful API 提供全方位的店铺运营洞察。用户需配置 CLAW_API_KEY 环境变量后，即可调用 /v1/stores/me/analytics 端点获取核心指标，包括总营收、订单量、平均客单价、转化率等关键数据。支持 7d、30d（默认）、90d 和 all 四种时间周期筛选，并可通过 /v1/stores/me/products/{id}/analytics 获取单个产品的深度分析。API 返回 JSON 格式数据，所有金额字段均以 cents 为单位，需除以 100 转换为标准货币单位。
显著优点
1. 多维度指标体系：覆盖流量（storeViews、productViews）、转化（conversionRate）、收入（totalRevenue、netRevenue）、产品表现（topProducts）和用户反馈（averageRating、reviewsCount）四大维度
2. 灵活的周期对比：内置周报/月报计算模式，支持同期对比分析，便于识别增长趋势
3. 自动化洞察建议：文档内置 Actionable Insights 模块，针对低转化、高浏览低销售、收入下滑等场景提供优化建议
4. 成本透明化：明确披露 2% 平台费率，netRevenue 字段直接呈现实际到账金额
5. 低代码集成：提供 Bash curl 和 Python 双语言示例，降低接入门槛
潜在缺点与局限性
1. 数据颗粒度限制：API 最小周期为 7 天，不支持单日级或实时数据查询
2. 无原生可视化：纯 API 驱动，需开发者自行搭建报表界面，无内置 Dashboard
3. 平台锁定风险：数据仅覆盖 Clawver 平台交易，无法整合外部渠道（如 Gumroad、Patreon 等）
4. 退款计算黑盒：文档说明"退款金额已从收入中扣除"，但未提供退款明细 API，需通过订单端点手动聚合
5. 评价管理功能薄弱：仅能获取评价列表和评分分布，不支持回复评价或批量操作
适合人群
- 独立数字创作者：销售模板、设计素材、AI 艺术包等虚拟商品的个体卖家
- 小型工作室：需轻量级数据追踪、无力负担 Shopify Analytics 等重型工具的团队
- 技术型运营者：具备基础 API 调用能力，希望将数据导入自建 BI 系统的开发者
常规风险
- API 密钥泄露风险：
CLAW_API_KEY具备店铺数据完全访问权限，硬编码或日志泄露将导致商业数据暴露 - 数据一致性风险：退款计算逻辑依赖后端聚合，与订单端点手动计算可能存在分毫级差异
- 平台依赖风险：Clawver 为相对小众的数字商品平台，长期服务稳定性需持续观察
- 货币处理风险：所有金额以 cents 存储，转换时浮点精度错误可能导致财务数据偏差