本案例演示如何通过 Codex 优化现有站点的 SEO 结构,包括 TDK 元标签优化、Sitemap 生成及搜索引擎友好度提升。
1. 任务背景
一个刚上线的静态教程站,首页内容已初步完成,但搜索引擎抓取效果不佳:标题过短、缺失 Description、且没有 Sitemap 供爬虫索引。
2. 第一步:SEO 现状只读分析
在修改前,先让 Codex 评估当前页面的 SEO 水平。
Prompt 示例:
``text
请先只读分析当前项目首页文件(如 docs/index.md),不要修改。
请评估:
- 当前的 Title, Description, Keywords (TDK) 是否完整。
- 优化 TDK 元标签:Title 设置为“Codex 喂饭级教程 | 面向中文开发者的 AI 编程指南”,Description 包含核心关键词。
- 只修改首页文件和全局配置文件,不要动具体的教程内容页。
- 检查 package.json 是否有 vite-plugin-sitemap 或类似依赖。
- 查看构建后的 dist
目录,确认是否存在sitemap.xml和robots.txt。 - 使用浏览器开发者工具查看首页源码,确认
和` 已更新。
2. 页面 H1, H2 标题层级是否合理。
3. 图片是否有 alt 属性。
4. 项目中是否已配置 sitemap 生成工具。
`
3. 第二步:制定 SEO 优化计划
根据分析结果,给 Codex 下达具体的结构化指令。
Prompt 示例:
`text
请帮我优化首页的 SEO 结构。
目标:
2. 确保首页有且仅有一个 H1 标签。
3. 为首页所有 image 标签补充描述性的 alt 属性。
4. 在项目中配置 sitemap 生成插件(如果是 VitePress,请修改 config.mjs)。
限制:
2. 严禁引入不兼容的第三方 SEO 插件。
`
4. 第三步:生成与验证 Sitemap
对于静态站点,Sitemap 的自动化生成是关键。
Prompt 示例:
`text
请为我的 VitePress 项目配置 sitemap 插件。
2. 如果没有,请先告诉我需要执行的安装命令。
3. 如果已有,请在 config.mjs 中配置生成逻辑,确保生成的 URL 包含正确的 hostname。
`
5. 结果验收
---
下一篇推荐:实战案例:让 Codex 补 README 或使用说明 —— 提升项目文档的专业度与易读性。