用途：该技能面向无头电商开发，讲解如何使用 Shopify 面向客户体验的公开 GraphQL 接口 Storefront API，配合 Cart API 构建自定义前端、移动应用与购买流程。与需服务端特权的 Admin API 不同，Storefront API 使用可安全置于客户端代码的公开访问令牌。
主要能力：配置 Storefront API 客户端（storeDomain、apiVersion、publicAccessToken）；执行购物车操作，包括创建购物车、添加/更新/移除行项目、应用折扣码，并跳转 checkoutUrl 完成结账；从客户端查询商品目录，字段含 id、title、handle、availableForSale、priceRange 与 variants 等；提供 Storefront 与 Admin API 在令牌类型、限流方式、购物车与结账支持、商品数据范围、可用变更操作方面的决策指引，以及 Hydrogen 框架的搭建模式。
前提条件：需要带 Storefront API 访问令牌的 Shopify 商店（Headless 渠道或自定义应用）；若使用 Hydrogen，需要 Node.js 18+ 与 Shopify CLI 3.x+；常用作用域包括 unauthenticated_read_products 与 unauthenticated_read_collections。
必要用法示例： import { createStorefrontApiClient } from "@shopify/storefront-api-client"; const client = createStorefrontApiClient({ storeDomain: "my-store.myshopify.com", apiVersion: LATEST_API_VERSION, publicAccessToken: "your-storefront-public-token", }); 通过 client.request 执行 CART_CREATE 等操作，创建后跳转到 data.cartCreate.cart.checkoutUrl；查询商品使用 products、priceRange、variants 等字段。需注意 Storefront API 的商品结构体字段名与 Admin API 不同。
错误处理：INVALID_STOREFRONT_ACCESS_TOKEN 需在 Headless 渠道重新生成令牌；THROTTLED 需退避重试并缓存商品数据；PRODUCT_NOT_AVAILABLE 需将商品发布到 Headless 销售渠道；CART_DOES_NOT_EXIST 说明购物车闲置 10 天过期，应新建购物车且不宜长期保存其 ID。
限制与未提供信息：资料未说明该技能的安装命令、许可方式、收费与价格，暂未提供。