Maton 托管的 WooCommerce REST API 集成，支持 OAuth 认证，可管理商品、订单、客户、优惠券等电商全链路操作，写操作需用户显式确认
说明：
## 核心用法
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 特定错误码
