大家好，我是程序员柏风，AI 最全的 Vibecoding 学习地图 http://coderoadmap.cn 作者。
SEO 与关键词
技术文档也要 被找到。SEO 不是堆关键词，而是让搜索意图、页面结构与内链共同服务真实读者——尤其是长尾的「怎么做 X」查询。
学习目标
- 理解搜索意图与长尾关键词在技术文档中的价值
- 掌握 Title、Meta、OpenGraph 基础优化
- 建立 Topic Cluster 与 Topic Score 的直觉
核心概念
搜索意图四型
| 意图 | 查询示例 | 文档类型 |
|---|---|---|
| 信息型 | Spring Boot REST 是什么 | Concepts / Explanation |
| 导航型 | CodeRoadMap API docs | 站点结构、面包屑 |
| 交易型 | 注册开发者账号 | Landing / Sign-up |
| 商业调研 | tracks API vs GraphQL | 对比文、Pillar |
技术写作者主攻 信息型 + 导航型；与 Marketing 协作覆盖商业调研。
长尾关键词
短尾 — 「REST API」（竞争激烈）
长尾 — 「Spring Boot POST JSON 返回 201 示例」（转化高）
选词三问：读者是谁、完成什么任务、用什么动词（install、configure、migrate、troubleshoot）。
页面 SEO 清单
- Title：
动作 + 对象 + 品牌（≤60 字符） - Meta description：一句价值 + CTA（≤160 字符）
- H1 唯一，H2 含相关词但可读
- OpenGraph / Twitter Card：分享预览图与摘要
Topic Cluster
Pillar — 「CodeRoadMap API 完整指南」
Cluster — Quickstart、Auth、Tracks CRUD、Rate Limit、Errors
内链 — Cluster 互指 + 回链 Pillar
Topic Score（或类似工具）帮助发现 已覆盖 vs 缺口 主题；缺口优先写 How-to 与 FAQ。
练习
- 为 tracks API 列出 5 个长尾关键词及对应页面类型
- 写一条 Title + Meta description（中文或英文均可）
- 画 Topic Cluster：1 个 Pillar + 4 个 Cluster 标题
小结
SEO = 意图匹配 + 结构清晰 + 内链；写给人看，顺便给搜索引擎索引。 下一课深化写作结构与风格指南。