mcpField
E
ecommerce-seo

ecommerce-seo

github.com/finsilabs营销与增长60173 次安装5 天前更新
代码仓库

关于 ecommerce-seo

ecommerce-seo 是面向电商团队的 SEO 技能,指导优化商品页面的元数据、结构化数据和规范网址,并涵盖站点地图及技术检查。

主要功能

  1. 01检查平台内置 SEO 能力
  2. 02优化商品标题与描述
  3. 03配置 JSON-LD 结构化数据
  4. 04处理规范网址与索引规则
  5. 05验证搜索结果和页面性能

适用场景

  1. 01提升商品页的自然搜索表现
  2. 02为商品添加价格与库存结构化数据
  3. 03处理多变体商品的规范网址
  4. 04排查商品未显示在富媒体搜索结果中的原因

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/finsilabs/awesome-ecommerce-skills --skill ecommerce-seo

安装后在 Claude Code 中输入/ecommerce-seo确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

tile.json
evals/canonical-urls-and-crawl-directives/
criteria.json
task.md
evals/product-json-ld-structured-data/
criteria.json
task.md
evals/xml-sitemap-generation/
criteria.json
task.md

详细介绍

电商 SEO

概述

电商 SEO 涵盖了帮助搜索引擎理解并为产品页面排名的技术与内容基础:元标签、结构化数据(JSON-LD)、规范 URL、XML 站点地图和 Core Web Vitals。Shopify 和 WooCommerce 会自动处理大部分技术 SEO;你应把精力放在优化标题、描述和结构化数据质量上,而不是处理底层配置。

何时使用此技能

  • 构建需要在 Google 购物和自然搜索中获得排名的产品页面时
  • 为富媒体摘要(价格、库存情况、评价)实现 JSON-LD 结构化数据时
  • 处理具有多个变体或筛选组合的产品规范 URL 时
  • 为大型商品目录(10K+ 产品)生成 XML 站点地图时
  • 排查产品未出现在 Google 购物富媒体搜索结果中的原因时

核心说明

第 1 步:检查你的平台会自动处理哪些内容

安装任何工具之前,先了解已有的内置功能:

功能ShopifyWooCommerceBigCommerce
XML 站点地图自动生成于 /sitemap.xml自动生成于 /sitemap_index.xml(搭配 Yoast SEO)自动生成于 /xmlsitemap.xml
规范 URL支持(内置)支持(搭配 Yoast SEO)支持(内置)
元标题/描述编辑支持(通过产品编辑器)支持(通过 Yoast SEO 字段)支持(通过产品编辑器)
JSON-LD 产品架构基础功能(因主题而异)需要 WooCommerce + Yoast 或 Rank Math基础功能(因主题而异)
robots.txt可在 Online Store 设置中编辑可通过文件或 Yoast 编辑可通过管理后台编辑
第 2 步:安装 SEO 基础工具

Shopify

Shopify 会自动处理站点地图、规范 URL 和基础架构。重点如下:

  1. 安装 SEO 应用,以增强结构化数据和批量编辑功能:
    • Yoast SEO for Shopify($19/mo)— 功能最全面
    • Schema Plus(免费套餐)— 专注于 JSON-LD 结构化数据
    • SEO Manager($20/mo)— 批量编辑元信息 + 结构化数据
  2. 前往 Shopify Admin → Online Store → Preferences 并确认:
    • 已设置首页标题和元描述
    • 已连接 Google Analytics
  3. 在管理后台打开每个产品页面,并填写底部的 SEO 部分:
    • 按照以下格式编写独特的元标题:[Brand] [Product Name] - [Key Attribute] | [Store Name]
    • 编写 150–160 个字符的独特元描述,其中包含价格范围、主要优势和行动号召
  4. 将站点地图提交到 Google Search Console:前往 search.google.com/search-console → Sitemaps → 添加 yourstore.com/sitemap.xml

WooCommerce
  1. 从 WordPress 插件目录安装 Yoast SEO(免费)或 Rank Math(免费)——正确优化 WooCommerce SEO 必须使用这些工具
  2. 安装 Yoast SEO 后:
    • 前往 Yoast SEO → Search Appearance → WooCommerce,配置产品页面模板
    • 在 Yoast SEO → Search Appearance → Schema 下启用 JSON-LD 结构化数据
    • 前往 Yoast SEO → Tools → Bulk Editor,一次性编辑所有产品的元标题和描述
  3. 如需增强产品架构(价格、库存情况、评价):
    • 安装 Rank Math,它内置了 WooCommerce 产品架构及评价聚合功能
  4. 将站点地图提交到 Google Search Console:Yoast 会自动生成 /sitemap_index.xml

BigCommerce
  1. BigCommerce 内置基础 SEO 功能。前往 BigCommerce Admin → Products → [Edit Product] → SEO 标签页
  2. 如需增强结构化数据:从 BigCommerce App Marketplace 安装 SEO Expert
  3. 前往 Store Setup → Search Engine Optimization 配置全局默认设置
  4. 将站点地图 yourstore.com/xmlsitemap.xml 提交到 Google Search Console

自定义 / 无头架构

对于无头店面,请手动实现结构化数据。在每个商品页面上提供 JSON-LD:

function buildProductJsonLd(product: Product, reviews: ReviewSummary) {
  return {
    '@context': 'https://schema.org',
    '@type': 'Product',
    name: product.title,
    image: product.images.map(img => img.src),
    description: product.metaDescription || product.description.slice(0, 200),
    sku: product.variants[0]?.sku,
    brand: { '@type': 'Brand', name: product.vendor },
    offers: product.variants.length === 1
      ? {
          '@type': 'Offer',
          url: `https://yourstore.com/products/${product.slug}`,
          priceCurrency: 'USD',
          price: (product.variants[0].priceInCents / 100).toFixed(2),
          availability: product.variants[0].inventoryQuantity > 0
            ? 'https://schema.org/InStock'
            : 'https://schema.org/OutOfStock',
        }
      : {
          '@type': 'AggregateOffer',
          lowPrice: (Math.min(...product.variants.map(v => v.priceInCents)) / 100).toFixed(2),
          highPrice: (Math.max(...product.variants.map(v => v.priceInCents)) / 100).toFixed(2),
          priceCurrency: 'USD',
          offerCount: product.variants.length,
        },
    ...(reviews.count > 0 ? {
      aggregateRating: {
        '@type': 'AggregateRating',
        ratingValue: reviews.average.toFixed(1),
        reviewCount: reviews.count,
        bestRating: '5',
      },
    } : {}),
  };
}

对于变体页面的规范 URL 处理,请移除变体参数:

// Always use the base product URL as canonical
// /products/blue-widget?variant=123 → canonical: /products/blue-widget
function getCanonicalUrl(path: string): string {
  // Strip variant query parameters
  return `https://yourstore.com${path.split('?')[0]}`;
}

对于大型商品目录(10k+ 件商品),请使用站点地图索引:

// Serve /sitemap.xml as a sitemap index pointing to paginated product sitemaps
// Each child sitemap: max 50,000 URLs
// Regenerate every 6 hours or on product publish/unpublish events
第 3 步:优化商品标题和描述

这是 SEO 工作中投资回报率最高的一项。请遵循以下标题格式:

  • 商品标题格式:[Brand] [Product Name] [Key Attribute] - [Store Name]
    • 示例:“Nike Air Max 90 White - Running Store”
  • 元描述格式:在 150–160 个字符内包含价格范围、核心优势和行动号召
    • 示例:“选购 Nike Air Max 90,售价 120 美元起。轻量缓震,适合日常跑步。订单满 75 美元免运费。立即选购。”

常见问题及修复方法:

  • 不同变体的元标题重复(修复方法:在标题中添加特定于变体的属性)
  • 元描述只是截断后的商品描述(修复方法:撰写有明确目的的描述)
  • 商品图片缺少替代文本(修复方法:使用 [Product Name] - [Color/View] 格式)
第 4 步:处理技术 SEO 问题

筛选页面的规范 URL:

  • 启用了筛选条件的系列页面(/collections/shoes?color=red)应使用自引用规范 URL
  • 只有排序条件的页面(/collections/shoes?sort=price-asc)应将规范 URL 指向未筛选的系列 URL

在 Shopify 中,此操作会自动处理。在 WooCommerce 中使用 Yoast 时,请前往 Yoast SEO → 搜索外观 → 分类法,配置筛选页面的规范 URL 行为。

Robots.txt — 屏蔽以下路径:

  • /cart 和 /checkout — 不可编入索引
  • /account 和 /search? — 不可编入索引
  • 启用了 3 个或更多筛选条件的系列筛选组合 — 使用 noindex, follow 元标签

在 Shopify 中:在线商店 → 模板 → 编辑代码 → robots.txt.liquid 在 WooCommerce 中:Yoast SEO 会自动管理 robots.txt

第 5 步:使用 Google 工具进行验证
  1. Google 富媒体搜索结果测试(search.google.com/test/rich-results):粘贴任意商品 URL,验证结构化数据是否正确
  2. Google Search Console:在 增强功能 → 商品 下检查结构化数据错误
  3. PageSpeed Insights:测试 Core Web Vitals — 目标是 LCP 低于 2.5 秒、CLS 低于 0.1

最佳实践

  • 为每件商品撰写独特的元描述 — 避免重复商品标题;加入尺寸、材质、价格等有助于提高点击率的核心属性
  • 压缩商品图片并设置合适的尺寸 — 图片过大会导致 LCP 得分变差;Shopify 会自动压缩;WooCommerce 用户可使用 ShortPixel 或 Imagify 插件
  • 优先使用 JSON-LD,而非微数据 — 更易于维护,且 Google 推荐使用
  • 为每个页面设置规范 URL — 自引用规范 URL 可防止 URL 参数造成重复内容
  • 自动更新站点地图 — Shopify 和 WooCommerce + Yoast 会自动处理;对于自定义构建的网站,请在商品发布或取消发布时重新生成站点地图
  • 添加图片站点地图 — 添加带有描述性替代文本的商品图片,以获取 Google 图片搜索流量

常见陷阱

问题解决方案
商品未显示在 Google Shopping 富媒体搜索结果中在 Google Search Console → 增强功能 → 商品中检查结构化数据错误;使用富媒体搜索结果测试进行验证
分面导航生成数百万个可编入索引的 URLShopify/WooCommerce 会通过规范 URL 自动处理;对于自定义构建的网站,在筛选条件较多的页面上使用 noindex, follow
缺货商品返回 404保持页面在线并返回 200 状态;显示“缺货”并推荐替代商品;仅在商品永久停售时才将其从站点地图中移除
Schema.org 验证错误使用 Google 的富媒体搜索结果测试;确保价格和库存情况始终存在且格式正确
Core Web Vitals 较差,影响排名预加载主视觉图片、压缩商品图片、对首屏以下的内容使用延迟加载;Shopify 的 CDN 能显著改善性能

Related Skills

  • @google-shopping-feed
  • @google-ads-ecommerce
  • @content-commerce
  • @social-proof-widgets

评论

支持 Markdown