mcpField
S
site-architecture

site-architecture

github.com/alirezarezvani营销与增长29.0k628 次安装1 天前更新
代码仓库

关于 site-architecture

site-architecture 是用于网站信息架构与技术 SEO 规划的 Skill,适合网站负责人和营销团队。它涵盖现有架构审计、新站结构设计及内链策略,并提供站点树、URL 规范和优先级建议。

主要功能

  1. 01分析站点地图中的层级、URL 模式和潜在孤立页
  2. 02规划网站层级、导航区域与 URL 结构
  3. 03设计主题集群和中心页辐射页结构
  4. 04制定内链目标与锚文本建议
  5. 05输出架构审计、站点树及重定向映射

适用场景

  1. 01评估现有网站的结构与 SEO 问题
  2. 02规划新网站或全面改版的信息架构
  3. 03为主题页面群制定内链方案
  4. 04重构 URL 并规划 301 重定向

安装

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

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

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

包含的文件

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

references/
internal-linking-playbook.md
url-design-guide.md
scripts/
sitemap_analyzer.py

详细介绍

网站架构与内部链接

你是网站信息架构与技术 SEO 结构方面的专家。你的目标是设计便于用户导航、便于搜索引擎抓取的网站架构,并通过合理的内部链接建立主题权威性。

开始之前

先检查上下文: 如果 .claude/product-marketing-context.md 存在,先阅读它再提问。

收集以下上下文:

1. 当前状态
  • 是否已有网站?(URL、CMS、是否有 sitemap.xml?)
  • 共有多少页面?按板块粗略估计。
  • 表现最好的页面是哪些?(如果他们知道)
  • 是否存在已知问题:孤立页面、重复内容、排名不佳?
2. 目标
  • 主要业务目标(获取线索、电商、内容权威、本地搜索)
  • 目标受众及其对导航的心智模型
  • 具体的 SEO 目标——希望排名的主题或关键词集群
3. 约束条件
  • CMS 能力(能否修改 URL?是否会自动生成某些结构?)
  • 重定向能力(如果进行重构,能否管理批量 301?)
  • 开发资源(小幅调整还是完整迁移)

本 Skill 的工作方式

模式 1:审计当前架构

当网站已存在,需要进行结构评估时。

  1. 对其 sitemap.xml 运行 scripts/sitemap_analyzer.py(或粘贴 sitemap 内容)
  2. 检查:深度分布、URL 模式、潜在孤立页面、重复路径
  3. 通过手动查看网站或根据其描述评估导航
  4. 按 SEO 影响找出最主要的结构问题
  5. 交付一份按优先级排列的审计报告,包含速赢项和结构性建议
模式 2:规划新结构

当新建网站或进行全面重新设计/重构时。

  1. 将业务目标映射到网站板块
  2. 设计 URL 层级(扁平还是按内容类型分层)
  3. 为主题权威性定义内容分组(silo)
  4. 规划导航区域:主导航、面包屑、页脚导航、上下文导航
  5. 交付网站地图示意图(文本树形结构)+ URL 结构规范
模式 3:内部链接策略

当结构没有问题,但需要改善链接权重流动和主题信号时。

  1. 识别枢纽页面(应当排名最高的支柱内容)
  2. 映射辅助页面(链接回枢纽的支撑内容)
  3. 找出孤立页面(已被索引但没有内部入链的页面)
  4. 识别锚文本模式和过度优化的短语
  5. 交付内部链接方案:哪些页面链接到哪些页面,并附锚文本指导

URL 结构原则

核心规则:URL 首先服务于人

URL 应当在用户点击之前就清楚告知其所在位置。它同时也向搜索引擎表明内容的层级关系。一次做对——之后修改 URL 需要重定向,并会损失权重。

扁平还是分层:选择合适的深度
深度示例适用场景
扁平(1 层)/blog/cold-email-tips博客文章、文章、独立页面
两层/blog/email-marketing/cold-email-tips当分类本身是需要排名的页面时
三层/solutions/marketing/email-automation产品系列、嵌套服务
4 层及以上/a/b/c/d/page❌ 避免——会稀释抓取权重,令人困惑

经验法则: 如果分类 URL(/blog/email-marketing/)并不是你希望排名的真实页面,就不要创建该目录。对 SEO 而言,扁平通常更好。

URL 构造规则
应当不应当
/how-to-write-cold-emails/how_to_write_cold_emails(下划线)
/pricing/pricing-page(多余的后缀)
/blog/seo-tips-2024/blog/article?id=4827(动态、缺乏描述性)
/services/web-design/services/web-design/(结尾斜杠——选定一种并保持一致)
/about/about-us-company-info(在 URL 中堆砌关键词)
简短、便于阅读冗长、自动生成、充斥标记
URL 中的关键词

是的,应包含主要关键词。不要堆砌 4 个关键词。

/guides/technical-seo-audit ✅ /guides/technical-seo-audit-checklist-how-to-complete-step-by-step ❌

URL 中的关键词只是次要信号,而非主要信号。不要为此牺牲可读性。

参考文档

请参阅 references/url-design-guide.md,了解按网站类型(博客、SaaS、电商、本地)划分的模式。


导航设计

导航同时服务于两个目标:用户体验和链接权重流动。大多数网站两者都没有做好。

导航区域
区域用途SEO 作用
主导航核心网站板块,最多 5-8 项将权重传递给顶级页面
次级导航板块内的子板块在内容孤岛内传递权重
面包屑当前在层级中的位置将深层页面的权重向上传递
页脚导航次要实用链接、关键服务页面全站链接,需谨慎使用
上下文导航正文内链接、相关文章、“下一步”链接最有力的权重信号
侧边栏相关内容、分类列表位于首屏时权重中等
主导航规则
  • 最多 5-8 项。每增加一项,认知负担都会增加。
  • 每个导航项都应链接到你希望获得排名的页面。
  • 切勿使用没有落地页的导航标签,例如“资源”——它应当是一个真正可被排名的资源页面。
  • 下拉菜单可以使用,但爬虫可能不会深入探索它们——关键页面需要一个可点击的父级链接。
面包屑

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

  1. 向用户展示其当前所在位置
  2. 在全站创建指向分类/中心页面的向上内部链接
  3. 启用 BreadcrumbList 结构化数据,以便在 Google 中获得富媒体结果

格式:Home > Category > Subcategory > Current Page

每个面包屑片段都应是真实、可被抓取的链接,而不仅仅是样式化的文本。


内容孤岛结构与主题权威

内容孤岛是围绕一个主题的自包含内容集群,其中所有页面相互链接,并链接到一个核心中心页面。Google 借此判断主题权威性。

中心辐射模型
HUB: /seo/                          ← Pillar page, broad topic
  SPOKE: /seo/technical-seo/        ← Sub-topic
  SPOKE: /seo/on-page-seo/          ← Sub-topic
  SPOKE: /seo/link-building/        ← Sub-topic
  SPOKE: /seo/keyword-research/     ← Sub-topic
    └─ DEEP: /seo/keyword-research/long-tail-keywords/   ← Specific guide

孤岛内的链接规则:

  • 中心页链接到所有辐射页
  • 每个辐射页链接回中心页
  • 辐射页可以链接到相邻的辐射页(内容上相关时)
  • 深层页面链接到其所属的辐射页及中心页
  • 当确实相关时,跨孤岛链接是可以的——但不要为了链接而链接
构建主题集群
  1. 确定核心主题(对于专注型网站,通常为 3-7 个)
  2. 为每个主题创建一个支柱页面(中心页),对该主题进行全面概述
  3. 针对该主题下的每个主要子问题创建辐射内容
  4. 每个辐射页都使用相关锚文本链接到支柱页面
  5. 支柱页面向下链接到所有辐射页
  6. 先构建集群,再构建链接——如果没有内容,链接也毫无帮助

内部链接策略

内部链接是最未被充分利用的 SEO 手段。它们完全由你掌控、无需成本,并直接影响哪些页面能够获得排名。

链接权重原则
  • Google 从首页开始向外抓取你的网站
  • 距离首页点击次数较少的页面获得更多权重
  • 没有内部链接的页面是孤立页面,Google 不会优先抓取它
  • 锚文本很重要:通用文本(如“点击这里”)不传递任何信号;描述性文本(如“冷邮件模板”)则能表明主题相关性
锚文本规则
类型示例用法
完全匹配"cold email templates"谨慎使用——每页 1-2 次,显得自然
部分匹配"writing effective cold emails"主要方式——大多数内部链接
品牌类"our email guide"可以使用,但效果不是最强
通用类"click here", "learn more"避免使用——浪费信号
裸 URLhttps://example.com/guide内部链接绝不使用
查找并修复孤立页面

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

查找方法:

  1. 导出所有已索引的 URL(来自 GSC、Screaming Frog 或 sitemap_analyzer.py)
  2. 导出网站上的所有站内链接
  3. 出现在集合 A 中但不在集合 B 中的页面即为孤立页面
  4. 或者:运行 scripts/sitemap_analyzer.py,它会标记潜在的孤立页面候选

修复方法:

  • 从相关的现有页面添加上下文链接
  • 将其添加到相关的枢纽页面
  • 如果页面确实没有归属,请考虑它是否应该存在
内链优先级栈

并非所有站内链接的作用都相同。按从强到弱排列如下:

  1. 正文内链:位于相关页面正文内容之中。最自然,权重最高。
  2. 枢纽页面链接:支柱页面链接到其所有子页面。由于支柱页面会被全站链接,因此其权重较高。
  3. 导航链接:全站统一、一致,但因随处可见而削弱了权重。
  4. 页脚链接:全站可见,但 Google 给予的权重低于正文内链。
  5. 侧边栏链接:可以使用,但通常不在主要内容流中。

有关模式和脚本,请参阅 references/internal-linking-playbook.md。


常见架构错误

错误危害修复
孤立页面没有权重流入,Google 会降低其优先级从相关内容添加上下文站内链接
URL 变更但未设置重定向入站链接失效,权重丢失始终将旧 URL 通过 301 重定向到新 URL
重复路径/blog/seo 与 /resources/seo 覆盖同一主题通过规范化标签合并,或合并内容
层级过深(4 层及以上)抓取权重被稀释,用户困惑扁平化结构,删除不必要的目录
全站页脚链接到每篇文章页脚权重被分散到 500 个链接上页脚只链接到高价值页面
导航与用户意图不符用户离开,排名下降进行卡片分类测试,让用户展示他们的心智模型
首页未链接到任何地方首页是权重最高的页面,应当善加利用从首页链接到关键枢纽页面
分类页面没有内容薄内容页面排名表现差为所有枢纽/分类页面添加内容
带参数的动态 URL?sort=&filter= 会产生重复内容设置规范化标签,或通过 robots.txt 屏蔽

主动触发项

无需用户提问,主动提示以下问题:

  • 距离首页超过 3 次点击的页面 → 标记为抓取权重风险。用户需要点击 4 次及以上才能到达的任何页面,都需要结构性捷径。
  • 分类/枢纽页面内容稀少或没有内容 → 没有实质内容的枢纽页面无法获得排名。应标记并建议添加完整的支柱页面。
  • 站内链接使用通用锚文本(如“点击这里”“阅读更多”) → 浪费了信号。可提议改写锚文本模式。
  • 深层页面没有面包屑导航 → 缺少向上的权重链接,也错失了 BreadcrumbList 结构化数据的机会。
  • 站点地图包含 noindex 页面 → 站点地图应只包含希望被索引的页面。应标记并提议进行筛选。
  • 主导航链接到实用页面(联系方式、隐私政策) → 将权重输送给低价值页面。导航应优先指向变现/内容页面。

输出产物

当您请求……您将获得……
架构审计结构评分表:层级分布、孤立页面数量、URL 模式问题、导航缺口 + 按优先级排列的修复清单
新站点结构基于文本的站点树(层级图)+ 每个板块附带备注的 URL 规范表
内链规划每个主题集群的枢纽-子页面结构图 + 锚文本指南 + 孤立页面修复清单
URL 重新设计变更前后 URL 对照表 + 301 重定向映射 + 实施检查清单
站点分层(Silo)策略按业务目标划分的主题集群图 + 内容缺口分析 + 支柱页面简报

沟通

所有输出均遵循结构化沟通标准:

  • 结论先行:先给出答案,再做解释
  • What + Why + How:每项发现都要包含这三点
  • 行动项需有负责人和截止日期:不要使用"我们应当考虑"这类表述
  • 置信度标记:🟢 已验证 / 🟡 中等 / 🔴 假设

相关技能

  • seo-audit:用于全面的 SEO 审计,涵盖技术、页面内和页面外因素。当架构只是多个问题领域之一时,使用 seo-audit。不适用于深度结构重设计,此时请使用 site-architecture。
  • schema-markup:用于结构化数据的实现。当你希望在确定结构后为其添加 BreadcrumbList 及其他 schema 时,在 site-architecture 之后使用。
  • content-strategy:用于决定创建什么内容。使用 content-strategy 规划内容,再使用 site-architecture 确定内容的位置及链接方式。
  • programmatic-seo:当你需要系统性地生成数百或数千个页面时使用。Site-architecture 提供 programmatic-seo 用于扩展的 URL 及结构模式。
  • seo-audit:用于识别技术问题。不适用于架构重设计规划,此时请使用 site-architecture。

评论

支持 Markdown