mcpField
S
site-architecture

site-architecture

github.com/borghei营销与增长1.0k89 次安装1 周前更新
代码仓库

关于 site-architecture

用于规划新网站、审查现有结构、优化内链和调整 URL 的网站架构技能。涵盖导航、主题集群、抓取深度和重定向规划。

主要功能

  1. 01规划 URL 层级
  2. 02优化导航结构
  3. 03构建主题集群与内容孤岛
  4. 04审查内链和孤立页面
  5. 05规划 URL 迁移与重定向

适用场景

  1. 01设计新网站的信息架构
  2. 02查找现有网站的孤立页面
  3. 03改善中心页与主题页之间的链接
  4. 04为网站改版规划 URL 变更

安装

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

$npx skills add https://github.com/borghei/claude-skills --skill site-architecture

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

包含的文件

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

scripts/
link_mapper.py
redirect_checker.py
sitemap_analyzer.py

详细介绍

网站架构与内部链接

面向生产环境的网站架构框架，涵盖 URL 层级设计、内部链接策略、导航优化、内容孤岛结构和抓取权重管理。可用于架构审计、新网站规划和现有网站重构。

目录

首先明确需求

生成架构前，请确认以下输入。如果有任何一项未知或含糊，请提问——不要自行假设：

  • 运行模式 — 审计现有网站、规划新网站、优化内部链接，或重构 URL — 决定要生成的交付成果
  • 网站类型 — SaaS、电子商务、博客／内容、本地网站、文档网站或市场平台 — 决定 URL 模式和架构模板
  • 核心主题／内容孤岛 — 网站涵盖的 3-7 个主题集群 — 用于制定中心辐射式结构和内部链接计划
  • 现有 URL／抓取数据 — 网站地图或 URL 导出文件 — 审计和重定向映射所必需

停止规则：只询问最可能影响输出的 2-3 项。如果用户说“直接起草”，请继续，并在交付成果开头列出你的假设。

运行模式

模式 1：审计现有架构

评估现有网站的结构。分析深度分布、孤立页面、链接权重流向和导航效果。

模式 2：规划新架构

从零开始搭建或进行全面改版。将业务目标映射到网站分区，设计 URL 层级，规划导航并定义内容孤岛。

模式 3：优化内部链接

结构没有问题，但需要改善链接权重流向。识别中心页面、映射辐射内容、修复孤立页面并优化锚文本。

模式 4：重构 URL

更改现有网站的 URL。规划新结构、创建重定向映射并管理迁移。

URL 结构设计

层级深度指南
深度示例适用场景SEO 影响
1 级（扁平）/cold-email-tips博客文章、独立页面每个页面获得的抓取权重最佳
2 级/email-marketing/cold-email-tips分类本身是可参与排名的页面良好，分类页面会积累权威度
3 级/solutions/marketing/email-automation产品系列、嵌套服务如果每一层都有内容，则可以接受
4 级以上/a/b/c/d/page绝不使用权重稀释、用户体验差、抓取问题

**决策规则：**如果中间目录 URL（/email-marketing/）不会成为包含自身内容和排名目标的真实页面，就不要创建该目录。扁平结构胜过空洞的层级结构。

URL 构建规则
规则好的示例不好的示例原因
使用连字符/seo-audit/seo_audit对 Google 而言，下划线不是单词分隔符
描述清晰/pricing/pricing-page多余的后缀没有任何作用
保持简短/guides/technical-seo/guides/technical-seo-audit-checklist-complete-guide可读性很重要
包含关键词/guides/seo-audit/guides/article?id=4827描述清晰的 URL 排名更好
统一是否使用尾部斜杠二选一：/about 或 /about/两种混用不一致会造成重复内容
使用小写/about-us/About-Us大小写敏感性因服务器而异
按网站类型划分的 URL 模式
网站类型模式示例
SaaS/features/[feature], /solutions/[use-case], /integrations/[partner]/features/analytics, /solutions/marketing, /integrations/slack
电商/[category]/[subcategory]/[product]/mens/shoes/running-shoes-pro
博客／内容/blog/[slug] 或 /blog/[category]/[slug]/blog/seo-audit-guide
本地商家/[service]/[location]/plumbing/austin-tx
文档/docs/[section]/[page]/docs/api/authentication
市场平台/[category]/[listing]/designers/john-smith

导航架构

导航区域

每个网站都有 6 个导航区域，各自用途不同，对 SEO 的影响权重也不同。

区域项目SEO 权重设计规则
主导航最多 5-8 项高（全站权重）仅放置你希望获得排名的页面。没有落地页时，绝不要放置“资源”。
次级导航每个版块 3-7 项中版块／内容集群内的子导航
面包屑动态高（向上权重）每个非首页页面都应设置。每个层级都必须是真实链接。
页脚导航最多 8-15 项低至中仅放置重要页面。不要把它当作所有页面的堆放处。
上下文导航（内容内）每页 3-5 项最高最强有力的信号。在正文内容中自然嵌入的编辑性链接。
侧边栏5-10 项低至中相关内容、分类列表
主导航设计

规则：

  • 最多 5-8 项。从 9 项及以上开始会造成认知负担。
  • 每个导航项都应链接到你积极希望获得排名的页面。
  • 可以使用下拉菜单，但父级项目必须是可点击、可抓取的链接（不能只是悬停触发器）。
  • 不要将实用页面（Contact、Privacy、Terms）放在主导航中——它们应放在页脚。
  • 移动端导航必须展示与桌面端相同的结构（不能隐藏关键页面）。
面包屑实现

为每个非首页页面添加面包屑。它们有三个作用：

  1. UX：向用户显示其在层级结构中的位置
  2. SEO：创建全站向上的内部链接，指向中心页／分类页
  3. 富媒体搜索结果：启用 BreadcrumbList 架构，以便在 SERP 中显示面包屑

格式： Home > Category > Subcategory > Current Page

规则：

  • 每个面包屑层级都必须是真实、可抓取的链接
  • 绝不要将面包屑设置为带样式但没有链接的文本
  • 在可见面包屑旁添加 BreadcrumbList 架构标记
  • 面包屑层级应与 URL 层级一致

内容集群与主题集群结构

中心辐射模型

内容集群是围绕一个主题构建的独立内容组，其中所有页面彼此链接，并链接到一个中心页。

                    ┌──────────────────┐
                    │     HUB PAGE     │
                    │   /seo/          │
                    │   (Pillar content)│
                    └────────┬─────────┘
            ┌────────────────┼────────────────┐
       ┌────┴────┐      ┌───┴────┐      ┌────┴────┐
       │ SPOKE 1 │      │ SPOKE 2│      │ SPOKE 3 │
       │technical│      │on-page │      │  link   │
       │  seo    │      │  seo   │      │building │
       └────┬────┘      └───┬────┘      └────┬────┘
            │                │                │
       Cross-links     Cross-links      Cross-links
       between         between          between
       related         related          related
       spokes          spokes           spokes
构建主题集群

步骤 1： 确定网站的 3-7 个核心主题（这些将成为你的内容集群）

步骤 2： 针对每个主题创建一个全面介绍该主题的支柱页面（中心页）

步骤 3： 针对每个重要子问题或子主题创建辐射内容

步骤 4： 实施链接：

  • 中心页向下链接到每个辐射页
  • 每个辐射页向上链接到中心页（使用包含丰富关键词的锚文本）
  • 同一内容集群内的辐射页横向链接到相关辐射页
  • 上下文自然时，可以跨内容集群链接

步骤 5： 先构建内容，再构建链接。链接到不存在的内容毫无用处。

内容集群深度指南
内容集群规模建议深度结构
3-5 个辐射页扁平中心页 + 辐射页，均处于同一层级
6-15 个辐射页浅层嵌套中心页 > 子中心页 > 辐射页
16-50 个辐射页两层中心页 > 分类子中心页 > 单个辐射页
50 个以上辐射页分页中心页 > 分类子中心页 > 分页的辐射页列表

内部链接策略

链接权重分配策略

并非所有内部链接的权重都相同。按权重从高到低排列：

排名链接类型权重使用时机
1正文中的上下文链接最高正文内容中的自然编辑链接
2中心页链接高支柱页面链接到其所有分支页面
3导航链接中全站统一，但因普遍存在而权重被稀释
4面包屑链接中向上导流权重，且保持一致
5页脚链接低全站统一，Google 会降低其权重
6侧边栏链接低通常不属于主要内容流
锚文本策略
类型示例用法信号强度
部分匹配"有效的冷邮件策略"首选方式（链接的 60-70%）强
完全匹配"冷邮件模板"谨慎使用（链接的 10-15%）强，但过度使用有风险
品牌词"我们的邮件指南"自然变化（10-15%）中等
描述性"这份全面的指南"自然变化（5-10%）弱，但自然
通用词"点击此处"、"了解更多"避免（< 5%）无——浪费信号
裸 URLhttps://example.com/guide内部链接中绝不使用无
孤立页面检测与处理

孤立页面已被 Google 编入索引，但没有任何入站内部链接。它在网站的链接图谱中不可见。

检测方法：

  1. 导出所有已编入索引的 URL（GSC Coverage 或 site: 查询）
  2. 导出所有内部链接目标（抓取工具或链接提取）
  3. 集合 A 中存在、集合 B 中不存在的页面即为孤立页面

处理措施：

孤立页面类型操作
有价值的内容，属于某个内容集群从 3 个以上相关页面添加上下文链接
旧内容，仍然相关从中心页和 1-2 个分支页面添加链接
内容过时且无价值重定向到相关页面，或设置 noindex
实用页面（不应编入索引）添加 noindex
内部链接审计清单
检查项通过标准
每个内容页面都有 3-5 个出站内部链接没有页面只链接到自身或导航
每个目标页面都有 3 个以上入站内部链接已编入索引的页面中没有孤立页面
中心页链接到其所有分支页面覆盖完整
锚文本描述清晰且多样任一关键词的完全匹配占比均不超过 30%
没有失效的内部链接失效链接数为 0
从首页到页面的点击深度 < 4 次95% 以上的页面可在 3 次点击内到达

抓取权重管理

首页权重分配

首页是权重最高的页面。请谨慎使用。

首页链接目标优先级
中心页/支柱页面（每个内容集群的顶层页面）最高——从首页内容区域添加链接
关键产品/服务页面高——从首页或主导航添加链接
表现最佳的内容中——仅在上下文相关时添加链接
实用页面（联系、关于）低——仅添加页脚链接
博客索引页中——添加到主导航或次级导航
抓取预算分配
页面类别抓取预算占比优化方式
商业页面（产品、定价、功能）20-30%从首页和导航添加内部链接
支柱内容（中心页）20-30%大量添加内部链接
分支内容（博客、指南）30-40%从中心页添加链接及上下文链接
实用页面（关于、联系、法律）5-10%仅添加页脚链接，尽量减少抓取
标签/归档/分页< 5%内容单薄时设置 noindex，并限制抓取

网站架构审计框架

审核评分卡
维度权重检查项
抓取深度20%95% 以上的页面可在距首页 3 次点击内到达
孤立页面20%索引页面中没有孤立页面
URL 简洁度15%URL 简洁、描述清晰且一致
导航完整性15%所有关键页面均可通过主导航或次级导航访问
内部链接覆盖率15%每个页面至少有 3 个指向它的内部链接
内容分组连贯性10%主题集群定义清晰，中心页与关联页关系明确
面包屑实现5%所有非首页页面均包含面包屑，并带有结构化数据
危险信号
信号严重程度操作
页面距首页超过 3 次点击高通过导航或中心页链接创建快捷入口
中心页没有内容（只有链接）高为所有中心页添加支柱内容
通用锚文本占主导（> 30%）中重写锚文本，使其描述性更强
深层页面没有面包屑中使用 BreadcrumbList 结构化数据实现面包屑
站点地图包含 noindex 页面中筛除站点地图中不可编入索引的页面
主导航链接到实用信息页面低将“联系我们”和“隐私”移至页脚
页脚包含 50 个以上链接低减少至 8-15 个关键页面

重构指南

何时重构
信号是否重构？替代方案
需要全面改造 URL是--
新增 3 个版块部分——仅重构新增版块--
修复孤立页面否添加内部链接，无需更改 URL
改进导航否更新导航，保留 URL
迁移至新 CMS是（通常）如果 CMS 支持，则保留 URL 结构
重构步骤
  1. 抓取当前站点——导出所有 URL、内部链接和排名
  2. 映射现有 URL 与新 URL——创建一对一 URL 重定向映射
  3. 建立重定向规则——为每个发生变化的 URL 设置 301 重定向
  4. 串联现有重定向——更新旧重定向，使其指向最终目标
  5. 更新内部链接——指向新 URL（内部链接不要依赖重定向）
  6. 更新站点地图——反映新的 URL 结构
  7. 监控 60 天——留意抓取错误、排名变化和流量影响

按站点类型划分的架构模式

SaaS 网站
/                           Homepage
├── /features/              Features hub
│   ├── /features/analytics Analytics feature
│   └── /features/reporting Reporting feature
├── /solutions/             Solutions hub (by use case)
│   ├── /solutions/marketing Marketing use case
│   └── /solutions/sales    Sales use case
├── /integrations/          Integrations hub
│   ├── /integrations/slack Slack integration
│   └── /integrations/salesforce Salesforce integration
├── /pricing                Pricing page
├── /blog/                  Blog index
│   ├── /blog/seo-guide     Blog post
│   └── /blog/growth-tips   Blog post
├── /docs/                  Documentation
└── /about                  About page
电商网站
/                           Homepage
├── /[category]/            Category page (with content)
│   ├── /[category]/[subcategory]/ Subcategory (with content)
│   │   └── /[category]/[subcategory]/[product] Product page
│   └── /[category]/[product]      Product (if no subcategory)
├── /brands/                Brand hub
│   └── /brands/[brand]     Brand page
├── /blog/                  Content hub
└── /sale/                  Promotions hub
内容/媒体网站
/                           Homepage
├── /[topic]/               Topic hub (pillar content)
│   ├── /[topic]/[subtopic] Subtopic article
│   └── /[topic]/[guide]    In-depth guide
├── /authors/               Author hub
│   └── /authors/[name]     Author page
├── /tools/                 Free tools hub
│   └── /tools/[tool]       Individual tool
└── /newsletter             Newsletter signup

常见错误

错误影响修复方法
孤立页面没有链接权重流入，Google 会降低其优先级从相关内容添加上下文内部链接
更改 URL 但不设置重定向链接权重流失，反向链接失效始终将旧 URL 进行 301 重定向
嵌套层级过深（4 层以上）抓取权重被稀释，用户体验令人困惑扁平化结构
空分类页面内容单薄的页面无法获得排名为所有分类页/中心页添加支柱内容
首页没有链接到其他页面浪费权重最高的页面从首页链接到所有中心页
页脚包含 100 个以上链接权重被稀释到过多目标页面将页脚限制为 8-15 个关键页面
导航不符合用户的心理模型用户离开，参与度下降使用真实用户开展卡片分类测试
动态参数 URL产生重复内容设置规范 URL，或通过 robots.txt 屏蔽
全站侧边栏链接到每篇文章权重被稀释，增加杂乱链接移除链接，或仅保留“热门”文章

输出产物

产物格式说明
架构审计评分卡加权评分表各维度的分数及红旗指标
站点树形图文本层级结构带注释的可视化 URL 结构
URL 规范表表格各版块的 URL 模式、标题模板、父页面及架构类型
内部链接规划中心辐射图主题集群图，包含锚文本指南和孤立页面修复清单
重定向映射表前后 URL 对照表URL 重构的一对一映射，并采用 301 实现
导航规范分区域设计主导航、次级导航、面包屑、页脚和情境导航规划

相关技能

  • seo-audit -- 用于全面的 SEO 审计，其中架构只是多个问题领域之一。需要全局分析时使用 seo-audit，进行深入的结构性工作时使用 site-architecture。
  • schema-markup -- 架构决策敲定后，用于添加 BreadcrumbList 和其他结构化数据。
  • programmatic-seo -- 通过中心辐射结构大规模生成数百个基于模板的页面时使用。
  • content-creator -- 用于创建中心页面需要的支柱内容，帮助其有效获得排名。

故障排查

问题可能原因修复方法
Google 索引中出现孤立页面页面存在于站点地图中或有外部链接，但没有指向它们的内部链接从 3 个以上相关页面添加情境内部链接；更新中心页面，将这些页面纳入其中
关键页面的抓取深度超过 4 次点击缺少扁平化导航，或中心页面没有链接到辐射页面通过主导航、中心页面内容区块或精选版块创建快捷链接
类别/中心页面排名不佳中心页面缺少实质性内容，只有链接列表为每个中心页面添加 800 字以上的支柱内容；这些页面必须凭自身内容获得排名
站点迁移后出现重定向链旧重定向没有更新为指向最终目标；多次迁移导致重定向链累积审核所有现有重定向；合并重定向链，确保每个重定向都直接指向最终 URL
内部链接使用通用锚文本内部链接中“点击此处”和“了解更多”等锚文本占主导将锚文本改写为描述性文本，并包含部分匹配关键词；目标比例为 60-70%
新版块未被抓取现有高权重页面没有指向新版块的内部链接从首页和相关中心页面添加情境链接；提交新版块的站点地图

成功标准

  • 抓取深度：95% 以上的可索引页面可在从首页点击 3 次以内到达
  • 零孤立页面：没有任何已索引页面缺少至少 3 个指向它的内部链接
  • URL 规范性：100% 的 URL 均遵循既定模式——使用小写、连字符分隔、描述清晰，并采用一致的尾部斜杠策略
  • 导航覆盖率：所有关键营收页面和支柱页面均可通过主导航或次级导航访问
  • 内部链接密度：每个内容页面都有 3-5 个指向站内其他页面的情境链接，且锚文本具有描述性
  • 主题集群连贯性：每个主题集群都有一个明确的中心页面，并与所有辐射页面双向链接
  • 面包屑覆盖率：100% 的非首页页面均包含 BreadcrumbList 架构

范围与限制

范围内：

  • URL 层级设计与重构
  • 导航架构（主导航、次级导航、面包屑、页脚、上下文导航、侧边栏）
  • 信息孤岛结构与主题集群规划
  • 内部链接策略与优化
  • 抓取权重分析与优化
  • 架构审计与评分报告
  • URL 迁移规划与重定向映射

范围外：

  • 为中心页创作内容（使用 Content Production）
  • 实施 Schema 标记（使用 Schema Markup）
  • 架构之外的技术 SEO（使用 SEO Audit）
  • 导航的视觉设计或 UX 设计
  • CMS 开发或模板编码
  • 外部链接建设

已知限制：

  • 抓取权重分配是估算值——Google 不会公布精确的 PageRank 流动数据
  • 大型网站（1 万页以上）的架构变更需要谨慎分阶段迁移，以避免流量损失
  • 导航测试（卡片分类、树形测试）需要用户研究工具和参与者
  • 跨信息孤岛的链接建议属于定性建议——没有用于确定最佳交叉链接密度的确定性公式

脚本

# Analyze sitemap for depth and structure issues
python scripts/sitemap_analyzer.py --file sitemap.xml --json

# Check URLs for redirect chains and patterns
python scripts/redirect_checker.py --file urls.txt --json

# Map internal link structure from a sitemap
python scripts/link_mapper.py --sitemap sitemap.xml --json

评论

支持 Markdown