SuperAPI AI 工具集

shopify-admin-url-redirect-audit

部署与运维

查看项目

更新于 10-15 09:38

技能介绍

用途:查询 Shopify 店铺中所有 URL 重定向,并识别三类问题:重定向链(重定向目标 A 本身又重定向到 B)、重复目标(多个来源路径指向同一目的地),以及孤立重定向(指向不存在的页面)。重定向链会额外增加 HTTP 往返延迟并影响 SEO。该技能为只读操作,不执行任何写操作,可随时安全运行。

前置条件:需要已认证的 Shopify CLI 会话,命令为 shopify store auth --store <domain> --scopes read_content;所需 API 权限为 read_content。

参数:store(字符串,必填,无默认值,店铺域名,例如 mystore.myshopify.com);format(字符串,可选,默认 human,输出格式可选 human 或 json)。

安全性:只读技能,不执行任何写操作,随时可安全运行。

工作流程:通过 OPERATION urlRedirects 查询,输入 first: 250 与分页游标,获取包含 fromPath、target 的全部重定向,持续分页直到 hasNextPage: false;随后构建 fromPath → target 的路径映射;检测链——对每个重定向检查其 target 是否出现在其他重定向的 fromPath 中;检测重复——统计有多个来源路径指向的相同 target。

GraphQL 操作示例(api_version 2025-01): query URLRedirects($after: String) { urlRedirects(first: 250, after: $after) { edges { node { id path target } } pageInfo { hasNextPage endCursor } } }

会话追踪:技能在每个阶段必须输出状态信息。开始时输出带 SKILL、Store、Started 的方框标记;每步之后输出 [N/TOTAL] <QUERY|MUTATION> <OperationName> 及其参数与结果概要;完成时按 format 输出结果。human 格式(默认)显示总重定向数、重定向链数、重复目标数,并列出链与重复项及输出文件名;json 格式输出包含 skill、store、total_redirects、chains、duplicate_targets、output_file 的 JSON 对象。

输出格式:生成 CSV 文件 redirect_audit_<YYYY-MM-DD>.csv,列包括 redirect_id、from_path、target、issue_type、chain_path。

错误处理:THROTTLED(API 速率限制超出)时等待 2 秒并最多重试 3 次;无重定向(新店铺或已清理设置)时以 ✅ no redirects found 退出。

最佳实践:重定向链(A→B→C)会增加一次额外的 HTTP 往返,应合并为直接重定向(A→C)。修复链或移除重复项后,使用 Shopify 后台 → 导航 → URL 重定向进行更正。Admin API 不支持批量删除,但可通过 urlRedirectDelete mutation 删除单个重定向。建议在每次重大店铺迁移或商品/集合结构调整导致 URL 批量变更后运行。

限制:该技能为只读,仅检测与输出问题,不直接修改店铺配置;批量删除在 Admin API 中不可用;缺失信息暂未提供。