seo-ecommerce

电商 SEO 分析

共享数据缓存

步骤 0 -- 检查共享数据缓存：

开始收集前，检查 .seo-cache/ 中是否有可复用的相关 SEO 技能上下文。 参考：../seo/references/shared-data-cache.md，了解架构和依赖关系图。

如果存在，请检查以下缓存文件：

• .seo-cache/site-meta.json，查看域名、业务类型、行业和抓取上下文

• .seo-cache/audit-scores.json，查看此前完整审计的优先事项

• .seo-cache/pages/{url-slug}/page-analysis.json，如果提供了 URL，查看页面级上下文

• 如果找到：解析并使用明确有效的字段（注明“使用了 [date] 的缓存 [X]”）

• 如果缺失、损坏或不相关：继续收集新证据

• 如果用户说“refresh”或“re-run”：忽略缓存读取，并在写入时覆盖

全面的产品页面优化、市场情报和 竞争性定价分析。可独立运行（页面内 + 架构），也可使用 DataForSEO Merchant API 获取实时 Google Shopping 和 Amazon 数据。

命令

命令	用途	是否需要 DataForSEO？
/seo ecommerce <url>	对产品页面或商店进行完整电商 SEO 分析	可选
/seo ecommerce products <keyword>	Google Shopping 竞争分析	必需
/seo ecommerce gaps <domain>	关键词差距：自然搜索与 Shopping 可见度对比	必需
/seo ecommerce schema <url>	产品架构验证与增强	否

---

1. 产品页面分析（无需 DataForSEO）

抓取并解析任意产品页面，评估页面内 SEO 质量。

工作流

1. python scripts/fetch_page.py <url>         → raw HTML
2. python scripts/parse_html.py --url <url>   → SEO elements
3. Analyze product-specific signals (below)

产品 SEO 检查清单

标题标签

• 包含主要产品关键词
• 包含品牌名称
• 少于 60 个字符（在 SERP 中不会被截断）
• 格式：[Product Name] - [Key Feature] | [Brand]

Meta 描述

• 包含产品关键词 + 优势
• 包含价格或“起价 $XX”（可提高富媒体摘要的吸引力）
• 包含行动号召（立即选购、购买、免费配送）
• 少于 155 个字符

标题结构

• 使用一个与主要产品名称相符的 H1
• 使用 H2 作为以下内容的标题：特色、规格、评价、相关产品
• 不同产品变体之间没有重复的 H1 标签

产品图片

• 替代文本包含产品名称 + 区别性特征
• 文件名具有描述性（而不是 IMG_001.jpg）
• 使用 WebP 格式（并提供 JPEG 回退格式）
• 每个产品至少有 3 张图片（主图、细节图、生活方式图）
• 图片尺寸 >= 800px，符合 Google Shopping 展示资格
• 仅对首屏以下的图片启用延迟加载

内部链接

• 面包屑导航：主页 > 类别 > 子类别 > 产品
• 相关产品版块（交叉销售 / 向上销售）
• 使用包含丰富关键词的锚文本链接回类别页面
• 评价版块链接到完整评价页面（如果单独设置）

内容质量

• 产品描述独特（不是直接复制制造商文案）
• 产品描述正文不少于 200 字
• 提供规格表（而不仅是文字说明）
• 页面上展示用户评价（UGC 信号）

评分

类别	权重	标准
架构完整性	25%	必需及推荐的 Product 字段
标题与 meta	15%	关键词位置、长度、格式
图片优化	20%	替代文本、格式、尺寸、数量
内容质量	20%	独特描述、规格、评价
内部链接	10%	面包屑、相关产品、类别
技术	10%	页面速度、移动端渲染、规范链接

---

2. Google Shopping 情报（DataForSEO Merchant API）

基于 Google Shopping 搜索结果的实时竞争分析。

成本防护（必须执行）

每次调用 Merchant API 前：

python scripts/dataforseo_costs.py check merchant_google_products_search

• "status": "approved" -- 继续
• "status": "needs_approval" -- 显示费用并征求用户同意
• "status": "blocked" -- 停止并告知用户

每次调用后：

python scripts/dataforseo_costs.py log merchant_google_products_search <cost>

工作流

# Product search: who sells what at what price
python scripts/dataforseo_merchant.py search "<keyword>" --marketplace google

# Seller analysis: merchant ratings and dominance
python scripts/dataforseo_merchant.py sellers "<keyword>"

# Normalize results for analysis
python scripts/dataforseo_normalize.py results.json --module merchant

分析输出

定价情报

• 价格分布：最低价、最高价、中位数、P25、P75
• 价格异常值（与中位数相差超过 2 个标准差）
• 价格与评分的相关性
• 将货币统一换算为 USD（或用户指定的货币）

卖家概况

• 按商品刊登数量排名的前 10 名卖家
• 商家评分分布
• 免运费的普及程度
• 新卖家与老牌卖家

商品刊登质量

• 热门商品刊登标题中的关键词模式
• 平均评分和评论数基准
• 每个商品刊登的图片数量
• 库存状态分布

加载 references/marketplace-endpoints.md，查看完整的 API 参数详情。

---

3. Amazon Marketplace（DataForSEO）

比较 Google Shopping 和 Amazon 的跨市场情报。

成本限制（强制）

python scripts/dataforseo_costs.py check merchant_amazon_products_search

Amazon 端点位于 warn_endpoints 集合中，始终需要用户批准。

工作流

# Amazon product search
python scripts/dataforseo_merchant.py search "<keyword>" --marketplace amazon

# Cross-marketplace comparison
python scripts/dataforseo_merchant.py compare "<keyword>"

跨市场报告

指标	Google Shopping	Amazon
平均价格	$	$
中位评分	X.X	X.X
平均评论数	N	N
头部卖家份额	%	%
免运费比例	%	%

---

4. 市场关键词差距

找出自然搜索可见度与 Shopping 可见度之间的不一致。

工作流

1. 通过 seo-dataforseo 获取自然搜索排名： 针对域名使用 dataforseo_labs_google_ranked_keywords
2. 通过 Merchant API 获取 Google Shopping 曝光情况： 针对排名靠前的自然搜索关键词使用 merchant_google_products_search
3. 交叉比对结果

差距类型

差距类型	含义	操作
仅自然搜索	自然搜索排名靠前，但没有 Shopping 广告	创建 Google Merchant Center Feed，并对这些关键词出价
仅 Shopping	有 Shopping 曝光，但自然搜索表现较弱或没有排名	针对这些关键词创建内容（购买指南、对比页面）
两者均有	在两个渠道中都有曝光	优化：确保价格一致，并完善 Schema
两者均无	两者均无曝光	优先级较低，除非搜索量很高

输出格式

## Keyword Gap Analysis: example.com

### Opportunities: Organic → Shopping (12 keywords)
| Keyword | Organic Pos | Volume | CPC | Recommended Action |
|---------|------------|--------|-----|-------------------|

### Opportunities: Shopping → Organic (8 keywords)
| Keyword | Shopping Rank | Volume | CPC | Content Type Needed |
|---------|-------------|--------|-----|-------------------|

---

5. 商品 Schema 增强

根据 Google 当前要求验证并生成 Product Schema。

必需属性（Google Merchant）

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "",
  "image": [""],
  "description": "",
  "brand": { "@type": "Brand", "name": "" },
  "offers": {
    "@type": "Offer",
    "url": "",
    "priceCurrency": "USD",
    "price": "0.00",
    "availability": "https://schema.org/InStock",
    "seller": { "@type": "Organization", "name": "" }
  }
}

推荐属性（增强富媒体搜索结果）

• sku —— 商品标识符
• gtin13 / gtin14 / mpn —— 全球贸易商品标识符
• aggregateRating —— 星级评分和评论数
• review —— 单条评论（至少 1 条）
• color、material、size —— 变体属性
• shippingDetails —— 包含运费和配送时间的 ShippingDetails
• hasMerchantReturnPolicy —— 包含退货类型和期限的 MerchantReturnPolicy

验证规则

1. price 必须是数字字符串，不能是 "$29.99"（不得包含货币符号）
2. availability 必须使用完整的 Schema.org URL 枚举值
3. image 应为数组，且至少包含 1 个高分辨率图片 URL
4. priceCurrency 必须符合 ISO 4217（USD、EUR、GBP）
5. brand.name 不能为空，也不能是 "N/A"
6. priceValidUntil 中的日期必须符合 ISO 8601
7. 如果存在 aggregateRating：必须包含 ratingValue 和 reviewCount

Schema 评分

完整度	评分
所有必需字段	50/100
+ aggregateRating	65/100
+ sku/gtin/mpn	75/100
+ shippingDetails	85/100
+ merchantReturnPolicy	90/100
+ 评论（3 条以上）	100/100

---

跨技能集成

技能	集成点
seo-schema	委托生成 Product Schema；复用验证逻辑
seo-images	商品图片审计（替代文本、格式、尺寸）
seo-content	商品描述的 E-E-A-T 和独特性分析
seo-dataforseo	用于差距分析的自然搜索关键词排名
seo-technical	商品页面的 Core Web Vitals（主图的 LCP）
seo-google	通过 GSC 验证 Google Merchant Center Feed

---

错误处理

错误	原因	响应
未找到 Product 架构	页面缺少 JSON-LD	分析页面内容，生成推荐架构
缺少 DataForSEO 凭据	未设置环境变量	不使用市场数据运行分析，并注明限制
成本检查未通过	超出每日预算	告知用户，并提供仅使用免费数据的分析选项
Shopping 结果为空	没有与关键词匹配的产品	建议使用更宽泛的关键词，并检查位置设置
Amazon API 超时	网络问题／速率限制	采用退避策略重试，失败时改用仅 Google 的方案
URL 无效	输入格式错误	使用 google_auth.validate_url() 验证，并显示错误
非产品页面	URL 指向分类页／首页	检测页面类型，并建议改用 /seo ecommerce schema

---

输出模板

## E-commerce SEO Report: [URL or Keyword]

### Overall Score: XX/100

### Product Page SEO
- Schema Completeness: XX/100
- Title & Meta: XX/100
- Image Optimization: XX/100
- Content Quality: XX/100
- Internal Linking: XX/100

### Marketplace Intelligence (if DataForSEO available)
- Google Shopping Listings: N products found
- Price Range: $XX - $XX (median: $XX)
- Top Seller: [name] (XX% market share)
- Amazon Comparison: [available/not checked]

### Top Recommendations
1. [Critical] ...
2. [High] ...
3. [Medium] ...

Generate a PDF report? Use `/seo google report`

写入共享数据缓存

完成所有工作后，如果工作流产生了持久性发现，请将简洁的 JSON 摘要写入 .seo-cache/。 遵循 ../seo/references/shared-data-cache.md 中的架构和命名规则；至少包含 cache_type、analyzed_at、来源 URL／域名、关键发现、问题、建议和工具限制。如果 .gitignore 中缺少 .seo-cache/，请将其添加进去。