Shopify GraphQL 管理 API

一项用于与 Shopify 的 GraphQL 管理 API 进行交互的综合技能。此技能使 Claude 能够查询和管理 Shopify 商店数据的各个方面。

何时使用此技能

当用户询问以下内容时使用此技能：

• 产品（列出、搜索、创建、更新、删除）
• 订单（查看、取消、履行）
• 客户（列出、创建、更新）
• 库存（检查水平、调整数量）
• 折扣（创建代码、管理促销）
• 任何其他 Shopify 商店操作

需要权限的关键操作

重要提示：在执行以下任何操作之前，您必须请求用户的明确许可：

• 退款：创建退款（永久性财务交易）
• 订单取消：取消订单（可能会触发退款）
• 礼品卡停用：永久禁用礼品卡
• 库存调整：修改库存水平
• 产品删除：永久移除产品
• 折扣激活：为客户调整定价

始终显示即将进行的更改并等待用户确认

使用指南

1. 使用shopify_graphql工具执行查询
2. 检查错误（GraphQL问题）和用户错误（验证问题）
3. 处理大型结果集时使用first/after进行分页
4. 所有ID格式应为：gid://shopify/资源类型/123

可用参考文档

详细模式和示例请参阅参考文档：

• products.md - 产品与变体管理
• orders.md - 订单操作
• customers.md - 客户管理
• inventory.md - 库存与位置
• discounts.md - 折扣码与促销活动
• collections.md - 产品系列
• fulfillments.md - 订单履约与配送
• refunds.md - 处理退款
• draft-orders.md - 草稿订单创建
• gift-cards.md - 礼品卡管理
• webhooks.md - 事件订阅
• locations.md - 店铺位置
• marketing.md - 营销活动
• markets.md - 多市场设置
• menus.md - 导航菜单
• metafields.md - 自定义数据字段
• pages.md - 店铺页面
• blogs.md - 博客管理
• files.md - 文件上传
• shipping.md - 配送配置
• shop.md - 店铺信息
• subscriptions.md - 订阅管理
• translations.md - 内容翻译
• segments.md - 客户细分
• bulk-operations.md - 批量数据操作

快速示例

列出近期订单

query {
  orders(first: 10, sortKey: CREATED_AT, reverse: true) {
    nodes {
      id
      name
      totalPriceSet {
        shopMoney { amount currencyCode }
      }
      customer { displayName }
    }
  }
}

搜索产品

query {
  products(first: 10, query: "title:*shirt* AND status:ACTIVE") {
    nodes {
      id
      title
      status
    }
  }
}

检查库存

query GetInventory($id: ID!) {
  inventoryItem(id: $id) {
    id
    inventoryLevels(first: 5) {
      nodes {
        quantities(names: ["available"]) {
          name
          quantity
        }
        location { name }
      }
    }
  }
}

错误处理

始终检查响应：

• 错误数组 = GraphQL 语法问题
• 用户错误在变更操作中 = 验证问题

最佳实践

1. 仅请求所需字段以优化响应大小
2. 对可能增长的列表使用分页
3. 检查所有变更操作响应中的用户错误
4. 在执行危险操作前请求权限
5. 为用户清晰格式化结果
6. 对于大型数据导出/导入使用批量操作
7. 使用指数退避处理速率限制