关于 ecommerce-seo
ecommerce-seo 是面向电商团队的 SEO 技能,指导优化商品页面的元数据、结构化数据和规范网址,并涵盖站点地图及技术检查。
主要功能
- 01检查平台内置 SEO 能力
- 02优化商品标题与描述
- 03配置 JSON-LD 结构化数据
- 04处理规范网址与索引规则
- 05验证搜索结果和页面性能
适用场景
- 01提升商品页的自然搜索表现
- 02为商品添加价格与库存结构化数据
- 03处理多变体商品的规范网址
- 04排查商品未显示在富媒体搜索结果中的原因
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ finsilabs/ awesome-ecommerce-skills --skill ecommerce-seo安装后在 Claude Code 中输入/ecommerce-seo确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
tile.jsonevals/canonical-urls-and-crawl-directives/criteria.jsontask.mdevals/product-json-ld-structured-data/criteria.jsontask.mdevals/xml-sitemap-generation/criteria.jsontask.md详细介绍
电商 SEO
概述
电商 SEO 涵盖了帮助搜索引擎理解并为产品页面排名的技术与内容基础:元标签、结构化数据(JSON-LD)、规范 URL、XML 站点地图和 Core Web Vitals。Shopify 和 WooCommerce 会自动处理大部分技术 SEO;你应把精力放在优化标题、描述和结构化数据质量上,而不是处理底层配置。
何时使用此技能
- 构建需要在 Google 购物和自然搜索中获得排名的产品页面时
- 为富媒体摘要(价格、库存情况、评价)实现 JSON-LD 结构化数据时
- 处理具有多个变体或筛选组合的产品规范 URL 时
- 为大型商品目录(10K+ 产品)生成 XML 站点地图时
- 排查产品未出现在 Google 购物富媒体搜索结果中的原因时
核心说明
第 1 步:检查你的平台会自动处理哪些内容
安装任何工具之前,先了解已有的内置功能:
| 功能 | Shopify | WooCommerce | BigCommerce |
|---|---|---|---|
| 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 和基础架构。重点如下:
- 安装 SEO 应用,以增强结构化数据和批量编辑功能:
- Yoast SEO for Shopify($19/mo)— 功能最全面
- Schema Plus(免费套餐)— 专注于 JSON-LD 结构化数据
- SEO Manager($20/mo)— 批量编辑元信息 + 结构化数据
- 前往 Shopify Admin → Online Store → Preferences 并确认:
- 已设置首页标题和元描述
- 已连接 Google Analytics
- 在管理后台打开每个产品页面,并填写底部的 SEO 部分:
- 按照以下格式编写独特的元标题:
[Brand] [Product Name] - [Key Attribute] | [Store Name] - 编写 150–160 个字符的独特元描述,其中包含价格范围、主要优势和行动号召
- 按照以下格式编写独特的元标题:
- 将站点地图提交到 Google Search Console:前往 search.google.com/search-console → Sitemaps → 添加
yourstore.com/sitemap.xml
WooCommerce
- 从 WordPress 插件目录安装 Yoast SEO(免费)或 Rank Math(免费)——正确优化 WooCommerce SEO 必须使用这些工具
- 安装 Yoast SEO 后:
- 前往 Yoast SEO → Search Appearance → WooCommerce,配置产品页面模板
- 在 Yoast SEO → Search Appearance → Schema 下启用 JSON-LD 结构化数据
- 前往 Yoast SEO → Tools → Bulk Editor,一次性编辑所有产品的元标题和描述
- 如需增强产品架构(价格、库存情况、评价):
- 安装 Rank Math,它内置了 WooCommerce 产品架构及评价聚合功能
- 将站点地图提交到 Google Search Console:Yoast 会自动生成
/sitemap_index.xml
BigCommerce
- BigCommerce 内置基础 SEO 功能。前往 BigCommerce Admin → Products → [Edit Product] → SEO 标签页
- 如需增强结构化数据:从 BigCommerce App Marketplace 安装 SEO Expert
- 前往 Store Setup → Search Engine Optimization 配置全局默认设置
- 将站点地图
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 工具进行验证
- Google 富媒体搜索结果测试(search.google.com/test/rich-results):粘贴任意商品 URL,验证结构化数据是否正确
- Google Search Console:在 增强功能 → 商品 下检查结构化数据错误
- 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 → 增强功能 → 商品中检查结构化数据错误;使用富媒体搜索结果测试进行验证 |
| 分面导航生成数百万个可编入索引的 URL | Shopify/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