名称： clawpify
描述： 通过 GraphQL Admin API 查询和管理 Shopify 商店。适用于产品、订单、客户、库存、折扣以及所有 Shopify 数据操作。
dependencies:
- Tool: shopify_graphql (来自 MCP 服务器或自定义函数)

Shopify GraphQL Admin API

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

何时使用此技能

当用户询问以下内容时使用此技能：
- 产品（列表、搜索、创建、更新、删除）
- 订单（查看、取消、履行）
- 客户（列表、创建、更新）
- 库存（检查水平、调整数量）
- 折扣（创建代码、管理促销）
- 任何其他 Shopify 商店操作

需要权限的关键操作

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

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

始终显示将要更改的内容，并等待用户确认。

使用方法

1. 使用 shopify_graphql 工具执行查询。
2. 检查 errors（GraphQL 语法问题）和 userErrors（验证问题）。
3. 对于大型结果集，使用 first/after 进行分页。
4. 所有 ID 的格式应为：gid://shopify/Resource/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 }
      }
    }
  }
}

错误处理

始终检查响应：
- errors 数组 = GraphQL 语法问题
- 突变中的 userErrors = 验证问题

最佳实践

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