seo-ecommerce

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

E-commerce SEO Analysis

电商SEO分析

Comprehensive product page optimization, marketplace intelligence, and competitive pricing analysis. Works standalone (on-page + schema) and with DataForSEO Merchant API for live Google Shopping and Amazon data.

全面的产品页面优化、平台情报及竞品价格分析。可独立运行（页面内优化+Schema），也可结合DataForSEO Merchant API获取Google Shopping和亚马逊的实时数据。

Commands

命令

Command	Purpose	DataForSEO?
`/seo ecommerce <url>`	Full e-commerce SEO analysis of a product page or store	Optional
`/seo ecommerce products <keyword>`	Google Shopping competitive analysis	Required
`/seo ecommerce gaps <domain>`	Keyword gap: organic vs Shopping visibility	Required
`/seo ecommerce schema <url>`	Product schema validation and enhancement	No

命令	用途	是否需要DataForSEO？
`/seo ecommerce <url>`	对产品页面或店铺进行全面电商SEO分析	可选
`/seo ecommerce products <keyword>`	Google Shopping竞品分析	必填
`/seo ecommerce gaps <domain>`	关键词差距：自然搜索与Shopping曝光对比	必填
`/seo ecommerce schema <url>`	产品Schema验证与优化	不需要

1. Product Page Analysis (No DataForSEO Needed)

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

Fetch and parse any product page for on-page SEO quality.

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

Workflow

工作流程

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)

1. python scripts/fetch_page.py <url>         → 原始HTML
2. python scripts/parse_html.py --url <url>   → SEO元素提取
3. 分析产品特定信号（如下所示）

Product SEO Checklist

产品SEO检查清单

Title Tag

标题标签

Contains primary product keyword
Includes brand name
Under 60 characters (no truncation in SERPs)

Format:

[Product Name] - [Key Feature] | [Brand]

包含核心产品关键词
包含品牌名称
长度不超过60字符（在搜索结果中不被截断）

格式：

[产品名称] - [核心卖点] | [品牌]

Meta Description

元描述

Contains product keyword + benefit
Includes price or "from $XX" (triggers rich snippet interest)
Call-to-action present (Shop now, Buy, Free shipping)
Under 155 characters

包含产品关键词及核心优势
包含价格或“低至XX美元”（提升富媒体片段吸引力）
包含行动号召（立即购买、选购、免运费）
长度不超过155字符

Heading Structure

标题层级结构

Single H1 matching primary product name
H2s for: Features, Specifications, Reviews, Related Products
No duplicate H1 tags across product variants

仅有一个与核心产品名称匹配的H1标签
使用H2标签标注：功能、规格、评论、相关产品
不同产品变体间无重复H1标签

Product Images

产品图片

Alt text includes product name + distinguishing feature
File names are descriptive (not
```
IMG_001.jpg
```
)
WebP format served (with JPEG fallback)
At least 3 images per product (hero, detail, lifestyle)
Image dimensions >= 800px for Google Shopping eligibility
Lazy loading on below-fold images only

Alt文本包含产品名称及差异化特征
文件名具有描述性（而非
```
IMG_001.jpg
```
）
采用WebP格式（同时提供JPEG降级方案）
每个产品至少包含3张图片（主图、细节图、场景图）
图片尺寸≥800px（满足Google Shopping准入要求）
仅对首屏下方图片启用懒加载

Internal Linking

内部链接

Breadcrumb navigation: Home > Category > Subcategory > Product
Related products section (cross-sell / upsell)
Link back to category page with keyword-rich anchor
Reviews section links to full review page (if separate)

面包屑导航：首页 > 分类 > 子分类 > 产品
相关产品板块（交叉销售/向上销售）
以含关键词的锚文本链接回分类页面
评论板块链接至独立评论页面（若存在）

Content Quality

内容质量

Unique product description (not manufacturer copy-paste)
Word count >= 200 for product description body
Specs table present (not just prose)
User reviews on-page (UGC signals)

产品描述原创（非直接复制制造商内容）
产品描述正文字数≥200字
包含规格表格（而非纯文字描述）
页面包含用户评论（用户生成内容信号）

Scoring

评分规则

Category	Weight	Criteria
Schema completeness	25%	Required + recommended Product fields
Title & meta	15%	Keyword placement, length, format
Image optimization	20%	Alt text, format, sizing, count
Content quality	20%	Unique description, specs, reviews
Internal linking	10%	Breadcrumbs, related products, categories
Technical	10%	Page speed, mobile rendering, canonical

类别	权重	评分标准
Schema完整性	25%	必填及推荐的Product字段覆盖情况
标题与元数据	15%	关键词布局、长度、格式
图片优化	20%	Alt文本、格式、尺寸、数量
内容质量	20%	原创描述、规格、评论
内部链接	10%	面包屑、相关产品、分类链接
技术指标	10%	页面速度、移动端渲染、规范URL

2. Google Shopping Intelligence (DataForSEO Merchant API)

2. Google Shopping情报分析（DataForSEO Merchant API）

Live competitive analysis from Google Shopping results.

基于Google Shopping结果的实时竞品分析。

Cost Guardrail (MANDATORY)

成本管控（强制要求）

Before EVERY Merchant API call:

bash

python scripts/dataforseo_costs.py check merchant_google_products_search

```
"status": "approved"
```
-- proceed
```
"status": "needs_approval"
```
-- show cost, ask user
```
"status": "blocked"
```
-- stop, inform user

After each call:

bash

python scripts/dataforseo_costs.py log merchant_google_products_search <cost>

每次调用Merchant API前必须执行：

bash

python scripts/dataforseo_costs.py check merchant_google_products_search

```
"status": "approved"
```
-- 继续执行
```
"status": "needs_approval"
```
-- 展示成本，询问用户
```
"status": "blocked"
```
-- 终止操作，告知用户

每次调用后执行：

bash

python scripts/dataforseo_costs.py log merchant_google_products_search <cost>

Workflow

工作流程

bash

undefined

bash

undefined

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

undefined

python scripts/dataforseo_normalize.py results.json --module merchant

undefined

Analysis Outputs

分析输出

Pricing Intelligence

价格情报

Price distribution: min, max, median, P25, P75
Price outliers (> 2 standard deviations from median)
Price-to-rating correlation
Currency normalization to USD (or user-specified)

价格分布：最小值、最大值、中位数、25分位数、75分位数
价格异常值（超出中位数2个标准差）
价格与评分相关性
货币统一转换为美元（或用户指定币种）

Seller Landscape

卖家格局

Top 10 sellers by listing count
Merchant rating distribution
Free shipping prevalence
New vs established sellers

按列表数量排名前10的卖家
商家评分分布
免运费比例
新卖家与老牌卖家占比

Product Listing Quality

产品列表质量

Title keyword patterns in top listings
Average rating and review count benchmarks
Image count per listing
Availability status distribution

Load

references/marketplace-endpoints.md

for full API parameter details.

头部列表的标题关键词模式
平均评分及评论数量基准
每个列表的图片数量
库存状态分布

查看

references/marketplace-endpoints.md

获取完整API参数详情。

3. Amazon Marketplace (DataForSEO)

3. 亚马逊平台分析（DataForSEO）

Cross-marketplace intelligence comparing Google Shopping and Amazon.

对比Google Shopping与亚马逊的跨平台情报。

Cost Guardrail (MANDATORY)

成本管控（强制要求）

bash

python scripts/dataforseo_costs.py check merchant_amazon_products_search

Amazon endpoints are in the

warn_endpoints

set -- always requires user approval.

bash

python scripts/dataforseo_costs.py check merchant_amazon_products_search

亚马逊端点属于

warn_endpoints

集合 -- 始终需要用户确认。

Workflow

工作流程

bash

undefined

bash

undefined

Amazon product search

亚马逊产品搜索

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

Cross-marketplace comparison

跨平台对比

python scripts/dataforseo_merchant.py compare "<keyword>"

undefined

python scripts/dataforseo_merchant.py compare "<keyword>"

undefined

Cross-Marketplace Report

跨平台对比报告

Metric	Google Shopping	Amazon
Avg price	$	$
Median rating	X.X	X.X
Avg review count	N	N
Top seller share	%	%
Free shipping %	%	%

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

4. Marketplace Keyword Gaps

4. 平台关键词差距分析

Identify mismatches between organic and Shopping visibility.

识别自然搜索与Shopping曝光之间的不匹配情况。

Workflow

工作流程

Fetch organic rankings via seo-dataforseo:
```
dataforseo_labs_google_ranked_keywords
```
for domain
Fetch Google Shopping presence via Merchant API:
```
merchant_google_products_search
```
for top organic keywords
Cross-reference results

通过seo-dataforseo获取自然搜索排名：针对域名调用
```
dataforseo_labs_google_ranked_keywords
```
通过Merchant API获取Google Shopping曝光情况：针对头部自然搜索关键词调用
```
merchant_google_products_search
```
交叉比对结果

Gap Types

差距类型

Gap Type	Meaning	Action
Organic Only	Ranks organically but no Shopping ads	Create Google Merchant Center feed, bid on these keywords
Shopping Only	Shopping visibility but weak/no organic	Create content (buying guides, comparison pages) for these keywords
Both Present	Visible in both channels	Optimize: ensure price consistency, enhance schema
Neither	No visibility in either	Low priority unless high volume

差距类型	含义	行动建议
仅自然搜索	自然搜索排名靠前但无Shopping广告	创建谷歌商家中心商品源，针对这些关键词出价
仅Shopping	有Shopping曝光但自然搜索表现薄弱/无排名	针对这些关键词创建内容（购买指南、对比页面）
两者皆有	在两个渠道均有曝光	优化：确保价格一致，增强Schema
两者皆无	在两个渠道均无曝光	低优先级，除非关键词流量极高

Output Format

输出格式

undefined

undefined

Keyword Gap Analysis: example.com

关键词差距分析：example.com

Opportunities: Organic → Shopping (12 keywords)

机会：自然搜索 → Shopping（12个关键词）

Keyword	Organic Pos	Volume	CPC	Recommended Action

关键词	自然搜索排名	流量	单次点击成本	建议行动

Opportunities: Shopping → Organic (8 keywords)

机会：Shopping → 自然搜索（8个关键词）

Keyword	Shopping Rank	Volume	CPC	Content Type Needed

---

关键词	Shopping排名	流量	单次点击成本	所需内容类型

---

5. Product Schema Enhancement

5. 产品Schema优化

Validate and generate Product schema following Google's current requirements.

按照谷歌当前要求验证并生成Product Schema。

Required Properties (Google Merchant)

必填属性（谷歌商家中心）

json

{
  "@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": "" }
  }
}

json

{
  "@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": "" }
  }
}

Recommended Properties (Enhance Rich Results)

Validation Rules

验证规则

```
price
```
must be a number string, not "$29.99" (no currency symbol)
```
availability
```
must use full Schema.org URL enum
```
image
```
should be array with >= 1 high-res image URL
```
priceCurrency
```
must be ISO 4217 (USD, EUR, GBP)
```
brand.name
```
must not be empty or "N/A"
Dates in
```
priceValidUntil
```
must be ISO 8601
If
```
aggregateRating
```
present:
```
ratingValue
```
and
```
reviewCount
```
required

```
price
```
必须为数字字符串，不可为"$29.99"（不含货币符号）
```
availability
```
必须使用完整的Schema.org URL枚举值
```
image
```
应为包含至少1个高清图片URL的数组
```
priceCurrency
```
必须为ISO 4217标准代码（如USD、EUR、GBP）
```
brand.name
```
不可为空或"N/A"
```
priceValidUntil
```
中的日期必须为ISO 8601格式
若存在
```
aggregateRating
```
，则必须包含
```
ratingValue
```
和
```
reviewCount
```

Schema Scoring

Schema评分

Completeness	Score
All required fields	50/100
+ aggregateRating	65/100
+ sku/gtin/mpn	75/100
+ shippingDetails	85/100
+ merchantReturnPolicy	90/100
+ reviews (3+)	100/100

完整度	得分
覆盖所有必填字段	50/100
+ 包含aggregateRating	65/100
+ 包含sku/gtin/mpn	75/100
+ 包含shippingDetails	85/100
+ 包含merchantReturnPolicy	90/100
+ 包含3条及以上评论	100/100

Cross-Skill Integration

跨技能集成

Skill	Integration Point
seo-schema	Delegates Product schema generation; reuses validation logic
seo-images	Product image audit (alt text, format, dimensions)
seo-content	Product description E-E-A-T and uniqueness analysis
seo-dataforseo	Organic keyword rankings for gap analysis
seo-technical	Core Web Vitals for product pages (LCP on hero image)
seo-google	Google Merchant Center feed validation via GSC

技能	集成点
seo-schema	委托生成Product Schema；复用验证逻辑
seo-images	产品图片审核（Alt文本、格式、尺寸）
seo-content	产品描述E-E-A-T及原创性分析
seo-dataforseo	用于差距分析的自然搜索关键词排名
seo-technical	产品页面核心Web指标（主图最大内容绘制LCP）
seo-google	通过GSC验证谷歌商家中心商品源

Error Handling

错误处理

Error	Cause	Response
No Product schema found	Page lacks JSON-LD	Analyze page content, generate recommended schema
DataForSEO credentials missing	Env vars not set	Run analysis without marketplace data, note limitation
Cost check blocked	Daily budget exceeded	Inform user, offer free-only analysis
Empty Shopping results	No products for keyword	Suggest broader keyword, check location settings
Amazon API timeout	Network/rate limit	Retry with backoff, fall back to Google-only
Invalid URL	Malformed input	Validate via `google_auth.validate_url()` , show error
Non-product page	URL is category/homepage	Detect page type, suggest `/seo ecommerce schema` instead

错误	原因	响应方式
未找到Product Schema	页面缺少JSON-LD	分析页面内容，生成推荐Schema
缺少DataForSEO凭证	环境变量未设置	不使用平台数据进行分析，并注明限制
成本检查被阻止	每日预算已超支	告知用户，提供免费分析选项
Shopping结果为空	关键词无对应产品	建议使用更宽泛的关键词，检查地区设置
Amazon API超时	网络/速率限制	退避重试， fallback至仅Google分析
URL无效	输入格式错误	通过 `google_auth.validate_url()` 验证，显示错误信息
非产品页面	URL为分类页/首页	检测页面类型，建议使用 `/seo ecommerce schema` 命令

Output Template

输出模板

undefined

undefined

E-commerce SEO Report: [URL or Keyword]

电商SEO报告：[URL或关键词]

Overall Score: XX/100

总体得分：XX/100

Product Page SEO

产品页面SEO

Schema Completeness: XX/100
Title & Meta: XX/100
Image Optimization: XX/100
Content Quality: XX/100
Internal Linking: XX/100

Schema完整性：XX/100
标题与元数据：XX/100
图片优化：XX/100
内容质量：XX/100
内部链接：XX/100

Marketplace Intelligence (if DataForSEO available)

平台情报（若DataForSEO可用）

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

Google Shopping列表：找到N个产品
价格区间：$XX - $XX（中位数：$XX）
头部卖家：[名称]（XX%市场占比）
亚马逊对比：[已完成/未检查]

Top Recommendations

核心建议

[Critical] ...
[High] ...
[Medium] ...

Generate a PDF report? Use

/seo google report

undefined

[紧急] ...
[高优先级] ...
[中优先级] ...

需要生成PDF报告？使用

/seo google report

命令

undefined

seo-ecommerce

Original

Translation

E-commerce SEO Analysis

电商SEO分析

Commands

命令

1. Product Page Analysis (No DataForSEO Needed)

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

Workflow

工作流程

Product SEO Checklist

产品SEO检查清单

Title Tag

标题标签

Meta Description

元描述

Heading Structure

标题层级结构

Product Images

产品图片

Internal Linking

内部链接

Content Quality

内容质量

Scoring

评分规则

2. Google Shopping Intelligence (DataForSEO Merchant API)

2. Google Shopping情报分析（DataForSEO Merchant API）

Cost Guardrail (MANDATORY)

成本管控（强制要求）

Workflow

工作流程

Product search: who sells what at what price

产品搜索：查询竞品及对应价格

Seller analysis: merchant ratings and dominance

卖家分析：商家评分及市场占比

Normalize results for analysis

标准化结果用于分析

Analysis Outputs

分析输出

Pricing Intelligence

价格情报

Seller Landscape

卖家格局

Product Listing Quality

产品列表质量

3. Amazon Marketplace (DataForSEO)

3. 亚马逊平台分析（DataForSEO）

Cost Guardrail (MANDATORY)

成本管控（强制要求）

Workflow

工作流程

Amazon product search

亚马逊产品搜索

Cross-marketplace comparison

跨平台对比

Cross-Marketplace Report

跨平台对比报告

4. Marketplace Keyword Gaps

4. 平台关键词差距分析

Workflow

工作流程

Gap Types

差距类型

Output Format

输出格式

Keyword Gap Analysis: example.com

关键词差距分析：example.com

Opportunities: Organic → Shopping (12 keywords)

机会：自然搜索 → Shopping（12个关键词）

Opportunities: Shopping → Organic (8 keywords)

机会：Shopping → 自然搜索（8个关键词）

5. Product Schema Enhancement

5. 产品Schema优化

Required Properties (Google Merchant)

必填属性（谷歌商家中心）

Recommended Properties (Enhance Rich Results)

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

Validation Rules