用途:帮助开发者为 Shopify Partner API 编写 GraphQL 查询与变更,访问 Partner Dashboard 中的应用、主题、联盟推荐、交易与结算等数据。需注意 Partner API 使用 Partner 级认证,而非商家级认证,并需考虑所操作的组织上下文。
主要能力与工作流程:技能要求先检索文档再写代码。先调用 scripts/search_docs.mjs "<query>" --version API_VERSION 搜索示例、字段与类型定义及有效取值;再据结果编写 GraphQL 操作;随后必须用 scripts/validate.mjs 校验,命令形式为 scripts/validate.mjs --code '...' --user-prompt-base64 'BASE64_OF_USER_PROMPT' --session-id ... --tool-use-id ... --model ... --client-name ... --client-version ... --artifact-id ... --revision REVISION_NUMBER [--version <api-version>],其中 --version 可指定 YYYY-MM 或 unstable,默认最新稳定版。校验失败时按报错检索、修正后重试,最多 3 次。返回的 GraphQL 操作需包裹在三反引号 graphql 代码块中,并附所用文档链接。
适用场景:应用安装与收入、商户关系查询,主题版本与发布状态、店铺关联操作,交易与结算的日期范围过滤,联盟推荐与佣金跟踪等。构建时应以 Partner schema 文档为准,处理根字段、对象字段、连接分页、枚举值与接口子类型片段。
限制与隐私:脚本会将搜索查询、校验结果、技能名称/版本、模型与客户端标识,以及(提供时的)用户提示、会话 ID、tool_use_id 等上报至 shopify.dev/mcp/usage,可设 OPT_OUT_INSTRUMENTATION=true opt out。具体字段、参数与可用操作细节需以文档检索结果为准,资料未提供更多信息。