把 WooCommerce 接到 Claude:唯一不用应用审批的那种店

0 阅读5分钟

没有开发者计划,没有审核排队,不用等。你在自己的 WordPress 后台生成一把 Read/Write 的 REST key。剩下会失败的地方只有两处:一个粘多了的网址,和一个只显示一次的密钥。

如果你已经试过把某个平台接到 Claude,WooCommerce 这一版会让你觉得哪里不对劲——好的那种不对劲。没有开发者计划要加入,没有应用要提交,没有审核要等。原因是结构性的:WooCommerce 跑在你自己的 WordPress 上,你和 API 之间没有平台方。

一句话 不用审批,因为服务器是你自己的 所有托管型平台都把 API 挡在申请审核后面。WooCommerce 跑在你自己的 WordPress 上,所以这把钥匙由你自己发。

实际要做的事

在 WordPress 后台走 WooCommerce → Settings → Advanced → REST API,为一个具备所需权限的店铺用户创建一把 key。你会拿到一个 Consumer Key 和一个 Consumer Secret 。加上商店网址,凭证就齐了。

对比一下邻居。Etsy 要一个获准 Seller API Access 的应用。eBay 要 Developers Program 的应用和生产 keyset。Amazon 要 Professional Selling 计划、获批的开发者资料和一个私有 SP-API 应用。WooCommerce 要的是一个下拉框和一个按钮。

剩下两个还是会出错的地方

商店网址。 填 HTTPS 的商店根地址。如果 WordPress 装在域名下的子目录里,把那个子目录保留。 不要 在后面接 /wp-json/wc/v3——那是 API 路径,客户端自己会加。把完整 API 路径粘进去,是“看起来配好了但什么都取不到”的最常见原因。

密钥只显示一次。 Consumer Secret 和 key 一起生成,只显示一遍,没有“再看一次”。如果你在复制之前关了页面,解决办法是吊销这把 key 再发一把——很快,但第一次遇到会愣一下。

两个坑,都是静默的 Read 不等于 Read/Write,密钥只显示一次 权限下拉框的默认值不是你要的,而密钥再也不会显示第二次。这两个都是事后才报错,不是当场。

Read 不等于 Read/Write

创建 key 的时候,那个权限下拉框决定了这个连接这辈子能做什么。Read 让助手回答关于商品、订单、客户的问题。 Read/Write 才让它能改价格、调库存、更新订单、发起退款。

这跟“托管 connector 只读 vs 真能动手”是同一个分水岭,区别是这里你自己控制站在哪一侧,而且这个选择是一个下拉框,不是一次 scope 审核。想清楚再选:如果你只要报表,Read 是个合理的起点,之后再发第二把 key 也不花什么成本。

Orkas 的 connector 覆盖商品、分类、库存、订单、客户、优惠券、评价、退款和报表。凭证在你自己的设备上加密存放,不在配置文件里,也不在别人的服务器上;任何写进活跃店铺的操作都要过客户端里的权限确认。

什么时候别的方案更合适

你要它定时跑、没人盯着: 这是桌面应用,关掉窗口就停。WordPress 的 cron 或你自己服务器上的定时任务才是对的形态。

你要助手改的是站点而不是店铺: WooCommerce 的数据是商品和订单。改文章、模板、插件那是 WordPress,是另一个面,有它自己的工具。

你要批量改商品数据: WooCommerce 自带 CSV 导入导出,纯粹按列批改的话,那比任何对话都快。

同一份目录 还覆盖 Etsy、eBay、Walmart Marketplace、Amazon Seller Central、Shopify 和中国的几个平台。所以如果你的 WooCommerce 店旁边还开着平台店,凭证会集中在一处,而不是每个店配一个服务。

实践补充

版本与使用说明

原文对无人值守运行作了限制性描述。当前使用指南同时提供“自动化”:可在指定设备上执行一次性或周期任务,运行时设备与所需权限必须可用。桌面工作流和托管服务的区别,应与 Orkas 是否能安排定时任务分开理解。

原文关于授权提示的描述,应结合当前连接器指南阅读。连接器调用(包括外部 CLI 智能体发起的调用)遵循本机操作权限设置;已识别的读取和常规编辑不一定询问,敏感或未分类操作取决于所选模式。不要假设每次写入都会重新请求确认。

当前 Orkas 使用指南

延伸任务示例

用库存表核对这二十个商品,显示 SKU、库存和价格差异,保留原始字段并准备修正建议表,不执行修改或退款。

首次读取的核对表

项目记录内容
店铺与范围店铺、站点、时间范围及所用连接方式
样本记录在店铺后台能独立核对的商品或订单编号
字段差异返回值、后台值、缺失字段和可能的口径差异
待办事项建议修改、依据及尚未批准的操作

下一步

Orkas 官方指南 · 最后核验:2026-09-14