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 = 意图匹配 + 结构清晰 + 内链；写给人看，顺便给搜索引擎索引。 下一课深化写作结构与风格指南。