Shopify分析MCP服务器
免费向Claude询问您的Shopify商店——订单、收入、热门产品、库存。
开源 主控程序 服务器，通过Claude Desktop、Cursor、Claude Code或任何兼容MCP的主机为Shopify店主提供自然语言分析。通过以下方式在本地运行 npx --无主机、无服务器、无经常性费用。
快速开始
1.创建Shopify应用程序
- 首选 dev.shopify.com/dashboard
- 创建应用程序 → 从开发仪表板开始 → 命名它（例如“克劳德分析”）
- 版本 tab → 创建版本 使用这些范围：
- read_orders - read_products - read_customers - read_inventory - read_analytics - read_reports
- 发布 版本
- 家 → 安装应用程序 → 选择您的店铺
- 设置 → 复制您的 客户端ID 和 客户端密钥
2.连接到克劳德桌面
打开克劳德桌面→ 设置 → 开发者 → 编辑配置 并粘贴：
{
"mcpServers": {
"shopify-analytics": {
"command": "npx",
"args": ["-y", "@scooperai/shopify-analytics-mcp"],
"env": {
"SHOPIFY_STORE": "your-store-subdomain",
"SHOPIFY_CLIENT_ID": "your-client-id",
"SHOPIFY_CLIENT_SECRET": "your-client-secret"
}
}
}
}用你自己的值替换这三个值。 SHOPIFY_STORE 是来自的子域 your-store-subdomain.myshopify.com.
重新启动克劳德桌面。完成。
已经有其他MCP服务器了吗？
如果您的配置已经有其他服务器，请添加 shopify-analytics 在现有的 mcpServers block（不要创建第二个）：
{
"mcpServers": {
"some-other-mcp": {
"command": "npx",
"args": ["-y", "some-other-mcp"]
},
"shopify-analytics": {
"command": "npx",
"args": ["-y", "@scooperai/shopify-analytics-mcp"],
"env": {
"SHOPIFY_STORE": "your-store-subdomain",
"SHOPIFY_CLIENT_ID": "your-client-id",
"SHOPIFY_CLIENT_SECRET": "your-client-secret"
}
}
}
}只需在现有服务器关闭后添加逗号 } 并粘贴 "shopify-analytics" 块之后。
传统身份验证（现有自定义应用程序）
如果你有一个现有的自定义应用程序 shpat_ 访问令牌：
{
"mcpServers": {
"shopify-analytics": {
"command": "npx",
"args": ["-y", "@scooperai/shopify-analytics-mcp"],
"env": {
"SHOPIFY_STORE": "your-store-subdomain",
"SHOPIFY_ACCESS_TOKEN": "shpat_xxxxx"
}
}
}
}可用工具
| 工具 | 描述 | 示例提示 |
|---|---|---|
get_sales_summary | 收入、订单、AOV与同期比较 | “我们上周与前一周的表现如何？” |
get_top_products | 按收入或销量分列的畅销书 | “本月我们的前五大产品是什么？” |
get_order_trends | 每日/每周/每月趋势细分 | “显示过去90天的收入趋势” |
get_recent_orders | 最新订单及其状态和详细信息 | “今天有大订单吗？” |
get_order_details | 特定订单的完整详细信息 | “订单#1042发生了什么？” |
get_customer_insights | 客户数量、顶级消费者、汇总 | “谁是我们的顶级消费者？” |
get_inventory_status | 库存水平、低库存和缺货警报 | “我们有什么东西缺货吗？” |
get_product_performance | 深入了解特定产品或比较 | “Premium Widget本季度表现如何？” |
get_sales_by_geography | 按国家、地区或城市划分的收入 | “我们的客户来自哪里？” |
get_sales_by_channel | 按销售渠道划分的收入 | “哪些销售渠道表现最佳？” |
get_discount_performance | 折扣码的使用和有效性 | “我们的折扣码表现如何？” |
get_refunds_summary | 退款总额和费率（可选按产品） | “我们本月的退款率是多少？” |
search_orders | 使用过滤器进行灵活的订单搜索 | “显示上周所有退款订单” |
run_shopifyql | 运行任何自定义的ShopifyQL查询 | “上个季度的销售额是多少？” |
get_customer_rfm_segments | RFM细分：冠军、忠诚、有风险、迷失 | “显示我的客户细分” |
get_customer_churn_risk | 识别有流失风险的客户 | “我将失去哪些客户？” |
get_customer_ltv_summary | 客户终身价值预测 | “我的客户的终身价值是多少？” |
get_customer_health_report | 完整的客户健康诊断和行动 | “我的客户做得怎么样？” |
对话示例
每日入住：
“我们昨天过得怎么样？” 昨天：12个订单的收入为1842美元（AOV 153.50美元）。比前一天下降了8%。退款/折扣后的净收入：1720美元。
每周回顾：
“本周我们最畅销的产品是什么？” 按收入排名前10的产品（本周）： 1. 高级小工具（2450美元） 1. 入门套件（1890美元） 1. 专业套餐（1230美元） ...
库存警报：
“我们的东西快用完了吗？” 3个缺货和7个低库存变体（阈值：10个单位）。 缺货：高级小工具-大号，入门套件-蓝色。..
自定义查询：
“我们的小时销售模式是什么样的？” *（用途run_shopifyql和FROM sales SHOW total_sales, orders TIMESERIES hour_of_day DURING last_week)*
特别调查：
“向我显示来自的所有订单jane@example.com" 找到4个订单匹配“email：jane@example.com": #1089:245.00美元--无名氏（已付款，已付清） ...
客户健康检查：
“我的客户怎么样了？” 客户健康报告（过去12个月）：342名客户，总收入89450美元。 1项高严重性发现：23名有价值的客户面临流失风险，历史支出为12340美元。 1中等严重程度的发现：前10%的客户贡献了52%的收入。 行动：立即联系风险最高的客户。
流失风险：
“我会失去哪些客户？” 23名客户面临流失风险，历史收入为12340美元。 最有价值的风险：无名氏（2450美元，逾期45天）。
运作原理
此MCP服务器使用两个Shopify API：
- ShopifyQL 的 (
shopifyqlQuery)用于所有汇总分析——销售摘要、趋势、顶级产品、地理细分、渠道绩效。Shopify在服务器端进行聚合，并直接返回表格数据。 - GraphQL管理API 用于实体级查找——特定订单、库存数量、订单搜索。
每个工具都返回双格式响应：
summary--LLM可以直接中继的人类可读字符串data--用于后续分析的结构化JSON
服务器是 设计为只读。无写入操作。不创建产品、更新订单或删除任何内容。仅限分析。
认证
服务器支持两种身份验证方法，可从环境变量中自动检测：
| 变量 | 方法 | 注释 |
|---|---|---|
SHOPIFY_CLIENT_ID + SHOPIFY_CLIENT_SECRET | 客户端凭据授予 | 建议。代币每24小时自动刷新一次。 |
SHOPIFY_ACCESS_TOKEN | 传统静态令牌 | 适用于具有 shpat_ 代币。 |
客户端凭据授予要求应用程序和存储位于 同一Shopify组织。这是商家查询自己商店的标准设置。
故障排除
“身份验证失败”
- 在Shopify开发仪表板中验证您的客户端ID和客户端密码 设置.
- 确保您发布了该应用程序的版本并将其安装在您的商店中。
“客户端凭据身份验证要求应用程序和存储位于同一组织中”
- 开发人员仪表板应用程序必须在拥有该商店的同一组织下创建。登录 dev.shopify.com 使用管理您商店的同一帐户。
“缺少所需的API作用域”
- 转到您的应用程序 版本 在Dev Dashboard中的选项卡中，添加缺少的范围，发布新版本，然后在商店管理员中重新批准。
“ShopifyQL解析错误”
- 如果使用
run_shopifyql，检查查询语法。Shopify的错误消息将描述出了什么问题。Claude通常可以自动修复并重试。
“已达到Shopify API费率限制”
- 服务器会自动重试回退，但如果您一直达到限制，请尝试缩小日期范围或减少并发查询。
需求
- Node.js 18+
- 带有Dev Dashboard应用程序（或传统自定义应用程序）的Shopify商店
- MCP兼容主机（克劳德桌面、光标、克劳德代码等）
发展
git clone https://github.com/scooperai/shopify-analytics-mcp.git
cd shopify-analytics-mcp
npm install
npm run build要在本地进行测试，请设置环境变量并运行：
SHOPIFY_STORE=your-store SHOPIFY_CLIENT_ID=xxx SHOPIFY_CLIENT_SECRET=yyy node dist/index.js许可证
麻省理工学院
______________________________________________________________________
由...建造 滑板车AI。我们为电子商务团队构建定制的人工智能工作流程。这个MCP服务器可以免费体验我们的工作。