SuperAPI AI 工具集

fetch-shopify-schema

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:在开发 Vercel Shop 时,获取权威的 Shopify GraphQL 架构信息,用于编写新的查询或变更、检查类型可用字段、排查字段名或类型相关的 GraphQL 错误,以及探索 Shopify API 可用数据。

主要能力与来源:以已安装的 Shopify/shopify-ai-toolkit 插件作为架构的唯一权威来源,进行实时类型查询、字段查询、参数校验与 API 探索。官方明确要求不要为本模板创建或更新仓库内的架构快照文件。

API 区分:Storefront API 用于商品、集合、菜单、购物车、搜索及面向店面的 metaobjects;Customer Account API 用于客户资料、订单、地址及需认证的账户数据。两者架构不可互换。确认架构细节后,可转到 /vercel-shop:shopify-graphql-reference 获取模板的 GraphQL 约定,包括文件位置、片段、区域上下文、缓存与转换。

工具不可用时:请用户安装或重装项目级 Shopify 插件:npx plugins add Shopify/shopify-ai-toolkit --scope project --yes。若实时工具访问受阻,应回退到官方 Shopify API 文档或架构浏览器,而非向仓库添加快照文件。

限制与护栏:切勿猜测字段名、枚举值或参数结构;切勿向模板添加 .claude/schemas、签入的架构快照或其他仅供代理使用的架构缓存。Storefront API 使用公开 Storefront Access Token,提供商品、集合、购物车操作的读取权限;Customer Account API 需要客户认证及客户范围访问令牌,令牌处理保持在认证流程与服务端辅助函数内。