seo-ecommerce

电商SEO分析

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

命令

命令	用途	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-seo run render_page.py <url> --mode auto → 原始/渲染后的HTML
2. claude-seo run parse_html.py --url <url>   → SEO元素
3. 分析产品特定信号（如下）

产品SEO检查清单

标题标签

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

元描述

[ ] 包含产品关键词 + 利益点
[ ] 包含价格或“起价$XX”（触发富摘要兴趣）
[ ] 包含行动号召（立即购买、购买、免运费）
[ ] 不超过155个字符

标题结构

[ ] 单个H1，与主要产品名称匹配
[ ] H2用于：功能、规格、评价、相关产品
[ ] 不同产品变体间无重复H1标签

产品图片

[ ] Alt文本包含产品名称 + 区分特征
[ ] 文件名具有描述性（非IMG_001.jpg）
[ ] 提供WebP格式（带JPEG回退）
[ ] 每个产品至少3张图片（主图、细节图、场景图）
[ ] 图片尺寸 >= 800px（满足Google Shopping要求）
[ ] 仅对首屏以下图片使用懒加载

内部链接

[ ] 面包屑导航：首页 > 分类 > 子分类 > 产品
[ ] 相关产品区域（交叉销售/追加销售）
[ ] 使用关键词丰富的锚文本链接回分类页面
[ ] 评价区域链接到完整评价页面（如果分开）

内容质量

[ ] 独特的产品描述（非制造商复制粘贴）
[ ] 产品描述正文字数 >= 200
[ ] 存在规格表（不仅仅是文字）
[ ] 页面内用户评价（UGC信号）

评分

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

2. Google Shopping情报（DataForSEO Merchant API）

来自Google Shopping结果的实时竞争分析。

成本防护（强制）

每次调用Merchant API前：

claude-seo run dataforseo_costs.py check merchant_google_products_search

"status": "approved" -- 继续
"status": "needs_approval" -- 显示成本，询问用户
"status": "blocked" -- 停止，通知用户

每次调用后：

claude-seo run dataforseo_costs.py log merchant_google_products_search <cost>

工作流程

# 产品搜索：谁在卖什么，价格如何
claude-seo run dataforseo_merchant.py search "<keyword>" --marketplace google

# 卖家分析：商家评分与主导地位
claude-seo run dataforseo_merchant.py sellers "<keyword>"

# 标准化结果以便分析
claude-seo run dataforseo_normalize.py results.json --module merchant

分析输出

定价情报

价格分布：最小值、最大值、中位数、P25、P75
价格异常值（偏离中位数超过2个标准差）
价格与评分相关性
货币归一化为美元（或用户指定）

卖家格局

按列表数量排名前10的卖家
商家评分分布
免运费普及率
新卖家与老卖家

产品列表质量

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

加载 references/marketplace-endpoints.md 获取完整API参数详情。

3. 亚马逊市场（DataForSEO）

跨市场情报，比较Google Shopping和亚马逊。

成本防护（强制）

claude-seo run dataforseo_costs.py check merchant_amazon_products_search

亚马逊端点位于 warn_endpoints 集合中——始终需要用户批准。

工作流程

# 亚马逊产品搜索
claude-seo run dataforseo_merchant.py search "<keyword>" --marketplace amazon

# 跨市场比较
claude-seo run dataforseo_merchant.py compare "<keyword>"

跨市场报告

指标	Google Shopping	亚马逊
平均价格	$	$
中位数评分	X.X	X.X
平均评价数量	N	N
顶级卖家份额	%	%
免运费比例	%	%

4. 市场关键词缺口

识别自然搜索与Shopping可见性之间的不匹配。

工作流程

通过seo-dataforseo获取自然排名：
dataforseo_labs_google_ranked_keywords 针对域名
通过Merchant API获取Google Shopping存在情况：
merchant_google_products_search 针对顶部自然关键词
交叉引用结果

缺口类型

缺口类型	含义	行动
仅有自然	有自然排名但无Shopping广告	创建Google Merchant Center feed，对这些关键词出价
仅有Shopping	有Shopping可见性但自然排名弱或无	为这些关键词创建内容（购买指南、比较页面）
两者都有	在两个渠道均有可见性	优化：确保价格一致，增强Schema
两者都无	在两个渠道均无可见性	除非搜索量高，否则低优先级

输出格式

## 关键词缺口分析：example.com

### 机会：自然 → Shopping（12个关键词）
| 关键词 | 自然排名 | 搜索量 | CPC | 推荐行动 |
|---------|------------|--------|-----|-------------------|

### 机会：Shopping → 自然（8个关键词）
| 关键词 | Shopping排名 | 搜索量 | CPC | 所需内容类型 |
|---------|-------------|--------|-----|-------------------|

5. 产品Schema增强

根据Google当前要求验证和生成产品Schema。

确认的必需属性（Google Merchant）

确认的必填字段为 name、image 和 offers；对于商家列表，使用 Offer，而非 AggregateOffer。

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

验证规则

price 必须是数字字符串，而非“$29.99”（无货币符号）
availability 必须使用完整的Schema.org URL枚举
image 应为数组，包含至少1个高清图片URL
priceCurrency 必须是ISO 4217（USD、EUR、GBP）
如果存在 brand，则 brand.name 不能为空或“N/A”
priceValidUntil 中的日期必须为ISO 8601格式
如果存在 aggregateRating：则 ratingValue 和 reviewCount 为必填

Schema评分

完整性	分数
所有必填字段	50/100
+ aggregateRating	65/100
+ sku/gtin/mpn	75/100
+ shippingDetails	85/100
+ merchantReturnPolicy	90/100
+ reviews (3+)	100/100

跨技能集成

技能	集成点
seo-schema	委托产品Schema生成；复用验证逻辑
seo-images	产品图片审核（Alt文本、格式、尺寸），以及AI生成产品图片的 `DigitalSourceType: TrainedAlgorithmicMedia` IPTC标签（Merchant Center要求）
seo-content	产品描述E-E-A-T和独特性分析
seo-dataforseo	用于缺口分析的自然关键词排名
seo-technical	产品页面的Core Web Vitals（主图LCP）
seo-google	GSC索引 + 产品URL的效果数据（非Merchant Center feed验证，后者在Merchant Center / Merchant API中完成；旧的Content API for Shopping将于2026-08-18停用）

UCP：通用商务协议（已上线）

Google发起的开放标准（与Shopify、Etsy、Wayfair、Target、Walmart共同开发；支付合作伙伴Visa/Mastercard/Stripe/Adyen/Amex），允许AI代理发现、协商并与商家交易，无需一次性集成。Google确认了首个参考实现，用于搜索AI模式中的对话式购买。更广泛的Universal Cart推出细节来自Google I/O 2026主题演讲报道；未在Google自有来源上确认。ucp.dev列出2026-04-08作为其基于日期的版本控制方案中的最新版本，而非1.0；两种集成路径：Native（默认）和Embedded（经批准的商家）。与AP2配对（据报道正转向FIDO治理）。权威来源：developers.google.com/merchant/ucp 和 ucp.dev。

已在Google Merchant Center上拥有干净产品Schema的商家可以在/.well-known/ucp声明UCP配置文件，列出能力（dev.ucp.shopping.checkout、.fulfillment、.discount）。参见references/ucp-universal-commerce-protocol.md了解审计标准、能力示例以及与AP2（代理支付协议）的关系。

审计命令

# 发现并验证UCP配置文件
claude-seo run ucp_check.py https://store.example.com --json

# 带端点可达性探测（HEAD每个声明的能力）
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）。

错误处理

错误	原因	响应
未找到产品Schema	页面缺少JSON-LD	分析页面内容，生成推荐Schema
DataForSEO凭据缺失	环境变量未设置	无市场数据运行分析，注明限制
成本检查被阻止	每日预算超限	通知用户，提供仅免费分析
Shopping结果为空	关键词无产品	建议更广泛的关键词，检查位置设置
亚马逊API超时	网络/速率限制	带退避重试，回退到仅Google
无效URL	格式错误输入	通过`google_auth.validate_url()`验证，显示错误
非产品页面	URL是分类/首页	检测页面类型，建议改用`/seo ecommerce schema`

输出模板

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

### 总体评分：XX/100

### 产品页面SEO
- Schema完整性：XX/100
- 标题与元描述：XX/100
- 图片优化：XX/100
- 内容质量：XX/100
- 内部链接：XX/100

### 市场情报（如果DataForSEO可用）
- Google Shopping列表：找到N个产品
- 价格范围：$XX - $XX（中位数：$XX）
- 顶级卖家：[名称]（XX%市场份额）
- 亚马逊对比：[可用/未检查]

### 首要建议
1. [关键] ...
2. [高] ...
3. [中] ...

生成PDF报告？使用 `/seo google report`

你可能还喜欢

herdr

24Kagent-workflows

Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, commands, or another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.

herdrdev

获取

herdr

17Kagent-workflows

Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, terminals, commands, or communication with another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1.