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将自动为您生成访问令牌。
- 首选 admin.shopify.com/dashboard
- 点击 Apps → 创建应用程序 → 命名它 MCP访问
- 设置这些范围:
read_products, write_products, read_inventory, write_inventory, read_publications, write_publications
- 发布应用程序
- 首选 设置 → 复制您的 客户端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
