Shopify Agent 的第一步不是写文案，而是接通 API

第一版 Shopify Operator Agent 的方向是对的：店铺诊断、每日简报、商品页优化、客户消息分流、社媒内容生成。

但这些更多还是“方法型 Skill”。

如果要让它真的变成能跑店铺运营的 Agent，基础问题更直接：

Agent 能不能安全连接 Shopify，读取正确的数据，并在不擅自改动业务的前提下准备下一步动作？

所以我们把公开 Skill repo 更新了一层 Shopify Admin API 连接能力。

这次 repo 更新了什么

现在 repo 里新增了：

shopify-admin-api-connector：处理 Shopify Admin GraphQL 授权、权限规划、连接检查、读取查询、预览式写入和审批边界的 Skill。
references/shopify-api-auth.md：Shopify API 产品面和授权方式的实践总结。
references/github-shopify-skill-sources.md：我们搜索并参考过的 Shopify Skill 开源项目和来源说明。
scripts/shopify-admin-graphql.mjs：用于连接检查、读取最近商品、读取最近订单的小脚本。
templates/shopify-env.example：本地安全 env 模板。

GitHub repo：

clawmama-run/shopify-growth-operator-agent

从现有 Shopify Skills 学到什么

GitHub 上已经有一些 Shopify Skill 项目。

最重要的是 Shopify 官方的 Shopify/agent-skills。它不是把 Shopify 写成一个大 prompt，而是按 Shopify 的不同产品面拆开：Admin GraphQL、Storefront GraphQL、Customer Account API、Liquid、Hydrogen、Functions、Polaris extensions 等。

这个结构给我们的启发是：真正可靠的 Shopify Agent，要按具体 API / 产品面拆 Skill，并且在生成查询或代码前查文档、做验证。

我们也参考了 lvsao/shopify-skill-hub 这类更偏店主运营的项目。共同点是：真实店铺操作必须有 env 设置、最小权限、预览优先，以及明确审批。

第一层应该接哪个 API

Shopify 的 API 和产品面很多。对这个 Agent 来说，第一层应该先接 Admin GraphQL。

它能让 Agent 读取店主真正关心的运营信号：

商品；
SKU、变体和库存；
订单和履约状态；
必要时读取客户上下文；
SEO 字段；
metafields；
折扣；
后续再接 webhooks 和 bulk operations。

Storefront API、Liquid、Hydrogen、Functions、UI Extensions 也重要，但它们不是“每日增长运营 Agent”的第一层。

安全连接流程

连接层遵循这个流程：

授权 → 验证店铺 → 读取商品/订单/库存 → 诊断 → 预览修改 → 店主审批 → 执行 → 验证

本地测试可以这样跑：

cp templates/shopify-env.example .shopify.env
node scripts/shopify-admin-graphql.mjs check --env .shopify.env
node scripts/shopify-admin-graphql.mjs products --first 10 --env .shopify.env
node scripts/shopify-admin-graphql.mjs orders --first 10 --env .shopify.env

env 文件只保存在本地，不提交到 GitHub：

SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
SHOPIFY_API_VERSION=2026-07
# Admin API access token 也放在这个私有 env 文件里

真正产品化时，更应该通过 Shopify Dev Dashboard app 或 Shopify CLI app flow 做安装授权，把 offline token 安全地存在服务端。单店铺 custom token 可以用于本地测试，但不应该成为完整产品架构。

审批不是可选项

Shopify Agent 可以安全地读取数据、生成诊断和草稿。但它不应该擅自做这些事：

退款；
取消订单；
修改地址；
修改库存或价格；
发布商品页；
启动折扣；
直接发送客户回复。

默认应该是 preview mode。Agent 要先展示当前值、建议修改值、影响到的商品/订单/客户 ID、风险、回滚方式，以及审批后将执行的具体操作，再让店主确认。

为什么这一步重要

Shopify 连接层打通以后，其他 Skill 才不只是“建议”。

商品页优化可以基于真实商品和库存。每日简报可以基于最近订单。客户消息分流可以先查订单上下文再起草回复。社媒内容生成可以推广已经在转化的商品，而不是凭空猜。

这就是“泛电商助手”和“Shopify 运营 Agent”的区别。