AI导哈

Shopify分析MCP服务器

一个开源MCP服务器，通过Claude Desktop、Cursor、Claude Code或任何MCP兼容主机为Shopify店主提供自然语言分析服务，本地运行，无需托管服务器或持续成本。

  • by DrMatrixx
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DrMatrixx/shopify-analytics-mcp

使用说明

Shopify分析MCP服务器

免费向Claude询问您的Shopify商店——订单、收入、热门产品、库存。

开源 主控程序 服务器，通过Claude Desktop、Cursor、Claude Code或任何兼容MCP的主机为Shopify店主提供自然语言分析。通过以下方式在本地运行 npx --无主机、无服务器、无经常性费用。

快速开始

1.创建Shopify应用程序

  1. 首选 dev.shopify.com/dashboard
  2. 创建应用程序 → 从开发仪表板开始 → 命名它（例如“克劳德分析”）
  3. 版本 tab → 创建版本 使用这些范围：
    • read_orders
    • read_products
    • read_customers
    • read_inventory
    • read_analytics
    • read_reports
  4. 发布 版本
  5. 家 → 安装应用程序 → 选择您的店铺
  6. 设置 → 复制您的 客户端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美元）
  2. 入门套件（1890美元）
  3. 专业套餐（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服务器可以免费体验我们的工作。

相关 MCP