seo-ecommerce

电商 SEO 分析

全面的产品页面优化、市场情报和竞争定价分析。可独立运行（页面内优化 + schema），也可结合 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>	产品 schema 验证与增强	否

---

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

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

工作流

1. "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <url> --mode auto → raw/rendered HTML
2. "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py --url <url>   → SEO elements
3. Analyze product-specific signals (below)

产品 SEO 检查清单

标题标签

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

Meta Description

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

标题结构

• 只有一个与主要产品名称一致的 H1
• 使用 H2 展示：功能、规格、评价、相关产品
• 不同产品变体之间没有重复的 H1 标签

产品图片

• 替代文本包含产品名称和显著特征
• 文件名具有描述性（不是 IMG_001.jpg）
• 使用 WebP 格式（并提供 JPEG 回退格式）
• 每个产品至少有 3 张图片（主图、细节图、生活场景图）
• 高分辨率图片：Google 建议商品信息列表中的图片至少达到 50K 像素（宽度 x 高度）；更大的尺寸（例如 800px+）是常见做法，并非规则
• 仅对首屏以下的图片启用延迟加载

内部链接

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

内容质量

• 产品描述独特（不是直接复制制造商文案）
• 产品描述正文至少 200 个词
• 提供规格表（不只是文字描述）
• 页面上有用户评价（UGC 信号）

评分

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

---

2. Google Shopping 情报（DataForSEO Merchant API）

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

成本控制（必须执行）

每次调用 Merchant API 之前：

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check merchant_google_products_search

• "status": "approved" -- 继续
• "status": "needs_approval" -- 显示费用并询问用户
• "status": "blocked" -- 停止并告知用户

每次调用之后：

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py log merchant_google_products_search <cost>

工作流

# Product search: who sells what at what price
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py search "<keyword>" --marketplace google

# Seller analysis: merchant ratings and dominance
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py sellers "<keyword>"

# Normalize results for analysis
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_normalize.py results.json --module merchant

分析输出

定价情报

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

卖家概况

• 按商品列表数量排名前 10 的卖家
• 商家评分分布
• 免费配送普及率
• 新卖家与成熟卖家的对比

商品列表质量

• 热门商品列表中的标题关键词模式
• 平均评分和评价数量基准
• 每个商品列表的图片数量
• 商品供应状态分布

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

---

3. Amazon 市场（DataForSEO）

跨市场情报：对比 Google Shopping 和 Amazon。

成本护栏（强制）

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check merchant_amazon_products_search

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

工作流

# Amazon product search
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py search "<keyword>" --marketplace amazon

# Cross-marketplace comparison
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run 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 REST 脚本获取 Google Shopping 展示情况（不是 MCP 工具；成本账本键为 merchant_google_products_search）： 对排名靠前的自然搜索关键词运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_merchant.py search <keyword>
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）

已确认的必填字段为 name、image 和 offers；商家商品列表应使用 Offer，而不是 AggregateOffer。商家商品列表要求 price 大于零，并且设置 price 时必须同时提供 priceCurrency。

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "",
  "image": [""],
  "offers": {
    "@type": "Offer",
    "url": "",
    "priceCurrency": "USD",
    "price": "49.00",
    "availability": "https://schema.org/InStock"
  }
}

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

• sku —— 产品标识符
• description、brand、offers.seller —— 推荐的上下文信息字段
• gtin13 / gtin14 / mpn —— 全球贸易标识符
• aggregateRating —— 星级评分 + 评价数
• review —— 单条评价（至少 1 条）
• color、material、size —— 变体属性
• shippingDetails —— 包含费率和配送时间的 ShippingDetails（也支持通过 ShippingService 设置商家级运费；无需 Merchant Center 账号，也可以在 Search Console 中设置运费/退货政策）
• hasMerchantReturnPolicy —— 包含类型和天数的 MerchantReturnPolicy
• hasAdultConsideration —— 成人用品必填（于 2026-05-20 添加到 Product 变体 / Merchant 商品列表）；Google Search 仅支持 https://schema.org/SexualContentConsideration 这一值
• category —— Text、CategoryCode，或两者混合的数组。商家定义的产品类型使用自定义文本；Google 产品类别使用 CategoryCode，并搭配 Google 分类法 URL 和 codeValue。

验证规则

1. price 必须是数字字符串，不能是 "$29.99"（不含货币符号）
2. availability 必须使用完整的 Schema.org URL 枚举值
3. image 应为数组，且至少包含 1 个高分辨率图片 URL
4. priceCurrency 必须符合 ISO 4217（USD、EUR、GBP）
5. 如果提供了 brand，则 brand.name 不能为空，也不能是 "N/A"
6. 促销时段使用 validFrom 和 validThrough 或 priceValidUntil，格式为 ISO 8601。已知时应包含时间和时区。
7. 如果提供了 aggregateRating：必须提供 ratingValue 和 reviewCount（商家商品列表文档列出 reviewCount；评价摘要文档也接受 ratingCount）
8. 不要在可见内容或结构化数据中包含虚假评价或未披露的激励性评价。必须清晰、醒目地披露激励信息。

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	Product 图片审计（替代文本、格式、尺寸），并为 AI 生成的 Product 图片添加 DigitalSourceType: TrainedAlgorithmicMedia IPTC 标签（Merchant Center 要求）
seo-content	Product 描述的 E-E-A-T 和独特性分析
seo-dataforseo	用于差距分析的自然关键词排名
seo-technical	Product 页面的 Core Web Vitals（主图的 LCP）
seo-hreflang	特定地区的结果单元：在 EEA，Product 和（自 2026-09-18 起）本地商家查询可显示聚合商和供应商单元；EEA、南非和 Türkiye 也有结构化数据轮播，每种都有各自的资格规则（记录于 2026-09-08）
seo-google	Product URL 的 GSC 编入索引状态和效果数据（不是 Merchant Center Feed 验证，该验证在 Merchant Center / Merchant API 中完成；旧版 Content API for Shopping 将于 2026-08-18 停用）

UCP：Universal Commerce Protocol（已上线）

由 Google 发起的开放标准（与 Shopify、Etsy、Wayfair、Target、Walmart 共同开发；支付合作伙伴包括 Visa/Mastercard/Stripe/Adyen/Amex），让 AI Agent 无需一次性集成即可发现商家、进行协商并完成交易。Google 确认已在 Search 的 AI Mode 中实现对话式购物的首个参考实现。更广泛的 Universal Cart 推出详情来自 Google I/O 2026 主题演讲的报道；Google 所有的来源尚未确认。ucp.dev 将 2026-08-25 列为最新规范版本（Google 的商家指南仍记录为 2026-04-08）；其采用基于日期的版本方案，而非 1.0；有两种集成路径：Native（默认）和 Embedded（经批准的商家）。与 AP2 配合使用（据报道正转向由 FIDO 治理）。规范来源：developers.google.com/merchant/ucp 和 ucp.dev。

已使用 Google Merchant Center 且 Product schema 干净的商家，可以在 /.well-known/ucp 中声明 UCP 配置文件，列出功能 （dev.ucp.shopping.checkout、.fulfillment、.discount）。审计标准、 功能示例以及与 AP2（Agent Payments Protocol）的关系，请参阅 references/ucp-universal-commerce-protocol.md。

审计命令

# Discover and validate the UCP profile
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ucp_check.py https://store.example.com --json

# With endpoint reachability probes (HEAD each declared capability)
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run ucp_check.py https://store.example.com --probe-endpoints --json

脚本会返回：配置文件是否存在、版本、声明的功能、 结构问题（缺少字段、未知功能 ID），以及（使用 --probe-endpoints 时）各端点的可访问性。会明确报告被 SSRF 防护拦截的端点。缺少配置文件会报告为机会，而非失败。UCP 本身已上线；尚处于早期阶段的是商家的广泛采用。若出现字面值 "version": "1.0"，请标记为无效（UCP 版本采用基于日期的方案，例如 2026-04-08）。

---

错误处理

错误	原因	响应
未找到 Product schema	页面缺少 JSON-LD	分析页面内容，生成建议的 schema
缺少 DataForSEO 凭据	未设置环境变量	不使用市场数据运行分析，并注明限制
成本检查被拦截	超出每日预算	告知用户，并提供仅使用免费数据的分析
Shopping 结果为空	关键词没有商品	建议更宽泛的关键词，检查位置设置
Amazon API 超时	网络/速率限制	退避后重试，回退到仅使用 Google
URL 无效	输入格式错误	使用 google_auth.validate_url() 验证，并显示错误
非 Product 页面	URL 指向类别页/首页	运行店铺级检查（UCP 配置文件、类别结构、Feed），并请用户提供 Product URL，以便执行 Product 级检查

---

输出模板

## 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`