核心用法
WooCommerce Skill 通过 Maton 代理服务提供对 WooCommerce REST API 的完整访问，采用 OAuth 托管认证模式。用户仅需配置 MATON_API_KEY 环境变量，无需处理复杂的 WordPress Consumer Key/Secret 签名流程。
基础调用模式：
https://api.maton.ai/woocommerce/{原生API路径}核心能力矩阵：
- 商品管理：CRUD 操作、变体、属性、分类、标签、评论
- 订单处理：状态流转、备注、退款、批量更新
- 客户运营：用户信息、下载权限、角色筛选
- 促销工具：优惠券创建（百分比/固定金额/免运费）、使用限制
- 店铺配置：税收规则、配送区域、支付方式、全局设置
- 数据洞察：销售报表、热销排行、各维度统计
- 系统维护：状态诊断、修复工具（需谨慎使用）
多店铺支持：通过 Maton-Connection 头部指定连接 ID，单 API Key 可管理多个 WooCommerce 站点。
显著优点
1. 认证简化：OAuth 托管消除密钥泄露风险，Maton 自动处理令牌生命周期
2. 完整覆盖：对接官方 WC REST API v3，功能 parity 达 100%
3. 批量操作：内置 /batch 端点，支持商品/订单的批量创建、更新、删除
4. 实时数据：支持 webhooks 配置，实现订单/库存的实时同步
5. 分页友好：标准 REST 分页（X-WP-Total/X-WP-TotalPages 头部）
潜在局限
1. 网络依赖：所有调用需经 Maton 代理，无法离线使用
2. 速率限制：未明确披露配额，高频场景需自行实现退避
3. PII 敏感：订单/客户数据含姓名、地址、邮箱等隐私信息，需额外合规处理
4. 写操作门槛：所有创建/更新/删除需用户显式确认，自动化程度受限
5. 支付网关风险：修改支付配置影响全站交易，误操作可能导致营收损失
适合人群
- 电商运营者：需要自动化商品上下架、库存同步、订单处理
- 开发者：构建 WooCommerce 周边工具、集成第三方 ERP/CRM
- 多店铺卖家：统一管理多个站点的商品与订单数据
- 数据分析师：提取销售报表、客户行为数据
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **数据泄露** | 订单/客户 PII 在日志/输出中暴露 | 过滤敏感字段，最小必要原则 |
| **误操作** | 批量删除商品、错误更新订单状态 | 写操作前二次确认，先查后改 |
| **财务影响** | 错误配置优惠券规则、支付网关 | 测试环境验证，限制金额阈值 |
| **系统稳定性** | 系统状态工具误触发清理/修复 | 仅用户明确要求时执行，备份先行 |
| **合规风险** | 客户删除操作不可逆，GDPR 违规 | 记录删除审计日志，保留法定期限 |
技术细节
- 认证方式：Bearer Token（MATON_API_KEY）
- 数据格式：JSON，货币金额为字符串（保留两位小数）
- 日期格式：ISO8601
- 错误码：标准 HTTP + WooCommerce 特定错误码