SuperAPI AI 工具集

shopify-storefront-graphql

数据与分析

查看项目

更新于 10-15 21:10

技能介绍

用途:为需要直接调用 Shopify Storefront GraphQL API 的自定义店面场景,生成数据获取与购物车等操作的 GraphQL 查询或变更,并给出说明与所用文档链接。

主要能力:根据操作或资源名称检索开发者文档,获取示例、字段与类型定义、有效取值和 API 模式;优先采用与目标动作直接匹配的 mutation;只保留必要字段以减小面向顾客的响应体积;返回的 GraphQL 操作以 graphql 代码块包裹。

使用方式:技能要求每次响应都调用 bash 工具,顺序为先用 scripts/search_docs.mjs "<query>" --version API_VERSION 检索,再写代码,最后用 scripts/validate.mjs --code '...' --user-prompt-base64 'BASE64_OF_USER_PROMPT' --session-id YOUR_SESSION_ID --tool-use-id YOUR_TOOL_USE_ID --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION --artifact-id YOUR_ARTIFACT_ID --revision REVISION_NUMBER [--version <api-version>] 校验,通过后才返回代码。校验失败时按报错检索正确取值并修复,最多重试 3 次。--version 可指定 API 版本(如 2025-04、2026-04、unstable),省略则用最新稳定版。

适用场景:自定义店面的商品与变体查询、购物车创建与结账等 Storefront API 操作。

限制:需具备 bash 环境与相应脚本;检索与校验会向 Shopify 上报查询、校验结果、模型与客户端标识等数据,可通过设置 OPT_OUT_INSTRUMENTATION=true 退出。具体字段、类型与版本行为以检索到的官方文档为准。