最近我尝试用 AI Agent 接入 Shopify，辅助搭建了一个自行车类独立站。整个过程不是简单让 AI 写页面，而是让 Agent 通过 Shopify API 直接参与店铺搭建、商品整理、主题修改和问题排查。
这篇简单分享一下流程和踩坑。
- 准备 Shopify 接入信息
首先需要准备几个基础信息：
Shopify 店铺域名
Admin API Token
Theme ID
App Client ID
App Secret
Agent 主要通过 Shopify Admin API 操作店铺，比如：
读取商品
更新商品
读取集合
修改主题文件
上传主题 asset
检查库存
检查市场和配送配置
常用接口包括：
GET /admin/api/2024-01/products.json
GET /admin/api/2024-01/collections.json
PUT /admin/api/2024-01/themes/{theme_id}/assets.json
这些信息准备好后，Agent 就可以直接读取店铺状态，而不是只靠人工截图判断。
- 让 Agent 先全面检查店铺
接入后第一步不是马上改网站，而是让 Agent 先检查：
当前商品数量
哪些商品已上架
哪些商品是草稿
商品是否有图片
商品描述是否完整
变体是否正常
库存是否可售
集合分类是否合理
主题结构是否清晰
购物车和加购流程是否正常
这一步很重要。
因为 Shopify 店铺的问题往往不是单点问题，而是商品、库存、市场、配送、主题同时影响。
- 用 Agent 修改主题框架
确认店铺结构后，可以让 Agent 直接修改主题文件。
比如：
首页布局
顶部导航
商品详情页
集合页
购物车页
页脚
多语言入口
CSS 样式
JS 加购逻辑
修改方式是：
Agent 读取当前主题文件
本地修改 Liquid / CSS / JS
通过 Shopify Theme Asset API 上传
再访问前台页面检查是否生效
这样比手动进 Shopify 后台编辑代码效率高很多。
- 用 Agent 整理商品数据
这次项目里，Agent 帮我处理了不少商品数据问题，例如：
修正过长商品标题
修正拼写错误
清理变体名里的多余说明
补充商品描述
统一 vendor
统一 product type
下架测试商品
整理商品分类
比如有些变体名里混入了一整句说明，前台看起来很乱。
Agent 可以批量读取变体，然后按规则清洗。
这类工作如果人工一个个改，非常费时间。
- 加购问题的排查
这次遇到一个比较典型的问题：
商品明明有库存，但加购时报：
The product is already sold out.
一开始看起来像库存问题，但 Agent 检查后发现：
商品已上架
变体有库存
Online Store 已发布
库存数量正常
最后定位到问题其实是：
Markets / Shipping 没配置完整
Shopify 有时会把“当前国家不可配送”显示成“售罄”。
这点很容易误判。
后来补好配送地区和运费规则，加购就恢复正常了。
- 优化购物车和加购体验
默认加购后会跳转到购物车。
后来让 Agent 改成 Ajax 加购：
点击加购后留在当前商品页
按钮显示 Added
右上角购物车数量自动更新
用户可以继续浏览其他商品
购物车页面也从简单表格优化成了更完整的结构：
商品图片
变体信息
数量修改
移除按钮
订单摘要
备注
结账按钮
这些都可以通过 Agent 修改主题完成。
- 多语言处理
我也让 Agent 给主题加了多语言文件：
英文
德语
西班牙语
法语
意大利语
中文
并把导航、按钮、购物车、商品页等固定文案都改成翻译 key。
不过这里也踩了一个坑：
Shopify 后台能启用多少语言，取决于店铺套餐或 Markets 限制。
主题里可以准备很多语言文件，但后台不一定都能发布。
- 权限问题是最大坑之一
Agent 接入 Shopify 最大的坑是权限。
Shopify App 增加权限后，旧 token 不会自动拥有新权限。
必须重新授权，拿新的 token。
比如：
要改商品，需要 write_products
要改库存，需要 write_inventory
要改主题，需要 write_themes
要改语言，需要 write_locales
要改配送，需要 write_shipping
如果权限不够，Agent 会读不到或改不了对应数据。
- 最后效果
最终 Agent 帮我完成了：
店铺主题框架搭建
商品数据清洗
商品详情优化
购物车页面优化
Ajax 加购
多语言基础支持
库存和加购问题排查
Markets / Shipping 问题定位
前台关键页面检查
整个过程下来，Agent 更像一个 Shopify 运维+前端+数据整理助手。
总结
用 Agent 接入 Shopify 的核心价值，不是让它“生成一个网页”，而是让它直接参与店铺运营工作：
查数据
改商品
改主题
查库存
排查加购
检查结账
批量清洗内容
我的经验是：
只要 API 权限配置好，Agent 可以大幅提升 Shopify 店铺搭建和维护效率。
但前提是：
权限要配对
token 要能正常使用
每次修改后要让 Agent 复查
重要流程必须真实测试
商品数据规则要提前定好
如果以后再做类似 Shopify 独立站，我会优先让 Agent 先做全店扫描，再按问题清单逐步处理，而不是一开始就直接改页面。
