AI导哈

Shopify管理AI代理

Vivoid Shopify Manager是一款基于AI的Shopify店铺管理工具，通过Claude Code和Shopify GraphQL Admin MCP实现无需手动操作的目录管理、产品文案撰写和店铺运营。

  • by Mr-Ahtserhs
  • 本地部署
  • 更新于
在 GitHub 查看 Mr-Ahtserhs/shopify-mcp-ai-manager

使用说明

Vivoid Shopify经理

用于免提Shopify目录管理、产品文案和商店运营的AI代理——由Claude Code和Shopify GraphQL Admin MCP提供支持。

这有什么作用

您不必通过Shopify管理员逐个更新产品，而是告诉Claude您想要什么，它会直接根据您商店的API执行-安全门可以防止意外删除或价格错误的发布。

示例提示：

  • “列出我的所有产品”
  • “为产品ID 123编写电影描述”
  • “为Kids系列中的所有产品添加标签‘sale’”
  • “创建一个名为Jungle Safari Book的新产品，24.99美元，草稿”
  • “出版林地益智书——先确认价格”

可用代理

Agent Slash命令 描述
目录管理器 /catalog-manager 创建、更新、写入副本、管理集合

先决条件

  • 克劳德代码 安装
  • Node.js 18+
  • Shopify商店
  • Shopify开发仪表板帐户（免费）

安装

步骤1--安装插件

/plugin marketplace add Mr-Ahtserhs/shopify-mcp-ai-manager
/plugin install shopify-manager

步骤2--获取您的Shopify凭据

你需要你的 客户端ID 和 客户端密钥 来自Shopify开发仪表板。Claude将自动为您生成访问令牌。

  1. 首选 admin.shopify.com/dashboard
  2. 点击 Apps → 创建应用程序 → 命名它 MCP访问
  3. 设置这些范围： read_products, write_products, read_inventory, write_inventory, read_publications, write_publications
  4. 发布应用程序
  5. 首选 设置 → 复制您的 客户端ID 和 客户端密钥

克劳德自动处理其他一切。

步骤3--连接您的商店

Claude在首次使用时会自动询问您的商店URL、客户端ID和客户端密码，然后生成访问令牌并为您配置所有内容。

第4步——开始使用它

自然地和克劳德谈谈：

"List all my products"
"Write a description for product ID 123"
"Add tag 'sale' to all products in Kids collection"

令牌刷新

您的访问令牌每24小时过期一次。当它过期时，Claude会自动检测到它，并询问您是否要刷新它。

手动刷新：

curl -X POST \
  "https://YOUR_STORE.myshopify.com/admin/oauth/access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'

克劳德将更新 .mcp.json 当您运行“刷新令牌”时自动执行。

安全特性

规则 行为
删除门 需要精确的短语 I authorize deletion
价格检查 每次发布前显示价格
不可逆操作 需要 I authorize this change
无静默故障 所有API错误立即显现
作用域锁定 不重新启动就无法切换存储

项目结构

shopify-mcp-ai-manager/
├── .claude-plugin/
│   └── marketplace.json              # Claude Code plugin manifest
├── skills/
│   ├── catalog-operations/
│   │   ├── SKILL.md                  # GraphQL patterns, MCP usage
│   │   ├── evals/
│   │   └── references/
│   │       └── graphql-patterns.md
│   ├── product-copywriting/
│   │   ├── SKILL.md                  # Cinematic HTML descriptions
│   │   ├── evals/
│   │   └── references/
│   │       └── html-templates.md
│   ├── safety-rules/
│   │   ├── SKILL.md                  # Deletion gates, pricing verification
│   │   ├── evals/
│   │   └── references/
│   └── shopify-context/
│       ├── SKILL.md                  # Store info, brand voice, currency
│       ├── evals/
│       └── references/
│           └── store-context-example.md
├── .gitignore
├── mcp.json.template                 # MCP config template (copy to .mcp.json)
├── AGENTS.md
├── CLAUDE.md                         # Claude Code auto-load instructions
├── CONTRIBUTING.md
├── LICENSE
├── VERSIONS.md
└── README.md

技能

技能 范围 描述
safety-rules 全局 删除门、定价验证
shopify-context 全球 店铺信息、品牌声音、货币
catalog-operations 代理 GraphQL模式，MCP使用
product-copywriting Agent 电影HTML描述

贡献

看 贡献.md.

许可证

麻省理工学院 - Vivoid Digital

相关 MCP