用途:回答 Shopify 商家的分析与报表问题,例如“多少/多少笔/我的……是多少/按……分组/随时间变化/与去年相比”等店铺数据问题,均视为 ShopifyQL 任务。ShopifyQL 是 Shopify 的查询语言,用于聚合店铺指标(销售、订单、收入、会话、转化、趋势),这些是 Admin GraphQL API 无法计算的。
主要能力:编写 ShopifyQL 查询,基于文档返回的字段与子句构建,不猜测、不臆造。查询体统一写作 FROM … SHOW …,而非 SELECT,只写一条查询,并附简短说明其返回内容。ShopifyQL 为聚合报表,只读。
使用方式:先检索开发者文档确认 ShopifyQL 语法及所需 schema 的指标/维度,再选择 FROM schema(不同 schema 拥有不同数据切片,需按问题检索确认)。运行形式按环境选择:可用 Shopify CLI 时以只读 shopify store execute 命令运行;有 Admin GraphQL 客户端时用 shopifyqlQuery 字段包装,请求 tableData { columns { name dataType } rows } 与 parseErrors;无运行环境时以 ```shopifyql 代码块交付查询文本。能运行时执行并读取结果,遇 parseErrors 则据文档修正后重跑。
限制:文档未覆盖的指标、维度或分析应如实说明不可用,不得编造字段名。技能本身不提供 ShopifyQL 语法与 schema,需检索文档获取。资料未提供具体收费、价格、平台支持范围等信息。