核心用法
WooCommerce skill 提供对 WooCommerce REST API 的完整封装，通过 Maton 代理服务实现托管式 OAuth 认证。用户只需配置 MATON_API_KEY 环境变量，即可调用商品、订单、客户、优惠券、物流、税费、报表及 Webhooks 等全量接口。
认证流程：
1. 在 maton.ai 获取 API Key
2. 创建 WooCommerce 连接并跳转授权 URL 完成 OAuth
3. 所有请求通过 Authorization: Bearer $MATON_API_KEY 头部鉴权
4. 多店铺场景可通过 Maton-Connection 头部指定目标店铺
典型场景：
- 商品管理：批量创建/更新商品、管理变体与属性、分类标签维护
- 订单处理：查询订单状态、更新订单进度、处理退款与备注
- 客户运营：客户数据同步、地址管理、下载权限查看
- 促销配置：创建限时优惠券、设置折扣规则与使用限制
- 数据洞察：获取销售报表、热销排行、库存统计
显著优点
1. 零 OAuth 基建成本：Maton 托管完整的 OAuth 流程，开发者无需处理 token 刷新、密钥存储等安全敏感操作
2. 完整 API 覆盖：支持 WooCommerce REST API v3 全部资源端点，涵盖电商运营全生命周期
3. 多店铺灵活切换：单 API Key 可管理多个 WooCommerce 店铺连接，通过头部指定目标店铺
4. 标准化接口格式：保持原生 WooCommerce API 的 URL 结构与响应格式，降低迁移成本
5. 批量操作支持：商品、订单、税费等资源均支持 batch 批量创建/更新/删除，提升数据处理效率
潜在缺点与局限性
1. 网络依赖性强：完全依赖 Maton 代理服务，若服务不可用则无法访问 WooCommerce 数据
2. 数据隐私顾虑：订单、客户等敏感数据流经第三方代理，需评估合规要求
3. 延迟增加：相比直连店铺 API，多一层代理可能引入额外网络延迟
4. 功能边界限制：仅支持标准 REST API 端点，自定义 WooCommerce 插件扩展的 API 可能无法访问
5. 速率限制不透明：Maton 层可能存在未公开的请求频率限制，大促场景需提前验证
适合人群
- 电商 SaaS 开发者：快速集成多店铺 WooCommerce 数据，无需维护 OAuth 基础设施
- 运营自动化团队：构建订单处理、库存同步、促销管理的自动化工作流
- 数据分析场景：定期拉取销售报表、客户数据进行 BI 分析
- 多渠道零售商：统一管理 WooCommerce 与自有系统的商品与订单数据
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | `MATON_API_KEY` 泄露可导致账户数据被访问 | 使用环境变量注入，禁止硬编码；定期轮换密钥 |
| 误操作数据 | 批量更新/删除可能造成不可逆数据丢失 | 生产操作前先在沙箱验证；关键操作要求用户二次确认 |
| OAuth 授权过期 | 店铺授权撤销或过期导致连接失效 | 监控连接状态，设置授权过期预警 |
| 数据同步延迟 | 代理层缓存或网络问题导致数据不一致 | 关键业务场景增加数据校验机制 |