SuperAPI AI 工具集

sfnext-seo

编程与开发

查看项目

更新于 11-17 21:24

技能介绍

用途

sfnext-seo 是一项面向 Salesforce Commerce Cloud Storefront Next 项目的 SEO 技能参考,围绕页面元数据、结构化数据、规范化 URL、可配置 SEO 路由、多域名与基础路径、爬虫渲染等主题,给出实现方式与规则说明。技能正文将其定位为“任务地图”,更深入的内容需要查阅项目内的 docs/README-SEO.md、docs/README-AEO-GEO.md、docs/README-MULTI-SITE.md、docs/README-MULTI-DOMAIN.md、docs/README-BASE-PATH.md 及 docs/migrations/seo-url-rules/README.md。

主要能力

页面元数据(SeoMeta)

通过 @/components/seo-meta 引入 SeoMeta 组件,支持以下属性(依据 src/components/seo-meta/index.tsx):title、rawTitle、description、noIndex、siteName、twitter、openGraph。

  • 常规用法:<SeoMeta title={...} description={...} />
  • 私有或交易类页面使用 noIndex,例如购物车、结账、账户等非公开页面。
  • rawTitle 用于不附加“ | Site Name”后缀的场景,例如门店名称。
  • openGraph 可传入 type、url、image 等;未单独设置 twitter 时,Open Graph 输入会自动派生 X 卡片标签。

根级 canonical 与 hreflang 描述符来自 src/utils/seo.ts 和 src/utils/canonical-url.ts,路由本身不添加这些描述符。

结构化数据(JsonLd)

通过 @/components/json-ld 引入 JsonLd 组件,以 data 传入 schema、以 id 标识、以 nonce 传入 CSP nonce,确保内联脚本被允许执行。构建器位于 src/utils/product-schema.ts、category-schema.ts、schema-url.ts。PDP 输出 Product,PLP 输出 CollectionPage + ItemList(详见 docs/README-AEO-GEO.md)。

统一 URL

Canonical <link>、og:url 与 JSON-LD 中的 url 必须保持一致。在 loader 中使用:

  • redirectToCanonicalPath(requestUrl):对结尾斜杠执行 301 跳转。
  • buildSeoPageUrl(context, requestUrl):生成 origin 加规范化路径与查询参数。

仅白名单查询参数会保留在 canonical 中(src/utils/canonical-url.ts 中的 CONTENT_PARAMS,默认包括 q、offset、sort、refine、pid)。只有会改变主页面内容的参数才应加入,并在 canonical-url.test.ts 旁补充测试。

可配置 URL(url.seoRoutes)

在 config.server.ts 中配置 url.prefix 与 seoRoutes,可为各站点指定 product、category 等前缀及模式(如 id-suffix)。关键规则:

  • 构建期生效:修改 seoRoutes 需重新构建并部署,本地需重启开发服务器。
  • 每个启用的站点都必须有对应条目,否则 URL 生成会抛错或构建失败。
  • Business Manager 中的 URL 设置是事实来源,seoRoutes 是需手动同步的副本。
  • 不要重命名路由文件;路由本身是通用的,由配置映射前缀。

链接应使用语义化构建器而非硬编码 /product/... 字符串,例如 createProductUrl、createCategoryUrl(来自 @/route-paths),配合 useSeoUrlContext 获取上下文。config 中的 seoFallback.sites 提供 SEO URL 无法解析时的按站点回退行为。

多域名与基础路径

Canonical 的 origin 来自 getAppOrigin:优先采用转发主机,回退到 EXTERNAL_DOMAIN_NAME。每个自定义域名需挂载到 Managed Runtime 环境。域名到站点的映射依赖 CDN 设置的 X-Site-Id 请求头。基础路径(MRT_ENV_BASE_PATH,由推送配置设置)会为资源与路由 URL 加前缀,应使用 getBasePath() 而非硬编码。

爬虫渲染

爬虫获得完整 HTML 渲染;分类页通过 ?page=N 参数保持可抓取,并提供 rel prev/next 链接,而 canonical 仍为基础分类 URL。可用 curl 搭配爬虫 user agent 验证。修改流式渲染行为前,应先阅读 docs/README-SEO.md 的“Crawler Rendering and Pagination”一节。

使用方式

该技能以项目内文档与代码路径为参照,指导在 Storefront Next 代码库中完成上述配置与组件调用。具体安装方式、独立命令及版本信息暂未提供。

适用场景

适用于使用 Storefront Next 构建的电商店面在 SEO、AEO/GEO 方面的开发工作,包括元数据管理、结构化数据输出、URL 规范化、多站点与多域名路由配置,以及面向爬虫的渲染与分页处理。

限制

资料未提供独立的运行服务、命令行工具、收费模式或平台支持范围;相关配置均依赖 Storefront Next 项目本身及其文档、代码路径。具体行为以对应源码与文档为准。