如何用 Codex 检查商品页面 SEO

很多商品页面没有明显错误，但搜索表现一直上不去。问题通常不在于少写了几个关键词，而在于页面里的商品信息、标题描述、图片、结构化数据和索引配置互相对不上。 例如页面上显示“有货”，JSON-LD 里却是缺货；商品图没有 alt；多个规格页面共用同一个 title；canonical 指向错误页面；移动端页面缺少桌面端已有的商品描述。人工逐页检查很慢，用 Codex 的价值就是让它进入项目目录，按统一规则读取代码、模板、数据文件和页面快照，输出一份可执行的 SEO 问题清单。

先说清楚：Codex 不是搜索排名预测软件

Codex 适合做的是代码层、模板层、内容结构层和数据一致性检查。它可以帮你找出商品页里可修复的问题，但不能保证某个页面一定排名上涨。商品页面 SEO 仍然需要真实搜索数据、商品竞争力、价格、库存、品牌信任和用户行为共同决定。

• 适合交给 Codex：检查 title、description、H1、canonical、robots、结构化数据、图片 alt、内链、面包屑、商品字段一致性。

• 不适合完全交给 Codex：判断真实搜索需求、决定商品定价、预测排名、替代 Search Console 和真实转化数据。

• 更合理的用法：让 Codex 先发现页面问题，再由运营、SEO 和开发决定哪些问题优先修。

商品页面 SEO 要检查哪些内容

商品页面不是普通文章页。文章页重点是内容覆盖和阅读体验，商品页还要解决价格、库存、规格、图片、评价、配送、退换、结构化数据和购买路径。下面这张表可以作为 Codex 的检查维度。

为什么商品页面 SEO 容易乱

• 商品页通常由模板生成，一个模板问题会影响几百甚至几千个页面。

• 商品信息来自 CMS、ERP、Shopify、WooCommerce、数据库或接口，页面显示和结构化数据很容易不同步。

• 运营经常只改页面文案，没有同步改 meta、alt、SKU 描述和 JSON-LD。

• 多规格商品容易产生大量相似页面，导致标题重复、内容重复和 canonical 混乱。

• 商品上下架后，页面可能仍然可访问，但库存、跳转、推荐链接和 sitemap 没有同步更新。

开始前要准备什么文件

不要只给 Codex 一句“帮我检查商品页 SEO”。更稳的方式是先把商品页相关资料放进一个目录，让 Codex 有明确输入。

/seo-product-audit

/pages

product-url-list.csv # 待检查商品 URL 列表

product-snapshots/ # 可选：页面 HTML 快照

/data

products.csv # 商品基础数据：名称、SKU、价格、库存、分类、品牌

categories.csv # 分类层级

/src

product-template-paths.md # 商品页相关模板、组件、路由说明

/rules

seo-rules.md # 商品页 SEO 规则

structured-data-rules.md # Product JSON-LD 字段要求

/output

product-seo-audit.md # Codex 输出报告

fix-plan.md # 修复计划

如果你是 Next.js 项目，可以让 Codex 重点检查 app/products/[slug]/page.tsx、商品详情组件、metadata 生成函数、JSON-LD 组件、商品数据接口和 sitemap 生成逻辑。如果你是 Shopify 或 WordPress 项目，则重点检查商品模板、主题文件、SEO 插件输出、结构化数据插件和商品字段。

第一步：让 Codex 先盘点商品页生成链路

商品页 SEO 的错误通常不是一个页面的问题，而是生成链路的问题。先让 Codex 找出商品页面是从哪里生成的。

你现在在一个电商项目中。请先不要修改代码，只做商品页面 SEO 相关链路盘点。

目标：

1. 找出商品详情页的路由、模板、组件、metadata 生成逻辑、JSON-LD 输出逻辑、sitemap 生成逻辑。

2. 找出商品数据来源，包括商品名、品牌、价格、库存、SKU、分类、图片、评价、规格字段来自哪里。

3. 判断商品页面是否存在统一 SEO 规则文件，如果没有，请说明应该补充哪些规则。

限制：

- 不要改代码。

- 不要猜测业务字段含义，找不到就标记为“未确认”。

- 输出时按“文件路径 / 作用 / 可能影响的 SEO 项 / 风险等级”整理。

输出：

请生成 /seo-product-audit/output/product-page-map.md。

第二步：检查 title、description、H1 是否一致

商品页的标题不是越长越好，也不是简单堆商品名。Codex 应该检查的是：每个商品页是否有唯一 title，是否包含商品名和关键规格，description 是否说明商品用途和购买理由，H1 是否和页面主商品一致。

请检查商品详情页的 title、meta description、H1 生成逻辑。

请重点检查：

1. title 是否能保证每个商品页唯一。

2. title 是否包含商品名、品牌或关键规格，但没有关键词堆砌。

3. meta description 是否来自商品真实卖点，而不是所有页面共用模板。

4. H1 是否与当前商品一致，是否出现多个 H1。

5. 缺失商品名、品牌、分类、规格时，代码是否有安全 fallback。

请输出：

- 当前生成规则摘要

- 发现的问题

- 受影响文件

- 示例问题页面或示例 SKU

- 建议修改方案

只输出审查报告，不要直接修改代码。

第三步：检查 Product 结构化数据

商品页如果要争取更丰富的搜索展示，结构化数据很关键。对于可购买商品，通常要检查 Product 与 Offer；如果页面是商品评测或导购内容，则可能更偏 Product snippets。Codex 的任务不是“随便加 schema”，而是检查页面可见信息与 JSON-LD 是否一致。

请审查商品页的 Product 结构化数据实现。

目标：

1. 找出 JSON-LD 输出位置和生成函数。

2. 检查 Product、Offer、AggregateRating、Review、BreadcrumbList 是否只在有真实数据时输出。

3. 对比页面可见信息和 JSON-LD 字段是否一致：商品名、图片、价格、库存、品牌、SKU、评分。

4. 检查是否存在所有商品共用同一段 JSON-LD、价格写死、库存写死、图片使用站点 logo 的问题。

5. 检查是否可以通过脚本批量抽取页面 JSON-LD 并输出差异报告。

限制：

- 不要编造评分、评论、库存、价格或 GTIN。

- 没有真实数据时，不要为了“字段完整”强行生成。

- 不要改变页面视觉样式。

输出：

请生成 /seo-product-audit/output/structured-data-audit.md，包含问题清单、风险等级、受影响字段和建议修复方式。

第四步：检查 canonical、noindex 和变体页

商品规格页最容易产生 SEO 混乱。同一个商品有颜色、尺码、容量、套餐，可能产生很多 URL。Codex 要检查的是：哪些 URL 应该独立收录，哪些应该 canonical 到主商品页，哪些筛选参数不应该进入索引。

请检查商品详情页、商品变体页、筛选参数页的索引控制逻辑。

请检查：

1. canonical 是否指向当前商品的正确规范 URL。

2. 颜色、尺码、容量等变体页是否有明确收录策略。

3. URL 参数页是否被错误写入 sitemap。

4. 下架商品、缺货商品、删除商品是否有统一处理策略。

5. 是否存在 noindex 与 canonical 冲突。

6. 商品页是否被 robots.txt 或中间件误拦截。

输出格式：

- 问题类型

- 示例 URL 或代码路径

- 当前行为

- SEO 风险

- 建议修复方式

- 是否需要人工确认

第五步：检查图片 alt 和商品图信息

商品页图片不是装饰图。主图、细节图、场景图、规格图都能帮助搜索引擎和用户理解商品。Codex 可以检查 img 标签、图片组件、alt 生成逻辑和数据源。

请检查商品页所有图片的 SEO 与可访问性问题。

范围：

- 主商品图

- 商品详情图

- 规格图

- 颜色/款式缩略图

- 推荐商品图

- Open Graph 图片

检查项：

1. img 是否有 alt。

2. alt 是否能描述当前商品，而不是空字符串、文件名、关键词堆砌。

3. 主图 alt 是否包含商品名和关键规格。

4. 装饰性图片是否合理使用空 alt。

5. 移动端是否保留与桌面端一致的图片 alt。

6. 图片 URL 是否稳定，是否存在运行时随机 URL 导致搜索引擎难以索引。

输出：

生成 /seo-product-audit/output/image-seo-audit.md。

第六步：检查分类、面包屑和内链

商品页要被搜索引擎理解，不能只靠页面自己。分类页、面包屑、相关推荐、品牌页、文章内容页都应该把商品放进一个清晰的站内结构里。

请检查商品页的站内链接结构。

重点：

1. 商品页是否有面包屑，面包屑层级是否与分类数据一致。

2. 商品页是否链接到所属分类、品牌页、相关商品或搭配内容。

3. 分类页是否能稳定链接到商品详情页。

4. 推荐商品模块是否有规则，是否可能推荐已下架商品。

5. 站内链接 anchor 是否可读，而不是“点击这里”或纯图片无文本。

6. 是否存在孤岛商品页。

输出：

请给出“现状 / 问题 / 建议 / 可自动修复项 / 需要人工确认项”。

第七步：让 Codex 批量输出商品页 SEO 审查报告

当你已经有 URL 列表、商品数据和代码路径后，可以让 Codex 生成脚本批量检查。这个阶段不一定直接改代码，先输出报告更安全。

请基于 /seo-product-audit/pages/product-url-list.csv 和项目代码，生成一个商品页面 SEO 批量检查脚本。

脚本目标：

1. 读取 URL 列表或本地 HTML 快照。

2. 抽取 title、meta description、H1、canonical、robots、JSON-LD、主图 alt、面包屑。

3. 对比 /seo-product-audit/data/products.csv 中的商品名、SKU、价格、库存、品牌、分类。

4. 输出 CSV 和 Markdown 两份报告。

5. 对每个页面标记风险等级：High / Medium / Low。

限制：

- 不要请求需要登录的后台页面。

- 不要修改线上数据。

- 如果无法访问页面，标记为 fetch_failed，不要中断整个脚本。

完成标准：

- 脚本可运行。

- 输出 /seo-product-audit/output/product-seo-audit.csv。

- 输出 /seo-product-audit/output/product-seo-audit.md。

- 报告中必须有“优先修复的前 20 个问题”。

可直接复制的 Codex 一键审查指令

下面这条适合直接丢给 Codex。建议先在 Ask Mode 或只读模式跑一次，确认它理解项目结构后，再允许它生成脚本或提交修复。

请对当前项目做一次商品页面 SEO 审查。先不要修改代码，先输出完整问题报告。

背景：

这是一个电商或商品展示项目，商品详情页承担自然搜索流量和转化。我要检查商品页面是否存在 SEO 基础问题、结构化数据错误、索引风险、图片 alt 缺失、商品信息不一致和内链结构混乱。

你需要检查的范围：

1. 商品详情页路由、模板、组件和 metadata 生成逻辑。

2. title、meta description、H1、canonical、robots、Open Graph 信息。

3. Product / Offer / AggregateRating / Review / BreadcrumbList 等结构化数据。

4. 商品名、SKU、品牌、价格、库存、分类、图片、评分等字段是否和页面可见内容一致。

5. 商品主图和详情图的 alt、文件名、尺寸和移动端一致性。

6. 分类、面包屑、相关推荐、品牌页、文章页到商品页的内链关系。

7. 商品变体、缺货、下架、删除、参数页、分页和 sitemap 的收录策略。

工作方式：

- 先盘点相关文件路径，不要直接改代码。

- 对每类问题给出示例文件、示例字段或示例页面。

- 能从代码确认的就写“已确认”；只能推测的写“需人工确认”。

- 不要编造商品数据、评分、库存或评论。

- 不要为了 SEO 添加虚假结构化数据。

输出要求：

请生成 /seo-product-audit/output/product-seo-audit.md，结构如下：

1. 商品页生成链路摘要

2. SEO 基础标签问题

3. Product 结构化数据问题

4. 商品信息一致性问题

5. 图片 SEO 问题

6. canonical / noindex / sitemap 问题

7. 内链和面包屑问题

8. 移动端一致性问题

9. 风险等级排序

10. 前 20 个优先修复项

11. 可自动修复项

12. 需要人工确认项

13. 建议的下一步 Codex 修复指令

Codex 低风险修复指令

审查完成后，不要一次性让 Codex 大改所有 SEO 逻辑。商品页影响转化和收录，应该先做低风险修复。

请根据 /seo-product-audit/output/product-seo-audit.md 只执行低风险修复。

允许修复：

1. 补齐缺失但已有真实数据来源的 title、description、H1 fallback。

2. 修复明显错误的图片 alt 生成逻辑。

3. 修复 JSON-LD 中与页面字段不同步的映射错误。

4. 修复 canonical 生成中的明显路径错误。

5. 补充缺失的 BreadcrumbList，前提是分类数据已存在。

6. 增加单元测试或快照测试，验证 SEO 字段输出。

禁止修复：

1. 不要改价格、库存、评分、评论等业务数据。

2. 不要新增虚假的评论、评分、GTIN、库存状态。

3. 不要改变页面视觉布局。

4. 不要批量 noindex 或删除 URL。

5. 不要修改支付、购物车、订单逻辑。

完成标准：

- 列出改动文件。

- 说明每个改动解决了哪个 SEO 问题。

- 运行现有测试、lint 或 build。

- 如果没有测试，请新增最小验证脚本或说明无法验证的原因。

AGENTS.md 商品页 SEO 规则示例

如果你经常让 Codex 处理商品页，可以把下面这类规则放进 AGENTS.md，减少它每次都重新猜项目规范。

# 商品页面 SEO 规则

## 商品数据真实性

- 不允许编造价格、库存、SKU、GTIN、评分、评论、销量、发货时间。

- 结构化数据必须来自页面可见内容或可信数据源。

- 没有真实数据时，不要为了字段完整而输出虚假 schema。

## 商品页 metadata

- 每个商品页必须有唯一 title。

- title 应包含商品名，并在有真实数据时包含品牌或关键规格。

- meta description 应说明商品用途、核心卖点或购买理由，不允许所有商品共用同一段描述。

- H1 应与当前商品一致，页面默认只允许一个 H1。

## 结构化数据

- 可购买商品优先检查 Product + Offer。

- 价格、库存、货币、商品名、图片必须和页面展示一致。

- 评分和评论只有在有真实数据时才输出。

- 修改 JSON-LD 后必须运行结构化数据检查脚本或给出验证步骤。

## 索引与链接

- 不得随意添加 noindex。

- 不得批量修改 canonical，除非有明确变体页策略。

- 商品页应能从分类、品牌、推荐或内容页中被链接到。

- 下架、缺货和删除商品必须按业务规则处理，不允许自行决定。

## 验收

- 修复后必须输出改动文件、风险说明和验证结果。

- 如果涉及大量商品页，先抽样 5-10 个页面验证，再扩大范围。

商品页面 SEO 报告模板

好的 Codex 输出不应该是一段笼统建议，而应该是一份能分配给开发、运营和 SEO 的问题清单。

验收标准

• 每个商品页有唯一、可读、和商品一致的 title 与 H1。

• meta description 不是全站共用模板，至少能反映商品类型、用途或卖点。

• Product / Offer 结构化数据的名称、图片、价格、库存、货币与页面可见内容一致。

• 没有把虚假评分、虚假评论、虚假库存写进结构化数据。

• 商品主图和关键详情图有描述性 alt，移动端和桌面端保持一致。

• canonical、noindex、robots、sitemap 没有互相冲突。

• 商品页能从分类、品牌、面包屑、推荐或内容页中被正常访问到。

• 下架、缺货、删除、变体页有明确处理规则。

• Codex 输出的问题清单能按 High / Medium / Low 排序，并能分配给具体角色处理。

常见错误

FAQ

Q1：Codex 能直接帮我提升商品页排名吗？

不能保证。Codex 能帮你发现和修复商品页 SEO 的基础问题，比如结构化数据错误、标题重复、图片 alt 缺失、canonical 混乱。但排名还受搜索需求、商品竞争力、品牌、价格、内容质量和外部信号影响。

Q2：商品页面一定要加 Product 结构化数据吗？

不是强制，但对商品页很有价值。可购买商品通常应该优先检查 Product 与 Offer，评测类页面则要区分 Product snippets。重点是数据真实且与页面内容一致。

Q3：缺货商品应该 noindex 吗？

不能一刀切。短期缺货、长期缺货、永久下架、替代商品推荐的处理方式不同。Codex 可以帮你盘点当前逻辑，但最终策略要由业务和 SEO 决定。

Q4：商品图 alt 要不要堆关键词？

不要。alt 应该描述图片内容和商品关系，例如商品名、颜色、关键规格或使用场景。关键词堆砌会降低用户体验，也不利于页面质量。

Q5：如果商品很多，Codex 怎么批量检查？

准备 URL 列表、商品数据 CSV 和页面 HTML 快照，让 Codex 写脚本抽取 title、description、H1、canonical、JSON-LD、alt、面包屑，再和商品数据源对比。

Q6：Codex 修复后还需要人工看吗？

需要。尤其是价格、库存、下架规则、canonical 策略、结构化数据字段和商品卖点描述，都应该由开发、运营和 SEO 至少抽样复核。

总结

用 Codex 检查商品页面 SEO，核心不是让它“写几句更吸引人的商品文案”，而是让它系统检查商品页背后的代码、模板、数据源和页面输出。商品页 SEO 最容易出问题的地方，通常正是人工不愿意一页页核对的地方：结构化数据、canonical、图片 alt、变体页、sitemap、下架状态和页面字段一致性。

最稳的流程是：先让 Codex 盘点商品页生成链路，再输出问题报告，然后只执行低风险修复，最后用脚本、抽样页面和搜索工具做验收。这样 Codex 才不是一个临时问答工具，而是一个能沉淀到项目里的商品页 SEO 审查流程。

参考资料

• OpenAI Developers：Codex。https://developers.openai.com/codex

• OpenAI Developers：Codex CLI。https://developers.openai.com/codex/cli

• OpenAI Developers：Custom instructions with AGENTS.md。https://developers.openai.com/codex/guides/agents-md

• OpenAI Developers：Best practices - Codex。https://developers.openai.com/codex/learn/best-practices

• Google Search Central：Introduction to Product structured data。https://developers.google.com/search/docs/appearance/structured-data/product

• Google Search Central：Product snippet structured data。https://developers.google.com/search/docs/appearance/structured-data/product-snippet

• Google Search Central：Merchant listing structured data。https://developers.google.com/search/docs/appearance/structured-data/merchant-listing

• Google Search Central：Image SEO best practices。https://developers.google.com/search/docs/appearance/google-images

• Google Search Central：Mobile-first indexing best practices。https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing