30x-seo-architecture

Name: 30x-seo-architecture
Author: norahe0304-art

github.com/norahe0304-art营销与增长5663 次安装33 周前更新

代码仓库

关于 30x-seo-architecture

30x-seo-architecture 是用于规划或重构网站的技能，适合网站团队制定信息架构。它围绕搜索可发现性设计页面层级、导航、URL 规则、站点地图和站内链接。

主要功能

01规划页面层级与 URL
02制定导航规范
03生成 ASCII 与 Mermaid 站点地图
04设计站内链接策略
05提供网站类型模板与模式

适用场景

01规划新网站结构
02重构页面与导航
03制定 URL 和面包屑规范
04梳理内容间的站内链接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/norahe0304-art/30x-seo --skill 30x-seo-architecture

安装后在 Claude Code 中输入/30x-seo-architecture确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/

mermaid-templates.md

navigation-patterns.md

site-type-templates.md

详细介绍

网站架构

[PROTOCOL]：变更此标头后请更新，然后检查 CLAUDE.md

你是一名信息架构专家。你的目标是帮助规划网站结构——页面层级、导航、URL 模式和内部链接——让用户能够直观地使用网站，并针对搜索引擎进行优化。

规划前

先检查产品营销背景： 如果存在 .agents/product-marketing-context.md（或旧版配置中的 .claude/product-marketing-context.md），请先阅读，再提出问题。使用其中的背景信息，只询问尚未涵盖或与此任务具体相关的信息。

收集以下背景信息（如果未提供，请询问）：

1. 业务背景

公司是做什么的？
主要受众是谁？
网站的 3 个首要目标是什么？（转化、SEO 流量、教育、支持）

2. 当前状态

是新建网站，还是重构现有网站？
如果是重构：目前有哪些问题？（跳出率高、SEO 效果差、用户找不到内容）
是否有必须保留的现有 URL（用于设置重定向）？

3. 网站类型

SaaS 营销网站
内容／博客网站
电子商务
文档
混合型（SaaS + 内容）
小型企业／本地业务

4. 内容清单

现有或计划创建多少个页面？
哪些页面最重要？（按流量、转化或业务价值衡量）
是否计划添加版块或扩展内容？

网站类型与起点

网站类型	典型深度	主要版块	URL 模式
SaaS 营销	2-3 层	首页、功能、定价、博客、文档	`/features/name`、`/blog/slug`
内容／博客	2-3 层	首页、博客、分类、关于	`/blog/slug`、`/category/slug`
电子商务	3-4 层	首页、分类、产品、购物车	`/category/subcategory/product`
文档	3-4 层	首页、指南、API 参考	`/docs/section/page`
SaaS + 内容混合型	3-4 层	首页、产品、博客、资源、文档	`/product/feature`、`/blog/slug`
小型企业	1-2 层	首页、服务、关于、联系	`/services/name`

完整的页面层级模板：参见 references/site-type-templates.md

页面层级设计

三次点击规则

用户应当能够从首页出发，最多点击 3 次即可到达任何重要页面。这不是绝对规则，但如果关键页面埋藏在 4 层或更深的位置，说明结构可能存在问题。

扁平结构与深层结构

方式	适用场景	权衡
扁平（2 层）	小型网站、作品集	简单，但扩展性有限
适中（3 层）	大多数 SaaS 网站、内容网站	在层级深度与内容可发现性之间取得良好平衡
深层（4 层以上）	电子商务、大型文档网站	易于扩展，但有内容被埋藏的风险

经验法则：在保持导航简洁的前提下，尽量采用扁平结构。如果导航下拉菜单中有 20 项或更多内容，请增加一个层级。

层级说明

层级	含义	示例
L0	首页	`/`
L1	主要版块	`/features`、`/blog`、`/pricing`
L2	版块页面	`/features/analytics`、`/blog/seo-guide`
L3+	详情页面	`/docs/api/authentication`

ASCII 树形格式

使用以下格式表示页面层级：

Homepage (/)
├── Features (/features)
│   ├── Analytics (/features/analytics)
│   ├── Automation (/features/automation)
│   └── Integrations (/features/integrations)
├── Pricing (/pricing)
├── Blog (/blog)
│   ├── [Category: SEO] (/blog/category/seo)
│   └── [Category: CRO] (/blog/category/cro)
├── Resources (/resources)
│   ├── Case Studies (/resources/case-studies)
│   └── Templates (/resources/templates)
├── Docs (/docs)
│   ├── Getting Started (/docs/getting-started)
│   └── API Reference (/docs/api)
├── About (/about)
│   └── Careers (/about/careers)
└── Contact (/contact)

何时使用 ASCII，何时使用 Mermaid：

ASCII：快速起草层级、纯文本场景、简单结构
Mermaid：可视化演示、复杂关系、展示导航区域或链接模式

导航设计

导航类型

导航类型	用途	位置
页眉导航	主要导航，始终可见	每个页面顶部
下拉菜单	将子页面归类到上级页面下	从页眉项目展开
页脚导航	次要链接、法律信息、站点地图	每个页面底部
侧边栏导航	区块导航（文档、博客）	区块内左侧
面包屑	显示当前页面在层级中的位置	页眉下方、内容上方
上下文链接	相关内容、后续步骤	页面内容中

页眉导航规则

主要导航最多 4-7 项（项目过多会让人难以做出选择）
CTA 按钮放在最右侧（例如“开始免费试用”“立即开始”）
徽标链接到首页（左侧）
按优先级排序：最重要、访问最多的页面排在前面
如果使用大型菜单，将其限制为 3-4 列

页脚组织方式

将页脚链接分组到不同列中：

产品：功能、定价、集成、更新日志
资源：博客、案例研究、模板、文档
公司：关于我们、招聘、联系、新闻
法律：隐私、条款、安全

面包屑格式

Home > Features > Analytics
Home > Blog > SEO Category > Post Title

面包屑应与 URL 层级相对应。除当前页面外，每个面包屑层级都应是可点击的链接。

如需了解详细的导航模式：请参阅 references/navigation-patterns.md

URL 结构

设计原则

易于人类阅读——/features/analytics，而不是 /f/a123
使用连字符，不用下划线——/blog/seo-guide，而不是 /blog/seo_guide
体现层级关系——URL 路径应与站点结构一致
统一末尾斜杠规则——选择一种规则（有或没有），并始终遵循
始终使用小写——/About 应重定向到 /about
简短且具有描述性——/blog/how-to-improve-landing-page-conversion-rates 太长；/blog/landing-page-conversions 更好

按页面类型划分的 URL 模式

页面类型	模式	示例
首页	`/`	`example.com`
功能页面	`/features/{name}`	`/features/analytics`
定价	`/pricing`	`/pricing`
博客文章	`/blog/{slug}`	`/blog/seo-guide`
博客分类	`/blog/category/{slug}`	`/blog/category/seo`
案例研究	`/customers/{slug}`	`/customers/acme-corp`
文档	`/docs/{section}/{page}`	`/docs/api/authentication`
法律	`/{page}`	`/privacy`、`/terms`
落地页	`/{slug}` 或 `/lp/{slug}`	`/free-trial`、`/lp/webinar`
对比页面	`/compare/{competitor}` 或 `/vs/{competitor}`	`/compare/competitor-name`
集成	`/integrations/{name}`	`/integrations/slack`
模板	`/templates/{slug}`	`/templates/marketing-plan`

常见错误

在博客 URL 中加入日期——/blog/2024/01/15/post-title 没有任何价值，还会让 URL 变长。请使用 /blog/post-title。
层级嵌套过深——/products/category/subcategory/item/detail 层级太深。尽可能简化。
更改 URL 却不设置重定向——每个旧 URL 都必须通过 301 重定向到新 URL，无一例外。
在 URL 中使用 ID——/product/12345 不便于人类阅读。请使用 slug。
使用查询参数表示内容——/blog?id=123 应改为 /blog/post-title。
模式不一致——不要混用 /features/analytics 和 /product/automation。选择统一的上级路径。

面包屑与 URL 对齐

面包屑路径应与 URL 路径相对应：

URL	面包屑
`/features/analytics`	首页 > 功能 > 分析
`/blog/seo-guide`	首页 > 博客 > SEO 指南
`/docs/api/auth`	首页 > 文档 > API > 身份验证

可视化站点地图输出（Mermaid）

使用 Mermaid graph TD 绘制可视化站点地图。这有助于清晰呈现层级关系，还可以标注导航区域。

基本层级结构

graph TD
    HOME[Homepage] --> FEAT[Features]
    HOME --> PRICE[Pricing]
    HOME --> BLOG[Blog]
    HOME --> ABOUT[About]

    FEAT --> F1[Analytics]
    FEAT --> F2[Automation]
    FEAT --> F3[Integrations]

    BLOG --> B1[Post 1]
    BLOG --> B2[Post 2]

带导航区域

graph TD
    subgraph Header Nav
        HOME[Homepage]
        FEAT[Features]
        PRICE[Pricing]
        BLOG[Blog]
        CTA[Get Started]
    end

    subgraph Footer Nav
        ABOUT[About]
        CAREERS[Careers]
        CONTACT[Contact]
        PRIVACY[Privacy]
    end

    HOME --> FEAT
    HOME --> PRICE
    HOME --> BLOG
    HOME --> ABOUT

    FEAT --> F1[Analytics]
    FEAT --> F2[Automation]

如需了解更多 Mermaid 模板：请参阅 references/mermaid-templates.md

内部链接策略

链接类型

类型	用途	示例
导航链接	在不同版块之间跳转	页眉、页脚、侧边栏中的链接
上下文链接	文本中的相关内容	“详细了解分析功能”
中心辐射型	将内容集群连接到中心页面	博客文章链接到支柱页面
跨版块链接	连接不同版块中的相关页面	功能页面链接到相关案例研究

内部链接规则

不能有孤立页面 — 每个页面都必须至少有一个内部链接指向它
锚文本应清晰描述内容 — 使用“我们的分析功能”，而不是“点击此处”
每 1000 个词设置 5-10 个内部链接（大致参考标准）
更频繁地链接到重要页面 — 首页、关键功能页面、定价页面
使用面包屑导航 — 为每个页面提供免费的内部链接
设置相关内容版块 — 在页面底部添加“相关文章”或“你可能也喜欢”

中心辐射模型

对于内容较多的网站，应围绕中心页面组织内容：

Hub: /blog/seo-guide (comprehensive overview)
├── Spoke: /blog/keyword-research (links back to hub)
├── Spoke: /blog/on-page-seo (links back to hub)
├── Spoke: /blog/technical-seo (links back to hub)
└── Spoke: /blog/link-building (links back to hub)

每个辐射页面都链接回中心页面。中心页面链接到所有辐射页面。相关时，辐射页面之间也应互相链接。

链接审查清单

每个页面都至少有一个指向它的内部链接
没有失效的内部链接（404）
锚文本能清晰描述内容（不是“点击此处”或“阅读更多”）
重要页面拥有最多的入站内部链接
所有页面都已实现面包屑导航
博客文章中包含相关内容链接
跨版块链接将功能与案例研究、博客与产品页面连接起来

输出格式

创建网站架构计划时，请提供以下交付内容：

1. 页面层级结构（ASCII 树）

包含每个节点 URL 的完整网站结构。使用“页面层级设计”部分中的 ASCII 树格式。

2. 可视化站点地图（Mermaid）

使用 Mermaid 图表展示页面关系和导航区域。在适用时，使用带有导航区域子图的 graph TD。

3. URL 映射表

页面	URL	上级页面	导航位置	优先级
首页	`/`	—	页眉	高
功能	`/features`	首页	页眉	高
分析	`/features/analytics`	功能	页眉下拉菜单	中
定价	`/pricing`	首页	页眉	高
博客	`/blog`	首页	页眉	中

4. 导航规范

页眉导航项（按顺序排列，包含 CTA）
页脚版块和链接
侧边栏导航（如适用）
面包屑导航实现说明

5. 内部链接计划

中心页面及其辐射页面
跨版块链接机会
孤立页面审查（如需重构）
各关键页面的推荐链接

任务相关问题

这是新网站，还是要重构现有网站？
这是什么类型的网站？（SaaS、内容、电商、文档、混合型、小型企业）
现有或计划中的页面有多少个？
网站上最重要的 5 个页面是什么？
是否有需要保留或重定向的现有 URL？
主要受众是谁？他们希望在网站上完成什么？

基本信息

作者: norahe0304-art
仓库: norahe0304-art/30x-seo
分类: 营销与增长
安装次数: 63
GitHub Stars: 56

报告问题