【免费下载链接】claude-seo
Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.
本文基于开源仓库 claude-seo 中seo-plan技能附带的 E-commerce SEO Strategy Template(skills/seo-plan/assets/ecommerce.md)展开,完整继承其行业特征、站点架构、Schema 建议、内容要求与 GEO 检查清单,并接入仓库内seo-ecommerce技能、schema/templates.json模板库与源码级验证脚本作为落地工具。读完本文,你将获得一套可直接复制的电商 SEO 规划框架:从目录结构与页面 Schema 设计,到分页/分面/变体等工程细节,再到面向 AI 搜索引用的优化清单,以及配套的检测与验证命令。
一、电商行业的 SEO 特征:先理解商业模式,再谈优化
电商站点与传统内容站点的最大区别在于交易意图强度。claude-seo 的电商模板首先定义了六个行业特征,它们决定了后续所有架构与内容决策的方向:
| 特征 | 对 SEO 的影响 |
|---|---|
| 高交易意图(High transaction intent) | 关键词以商业词为主,排名与转化直接挂钩 |
| 产品比较行为(Product comparison behavior) | 需要对比页、评测页承接“哪个更好”类查询 |
| 价格敏感(Price sensitivity) | 价格、优惠、运费信息必须显性化,Merchant Center 数据一致性关键 |
| 视觉优先决策(Visual-first decision making) | 产品图质量、alt 文本、图片尺寸直接决定点击率 |
| 季节性需求模式(Seasonal demand patterns) | 需要季节落地页与动态内容优先级 |
| 竞争性市场列表(Competitive marketplace listings) | 需要同时关注自有站与 Google Shopping/Amazon 的可见度 |
这六个特征在仓库中有更细的支撑:seo-ecommerce技能(skills/seo-ecommerce/SKILL.md)在定义产品页分析工作流时,把“图片优化”权重设为 20%(alt 文本、WebP 格式、≥800px 尺寸、每产品至少 3 图),把“内容质量”设为 20%(唯一描述、规格表、用户评价),正是对“视觉优先”与“比较行为”的可量化回应。
二、推荐的站点信息架构(IA)
模板给出了一个电商站的标准目录骨架,覆盖了主分类、产品、品牌、促销位与辅助页面五类内容:
/ ├── Home ├── /collections (或 /categories) │ ├── /category-1 │ │ ├── /subcategory-1 │ │ └── ... │ ├── /category-2 │ └── ... ├── /products │ ├── /product-1 │ ├── /product-2 │ └── ... ├── /brands │ ├── /brand-1 │ └── ... ├── /sale (或 /deals) ├── /new-arrivals ├── /best-sellers ├── /gift-guide ├── /blog │ ├── /buying-guides │ ├── /how-to │ └── /trends ├── /about ├── /contact ├── /shipping ├── /returns └── /faq理解这套架构的关键点:
- 分类层级控制在两级以内(
/collections/category-1/subcategory-1),保证爬虫深度与权重下沉效率;从 claude-seo 的seo-plan流程看,架构设计属于整个 SEO 计划的第三步(Discovery → Competitive Analysis → Architecture Design),模板明确要求“从assets/目录加载行业模板”并设计 URL 层级与内容支柱(见 skills/seo-plan/SKILL.md)。 /sale、/new-arrivals、/best-sellers、/gift-guide是独立流量入口,对应季节性需求与促销场景,这些页面通常需要 noindex 策略配合(见后文分面导航部分)以避免重复内容。/blog下细分buying-guides、how-to、trends,这是承接“比较行为”与长尾信息意图的内容层,与模板“Content Priorities”中“主要分类的购买指南”列为高优先级一致。/shipping、/returns、/faq等信任页服务于 E-E-A-T 与转化后顾虑,同时也为shippingDetails、hasMerchantReturnPolicy等结构化数据提供锚定信息源。
三、Schema 结构化数据建议
3.1 各页面类型的 Schema 组合
模板按页面类型给出最小 Schema 组合表:
| 页面类型 | Schema 类型 |
|---|---|
| 产品页 Product Page | Product, Offer, AggregateRating, Review, BreadcrumbList |
| 分类页 Category Page | CollectionPage, ItemList, BreadcrumbList |
| 品牌页 Brand Page | Brand, Organization |
| 博客 Blog | Article, BlogPosting |
值得注意的组合逻辑:
- 产品页的 Schema 是嵌套的:
Product内部嵌offers(Offer)、aggregateRating、review,外层再配BreadcrumbList。这与仓库schema/templates.json中“Product (Full E-commerce)”模板的字段结构完全对应(见 schema/templates.json),该模板在 v1.9.0 中为seo-ecommerce新增,包含priceValidUntil、hasMerchantReturnPolicy、shippingDetails等进阶字段。 - 分类页使用
ItemList枚举分类下产品,恰好与seo-cluster技能复用的同一模板一致——仓库中ItemList模板的描述明确写着“Hub/pillar pages listing related content items”(schema/templates.json),可同时服务于电商分类页与内容集群落地页。
3.2 2025 新增电商 Schema:ProductGroup / Certification / OfferShippingDetails
模板专门辟出一节“Additional E-commerce Schema (2025)”,指向三个近年关键类型:
- ProductGroup:用于带变体(尺寸、颜色)的产品。以
variesBy声明变体维度、hasVariant列出各变体,把多个Product条目包裹在统一组下。仓库 schema/templates.json 提供了完整模板:productGroupID标识组、variesBy引用 schema.org 的 size/color 属性、每个hasVariant内嵌独立Product(含各自 sku、颜色、尺寸与 offers)。 - Certification:用于产品认证(Energy Star、安全认证、有机认证等)。模板明确标注2025 年 4 月起取代 EnergyConsumptionDetails,通过
Product上的hasCertification属性挂载。仓库模板中的写法为hasCertification: { "@type": "Certification", "certificationIdentification": "...", "issuedBy": { "@type": "Organization", "name": "..." } }(schema/templates.json)。 - OfferShippingDetails:包含运费(shippingRate)、处理时间(handlingTime)与运输时间(transitTime),是Merchant Center 资格的关键。仓库模板用
MonetaryAmount+ShippingDeliveryTime(内含QuantitativeValue与unitCode: "DAY")表达,见 schema/templates.json。
这三个类型不是孤立字段,而是互为嵌套关系:一个完整的电商产品页 Schema 应当是Product→offers(内嵌shippingDetails与hasMerchantReturnPolicy)→ 有变体时外套ProductGroup,有认证时挂hasCertification。
3.3 Google Merchant Center Free Listings 硬性要求
模板用两段引用块强调了一个容易被忽略的合规点:
Google Merchant Center Free Listings:产品可以免费出现在 Google Shopping 中。确保 Product 结构化数据位于初始服务端渲染的 HTML(而非 JavaScript 注入)中,且包含必需属性:
name、image、price、priceCurrency、availability。
JS Rendering Note:Product 结构化数据应放在初始服务端渲染 HTML 中,不要通过 JavaScript 动态注入(依据 2025 年 12 月 Google JS SEO 指南)。
这一要求在仓库中有双重印证:
seo-ecommerce技能在页面抓取章节明确指出“电商站点普遍在客户端注入产品 Schema(Shopify、Magento PWA、基于 Next.js 的无头电商)”,因此审计产品页时应优先使用python3 scripts/render_page.py <URL> --mode always,并对比raw_content(JS 前)与content(JS 后)来确认 JSON-LD 是否服务端渲染(见 skills/seo-ecommerce/SKILL.md 与 agents/seo-ecommerce.md)。- 源码级验证脚本
scripts/schema_ecommerce_validate.py的文档字符串把hasMerchantReturnPolicy与shippingDetails列为“merchant listing 资格 REQUIRED”字段,并强调 Rich Results Test 只能抓结构性错误,该脚本补抓“能解析但会 disqualify 富结果的策略性错误”(见 scripts/schema_ecommerce_validate.py)。
3.4 Product Schema 完整示例
模板给出了一份最小可用的 Product JSON-LD:
{ "@context": "https://schema.org", "@type": "Product", "name": "Product Name", "image": ["https://example.com/product.jpg"], "description": "Product description", "sku": "SKU123", "brand": { "@type": "Brand", "name": "Brand Name" }, "offers": { "@type": "Offer", "price": "99.99", "priceCurrency": "USD", "availability": "https://schema.org/InStock", "url": "https://example.com/product" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.5", "reviewCount": "42" } }对照仓库可将其升级为生产级版本——在offers内追加priceValidUntil(ISO 8601 日期)、hasMerchantReturnPolicy(如MerchantReturnFiniteReturnWindow+ 30 天)与shippingDetails,即 schema/templates.json 中“Product (Full E-commerce)”模板的结构。seo-ecommerce技能还给出了“必填 + 推荐”两个层级的字段矩阵:
必填(Google Merchant):name、image、description、brand.name、offers.url、offers.priceCurrency、offers.price、offers.availability、offers.seller。
推荐(增强富结果):sku、gtin13/gtin14/mpn(全球贸易标识)、aggregateRating、review(至少 1 条)、color/material/size(变体属性)、shippingDetails、hasMerchantReturnPolicy。
3.5 源码级验证规则:schema_ecommerce_validate.py
seo-ecommerce技能给出了 7 条硬性校验规则,全部有脚本实现支撑(scripts/schema_ecommerce_validate.py):
price必须是数字字符串,不能是"$29.99"(不能带货币符号);availability必须使用完整 Schema.org URL 枚举(如https://schema.org/InStock);image应为数组且至少 1 个高清图片 URL;priceCurrency必须是 ISO 4217 货币代码(USD、EUR、GBP);brand.name不能为空或"N/A";priceValidUntil中的日期必须是 ISO 8601 格式;- 若存在
aggregateRating,则ratingValue与reviewCount必须同时出现。
脚本内部定义了_REQUIRED_PRODUCT_FIELDS = ("name", "image", "description", "offers")与_REQUIRED_OFFER_FIELDS = ("price", "priceCurrency", "availability"),返回策略(Return Policy)与配送(Shipping)分别要求applicableCountry/returnPolicyCategory与shippingDestination/deliveryTime。此外脚本还内置了 2025 年 6 月 Google 退役的富结果类型黑名单(Vehicle/VehicleListing、ClaimReview、EstimatedSalary、LearningVideo、Course轮播、SpecialAnnouncement),一旦检测到即为 Critical 级发现——完整的类型退役时间表可查 skills/seo-schema/references/deprecated-types-2024-2026.md。脚本运行方式:
cat product.json | python3 scripts/schema_ecommerce_validate.py python3 scripts/schema_ecommerce_validate.py product.json --eu # 欧盟 EPREL 能效要求 python3 scripts/schema_ecommerce_validate.py product.json --json # 机器可读输出退出码 0 表示通过,1 表示存在至少一个 Critical/High 级问题。
3.6 Schema 完整度评分
seo-ecommerce技能为 Schema 完整度定义了阶梯评分,可作为上线前的量化目标:
| 完整度 | 得分 |
|---|---|
| 全部必填字段 | 50/100 |
| + aggregateRating | 65/100 |
| + sku/gtin/mpn | 75/100 |
| + shippingDetails | 85/100 |
| + merchantReturnPolicy | 90/100 |
| + reviews(3 条以上) | 100/100 |
四、内容要求:每个页面类型的最低标准
模板为两类核心页面分别规定了 400 词的最低内容线:
4.1 产品页(≥400 词)
- 唯一的产品描述(不能照抄制造商文案)——这与
seo-ecommerce技能中“Content Quality”权重 20% 的评分项及 skills/seo-content/SKILL.md 的 E-E-A-T/唯一性分析直接挂钩; - 功能亮点(Feature highlights);
- 使用场景/目标人群(Use cases / who it's for);
- 规格参数表(Specifications table)——
seo-ecommerce的检查清单同样要求“有规格表而非纯文字”; - 尺码/版型指南(针对服饰类);
- 护理说明;
- 客户评价(UGC 信号)。
4.2 分类页(≥400 词)
- 分类介绍;
- 购买指南摘要(Buying guide excerpt);
- 精选产品(Featured products);
- 子分类链接;
- 筛选/排序选项说明。
注意:模板的 400 词是最低门槛,仓库中seo-ecommerce技能对产品描述正文的最低要求为 200 词,两者并不冲突——前者是整页内容体量(含规格表、评价等非描述内容),后者是“描述正文”单一元素的底线。
五、技术注意事项:分页、分面导航与产品变体
模板给出三个高频工程场景的规范:
5.1 分页(Pagination)
- 使用
rel="next"/rel="prev",或“加载更多”(load-more)方案; - 确保所有产品都可被抓取(不要用无限滚动挡住爬虫);
- 主分类页设置 canonical,防止分页页稀释权重。
5.2 分面导航(Faceted Navigation)
- 对产生重复内容的筛选组合(如颜色×价格区间)使用 noindex;
- 合理使用 canonical 标签(把筛选页 canonical 回主干分类);
- 确保热门筛选组合保持可索引(高频长尾词入口)。
5.3 产品变体(Product Variations)
- 方案 A:父产品单一 URL,变体通过结构化数据表达(即 3.2 节的 ProductGroup 方案);
- 方案 B:变体独立 URL,全部 canonical 到父产品;
- 无论哪种方案,所有变体的结构化数据都必须完整。
这三条规则与模板中 ProductGroup 的建议互为表里:URL 层面用 canonical 收敛,结构化数据层面用variesBy/hasVariant展开,两个维度缺一不可。
六、内容优先级规划
模板按 ROI 预期将页面分为三个梯队:
高优先级
- 顶级分类页
- 畅销产品页
- 首页
- 主要分类的购买指南
中优先级
- 子分类页
- 品牌页
- 对比内容
- 季节落地页
博客选题方向
- 购买指南(“How to Choose...”)
- 产品对比
- 趋势报告
- 使用场景与灵感
- 保养与维护指南
这套优先级可直接映射到seo-plan技能的 4 阶段实施路线图(skills/seo-plan/SKILL.md):高优先级页面对应 Phase 1–2(第 1–12 周完成核心页与博客启动),中优先级与对比内容对应 Phase 3(第 13–24 周的高级内容开发),权威性内容(思想领导力、媒体提及)进入 Phase 4(第 7–12 个月)。
七、关键指标追踪
模板建议跟踪的核心 KPI:
- 自然搜索带来的营收(Revenue from organic search)
- 产品页排名
- 分类页排名
- 富结果点击率(Click-through rate for rich results)
- 自然流量平均订单价值(AOV from organic)
在seo-plan的 KPI 目标表中,这些指标需按基线 / 3 个月 / 6 个月 / 12 个月四档设定目标值(Organic Traffic、Keyword Rankings、Indexed Pages、Core Web Vitals 等),并配合seo-google技能的 GSC 报告模板(skills/seo-google/assets/templates/gsc-performance-report.md)做周期性复盘。
八、GEO for E-commerce:面向 AI 搜索引用的优化
模板以检查清单形式给出了电商站点被 AI 搜索平台(AI Overviews、AI Mode 等)引用的七项优化动作:
- 以结构化格式提供清晰的产品规格、尺寸、材质信息
- 变体产品使用 ProductGroup Schema
- 提供原创产品摄影并配描述性 alt 文本
- 包含真实的客户评价内容(配合 AggregateRating Schema)
- 在所有平台(自有站、Amazon、Merchant Center)保持产品实体数据一致
- 用清晰的特性表格组织对比内容,便于 AI 解析
- 为常见产品问题添加详细的 FAQ 内容
对照仓库内 skills/seo-geo/references/google-ai-optimization-guide.md 的“神话破除”章节,这里有几处需要校准的认知:
- FAQPage 的富结果已于 2026 年 5 月 7 日全面退役(见 skills/seo-schema/references/deprecated-types-2024-2026.md),因此清单中“添加 FAQ 内容”的价值在于AI 引用与实体信号,而非 SERP 富结果——仓库明确建议保留现有 FAQPage 标记但将其标记为 Info 而非 Critical,同时不为 SERP 收益新建 FAQPage,真实问答页改用
QAPage。 - Google 官方立场:被 AI 功能收录的前提是页面“被索引且有资格以摘要形式出现在 Google 搜索中”,不存在独立的“AI 索引”;无需为 AI 专门制造 llms.txt、切块内容或追逐不真实的品牌提及。电商站点真正该做的是把上述清单的“数据一致性、结构化表达、真实 UGC”做好。
- AI 生成产品内容的合规红线:Merchant Center 要求 AI 生成的产品图片携带 IPTC
DigitalSourceType: TrainedAlgorithmicMedia元数据,AI 生成的产品标题与描述必须在 feed 中单独标注(见 skills/seo-geo/references/google-ai-optimization-guide.md)。seo-images技能提供了注入与审计该元数据的 exiftool 命令模式(skills/seo-images/SKILL.md)。
九、从模板到执行的仓库工具链
seo-plan的ecommerce.md是“计划模板”,而仓库为执行提供了完整闭环,建议按以下顺序组合使用:
9.1 页面级分析(无需付费 API)
python3 scripts/render_page.py <url> --mode always # 电商页优先强制渲染,对比 JS 前后 JSON-LD python3 scripts/parse_html.py --url <url> # 提取 SEO 元素 python3 scripts/schema_ecommerce_validate.py product.json # 校验 Product Schema 策略级错误9.2 Google Shopping / Amazon 市场情报(DataForSEO Merchant API)
调用前必须先做成本守门(Mandatory Guardrail):
python3 scripts/dataforseo_costs.py check merchant_google_products_search # status 为 approved 才继续;needs_approval 需向用户展示成本;blocked 则停止 python3 scripts/dataforseo_merchant.py search "<keyword>" --marketplace google python3 scripts/dataforseo_merchant.py sellers "<keyword>" python3 scripts/dataforseo_normalize.py results.json --module merchant # 归一化价格/货币/可用性/评分 python3 scripts/dataforseo_costs.py log merchant_google_products_search <cost> # 每次调用后记账Merchant 端点统一按任务/轮询模式计费(标准队列 $0.02/次,相比 live 节省 60–80%),支持location_code(默认 2840=US)、sort_by(relevance / price_low_to_high / price_high_to_low / rating)等参数,完整字段与限流规则见 skills/seo-ecommerce/references/marketplace-endpoints.md 与 skills/seo-dataforseo/references/cost-tiers.md。merchant_amazon_products_search属于warn_endpoints,无论何种预算模式都必须用户确认。
9.3 关键词差距分析(Organic vs Shopping)
对“Organic Only”(有自然排名无 Shopping 广告)的关键词开 Merchant Center feed 竞价;对“Shopping Only”(有 Shopping 可见度但自然排名弱)的关键词补购买指南/对比页;对“Both Present”的优化价格一致性与 Schema;对“Neither”的在量级低时降权处理。
9.4 UCP:面向 AI Agent 交易的声明式能力(前瞻)
Google 主导、Shopify 等联合推出的 UCP(Universal Commerce Protocol)允许商家在/.well-known/ucp声明 checkout、fulfillment、discount 等能力,让 AI Agent 免去一次性集成即可发现、协商并完成交易。仓库提供审计命令:
python3 scripts/ucp_check.py https://store.example.com --json python3 scripts/ucp_check.py https://store.example.com --probe-endpoints --json关于 UCP 的定位、能力 ID 形状(dev.ucp.<domain>.<verb>)与各能力用途,见 skills/seo-ecommerce/references/ucp-universal-commerce-protocol.md。当前属于早期阶段,缺 profile 应视为机会而非失败——尤其对已在 Merchant Center 的商家,是“一个 sprint 即可完成”的前瞻性配置。
9.5 报告输出
seo-ecommerce技能提供标准输出模板:Overall Score(XX/100)+按 Schema(25%)、Title & Meta(15%)、图片(20%)、内容(20%)、内链(10%)、技术(10%)六个维度的分项得分,最终可用/seo google report生成 PDF 报告。
十、总结:一份可执行的电商 SEO 检查总纲
把本文内容收敛为上线前的验收清单:架构上遵循两级分类 + 独立促销/博客入口的 URL 层级;结构化数据上以“必填 50 分 → 满分 100 分”的阶梯补齐name/image/price/priceCurrency/availability与aggregateRating、gtin、shippingDetails、hasMerchantReturnPolicy、review,变体用ProductGroup,且务必服务端渲染;内容上产品页与分类页均 ≥400 词且唯一;工程上处理好分页、分面 noindex 与变体 canonical;AI 时代用结构化规格、对比表格、真实评价与跨平台实体一致性争取 AI 引用,同时守住 AI 生成内容的 IPTC 标注合规线。每一环都可以用schema_ecommerce_validate.py、render_page.py、dataforseo_merchant.py、ucp_check.py等仓库脚本验证闭环。
【免费下载链接】claude-seo
Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.
相关推荐
面向 AI 搜索的 GEO 技术 SEO 审计指南:以 geo-seo-claude 的 geo-technical 智能体为实战框架
面向 AI 搜索的 GEO 技术 SEO 审计指南:以 geo seo claude 的 geo technical 智能体为实战框架 导读 :本文基于 geo
AI 技能AI 应用搜索引擎数据分析Sim 落地页 SEO 与 GEO 工程实践:从标题层级、Schema 结构化数据到 AI 引用优化
Sim 落地页 SEO 与 GEO 工程实践:从标题层级、Schema 结构化数据到 AI 引用优化 这篇指南基于 Sim 仓库中落地页目录的 SEO/GEO
AI Agent人工智能工作流自动化后端前端浏览器控制claude-seo 电商 SEO 分析实战:产品页审计、Google Shopping 市场情报与 Product Schema 校验
claude seo 电商 SEO 分析实战:产品页审计、Google Shopping 市场情报与 Product Schema 校验 本文基于 claude
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考