OO WooCommerce 连接器

从对话到 WooCommerce 运营，不必先碰凭据

手工处理店铺运维时，最常见的阻塞点不是 API 本身，而是凭据怎么进、放哪儿、多久过期。这个技能面向的是那一层摩擦：它通过 OOMOL 连接账号调用 woocommerce 连接器，由 oo CLI 发起请求，凭据在服务端注入，模型和自动化流程不需要接触或保存原始 token。

核心能力与执行路径

连接器共暴露 26 个 action。读取侧覆盖订单、商品、优惠券、客户与商品组织信息：get_order、get_product、get_customer、get_coupon、list_orders、list_products、list_customers、list_coupons、list_order_notes、list_product_attributes、list_product_categories、list_product_tags、list_product_variations、get_product_variation。写入侧覆盖运营中高频的状态变更：create_order、update_order、update_order_status、create_product、update_product、create_product_variation、update_product_variation、create_coupon、update_coupon、add_order_note，另有 upload_media，用于上传到 WooCommerce 使用的 WordPress 媒体库。

标准执行路径只有几步：

• 先查契约，再拼 payload。 用 oo connector schema 拉取当前输入/输出 schema，不要凭字段名猜测。
• 读动作参考。 每个 action 都链接到用途与确切命令的参考文件，调用前先打开。
• 用 JSON payload 运行单个 action。 --data 接受 JSON 对象字符串或 @path/to/file.json；省略时发送 {}：

oo run <action> --data '{}'

• 从响应里取 meta.executionId。 返回结构是 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta 下。
• 只在命令真正失败时才做首次设置。 oo: command not found 就安装 CLI；未登录或认证错误就登录一次；scope_missing、credential_expired、app_not_ready、app_not_found 说明 WooCommerce 未连接、连接过期或缺少 scope，就用 custom credential 重新连接；HTTP 402 / OOMOL_INSUFFICIENT_CREDIT 是计费中断，充值后再试。

边界与注意点

• 读取类动作（get / list）可以直接运行。
• create、update、upload 会改变店铺状态。 运行前应与用户确认确切 payload 和预期效果。
• 当前资料中没有 delete 或 remove 动作；若以后出现，应视为破坏性操作，必须确认目标并取得明确批准。
• 涉及目录、价格、库存、订单状态、客户可见备注或优惠券规则时，字段应由实时 schema 和当前店铺状态校验，而不是照抄旧配置。
• 这个技能面向 WooCommerce 与 WooCommerce 使用的 WordPress 媒体库，不是通用 WordPress 管理工具。