用途：针对电商场景做商品页 SEO 诊断、商品结构化数据校验，以及 Google Shopping / Amazon 市场情报与竞品定价分析，并可对比自然搜索与购物广告的可见度差距。
主要能力：
- 商品页分析（无需 DataForSEO）：用 python scripts/fetch_page.py <url> 抓取页面，再用 python scripts/parse_html.py --url <url> 解析 SEO 元素；按标题、Meta、标题结构、商品图片、内链、内容质量等维度检查。评分权重为 Schema 完整性 25%、标题与 Meta 15%、图片优化 20%、内容质量 20%、内链 10%、技术 10%。
- Google Shopping 情报（需 DataForSEO）：python scripts/dataforseo_merchant.py search "<keyword>" --marketplace google 与 sellers "<keyword>"，python scripts/dataforseo_normalize.py results.json --module merchant 归一化结果，输出价格分布、卖家格局、Listing 质量等。
- Amazon 市场：--marketplace amazon 查询及 compare 跨市场对比，相关端点默认需用户批准。
- 关键词差距：结合自然排名与 Shopping 结果，划分仅自然、仅 Shopping、两者皆有、两者皆无四类并给出动作建议。
- 商品 Schema：按 Google Merchant 要求校验必填与推荐字段（如 price 为纯数字字符串、availability 用完整 Schema.org URL、aggregateRating 需含 ratingValue 与 reviewCount 等），并给出完整性评分。
使用方式：命令包括 /seo ecommerce <url>、/seo ecommerce products <keyword>、/seo ecommerce gaps <domain>、/seo ecommerce schema <url>。执行前会检查 .seo-cache/ 中的共享缓存；用户说 refresh 或 re-run 时忽略缓存并覆盖写入。调用 DataForSEO 前必须运行 python scripts/dataforseo_costs.py check <端点>，按 approved / needs_approval / blocked 状态处理，调用后用 log 记录成本。
适用场景：商品详情页优化、购物广告与自然流量的关键词互补、竞品价格与卖家分析、商品结构化数据修复。
限制：无 DataForSEO 凭据时仅能做免费页面与 Schema 分析；Amazon 端点需人工批准；预算超限会阻止付费调用；关键词与定价数据依赖所接入的第三方接口，资料未提供具体价格、套餐与效果承诺。