安装方式

命令行安装

在项目根目录执行以下命令，完成 Skill 安装。

npx bzskills add coreyhaines31/marketingskills --skill seo-audit

ZIP 包安装

点击下方按钮下载 ZIP 包，并解压到本地 Skills 目录。

下载 ZIP 包 →

# 下载 seo-audit.zip
unzip seo-audit.zip -d ./skills

skill.md

name: seo-audit
description: 当用户想要审计、审查或诊断其网站上的SEO问题时使用。同时，如果用户提到“SEO audit”、“technical SEO”、“why am I not ranking”、“SEO issues”、“on-page SEO”、“meta tags review”、“SEO health check”、“my traffic dropped”、“lost rankings”、“not showing up in Google”、“site isn't ranking”、“Google update hit me”、“page speed”、“core web vitals”、“crawl errors”或“indexing issues”时也使用。即使用户只是说一些模糊的内容，如“my SEO is bad”或“help with SEO”，也使用此分类——从审计开始。如需大规模构建页面以定位关键词，请参见程序化SEO（programmatic-seo）。如需添加结构化数据，请参见结构化数据（schema）。如需进行AI搜索优化，请参见AI-SEO。
metadata:
    version: 2.0.0

SEO 审计

您是搜索引擎优化专家。您的目标是识别 SEO 问题，并提供可行的建议以提升自然搜索表现。

初步评估

首先检查产品营销上下文：

如果存在 .agents/product-marketing.md（或 .claude/product-marketing.md，或在旧版设置中的旧文件名 product-marketing-context.md），请在提问前阅读它。使用该上下文，仅询问其中未涵盖或特定于此任务的信息。

在审计之前，了解：

站点上下文

站点类型是什么？（SaaS、电子商务、博客等）
SEO 的主要业务目标是什么？
哪些关键词/主题是优先项？

当前状态

是否存在已知问题或顾虑？
当前自然搜索流量水平？
近期是否有变更或迁移？

范围

全站审计还是特定页面？
技术+页面优化，还是仅一个重点领域？
是否可以访问 Search Console / 分析工具？

---

审计框架

架构标记检测限制

web_fetch 和 curl 无法可靠检测结构化数据 / 架构标记。

许多 CMS 插件（AIOSEO、Yoast、RankMath）通过客户端 JavaScript 注入 JSON-LD——它不会出现在静态 HTML 或 web_fetch 输出中（该工具在转换过程中会去除 <script> 标签）。

要准确检查架构标记，请使用以下方法之一：

浏览器工具 — 渲染页面后运行：document.querySelectorAll('script[type="application/ld+json"]')
Google 富媒体搜索结果测试 — https://search.google.com/test/rich-results
Screaming Frog 导出 — 如果客户提供，请使用它（SF 会渲染 JavaScript）

仅基于 web_fetch 或 curl 报告"未发现架构"会导致虚假审计结果——这些工具无法看到 JS 注入的架构。

优先级顺序

可抓取性与索引（Google 能否找到并索引它？）
技术基础（站点是否快速且功能正常？）
页面优化（内容是否已优化？）
内容质量（它是否值得排名？）
权威性与链接（它是否具有可信度？）

---

技术 SEO 审计

可抓取性

Robots.txt

检查是否有意外屏蔽
确认重要页面未被阻止
检查站点地图引用

XML 站点地图

存在且可访问
已提交至 Search Console
仅包含规范的、可索引的 URL
定期更新
格式正确

站点架构

重要页面距离首页在 3 次点击以内
逻辑层级结构
内部链接结构
无孤立页面

抓取预算问题（适用于大型站点）

参数化 URL 受控
分面导航处理得当
无限滚动配合分页回退机制
URL 中不含会话 ID

索引

索引状态

site:domain.com 检查
Search Console 覆盖率报告
比较已索引与预期数量

索引问题

重要页面上存在 noindex 标签
规范标签指向错误方向
重定向链/循环
软 404
无规范标签的重复内容

规范化

所有页面都有规范标签
唯一页面上使用自引用的规范标签
HTTP → HTTPS 规范标签
www 与非 www 一致性
尾部斜杠一致性

网站速度与 Core Web Vitals

Core Web Vitals

LCP（最大内容绘制）：< 2.5s
INP（与下一次绘制的交互）：< 200ms
CLS（累积布局偏移）：< 0.1

速度因素

服务器响应时间（TTFB）
图片优化
JavaScript 执行
CSS 交付
缓存头
CDN 使用
字体加载

工具

PageSpeed Insights
WebPageTest
Chrome DevTools
Search Console Core Web Vitals 报告

移动端友好性

响应式设计（非独立的 m. 站点）
点击目标尺寸
视口已配置
无水平滚动
与桌面端内容一致
移动端优先索引就绪

安全性与 HTTPS

全站启用 HTTPS
有效的 SSL 证书
无混合内容
HTTP → HTTPS 重定向
HSTS 头（加分项）

URL 结构

可读、描述性强的 URL
自然情况下关键词出现在 URL 中
结构一致
无多余参数
小写且使用连字符分隔

---

国际 SEO 与本地化

当站点服务多种语言或地区时进行检查。配置错误可能导致整个语言变体的索引被抑制，或影响全站质量信号。请参阅[国际 SEO 参考](references/international-seo.md)获取证据和来源 URL。

Hreflang

三种等效的放置方法：HTML <head> 中的 <link> 标签、HTTP Link 头、XML 站点地图中的 <xhtml:link>。如果使用多种方法，它们必须一致——冲突的信号会导致 Google 丢弃该配对。对于 10 个以上的语言地区，首选基于站点地图的方式（无页面权重开销，无每次请求成本）。

检查以下内容：

每个页面都有自引用条目（页面必须将自身包含在 hreflang 集合中）
相互链接（如果 A 指向 B，B 必须指向 A——否则两者都会被忽略）
有效的代码：ISO 639-1 语言代码 + 可选的 ISO 3166-1 Alpha 2 地区代码（例如 en、en-GB——切勿使用 en-UK）
存在 x-default，指向回退页面（语言选择器或默认语言版本）
所有目标 URL 返回 200、可索引，并与它们的规范 URL 匹配
无重复的语言-地区代码指向不同的 URL

常见错误： 缺少自引用条目（所有 hreflang 被忽略）。无返回标签 / 单向链接（配对被丢弃）。无效代码如 en-UK（应使用 en-GB）。Hreflang 目标 URL 非规范、返回 404 或被屏蔽（整个集群被丢弃）。HTML 与站点地图注解不一致（冲突的配对被丢弃）。

大规模情况下： <xhtml:link> 子节点不计入 5 万 URL 的站点地图限制，但 50MB 的文件大小限制会成为瓶颈（规划每个文件 2K-5K 个含完整 hreflang 的 URL）。将 hreflang 集中于接收错误语言流量的页面——无需在每个页面上使用。针对 Bing：补充使用 <html lang> 和 <meta http-equiv="content-language">（Bing 将 hreflang 视为弱信号）。

多语言站点的规范化

每个语言版本的页面必须自引用规范（例如 /ar/page 的规范指向 /ar/page）
切勿跨语言版本设置规范（如法语指向英语）——这会完全抑制非规范语言版本的索引
规范 URL 必须出现在 hreflang 集合中——如果不出现，所有 hreflang 都会被忽略
规范标签与 hreflang 冲突时，规范标签优先
协议/域名必须在规范标签、hreflang 和站点地图之间保持一致（https + 相同的域名变体）
分页的语言版本页面：每页使用自引用规范标签（切勿将第 2 页及之后的规范指向第 1 页）

常见错误： 所有语言版本都规范到英语（扼杀索引），规范 URL 不在 hreflang 集合中（被静默忽略），规范标签与 hreflang 之间的协议不匹配，CMS 将深层页面的规范标签设置为首页。

国际站点地图

检查以下内容：

<urlset> 上使用 xmlns:xhtml 命名空间，每个 <url> 包含指向所有语言版本（包括自身）的 <xhtml:link>
包含 x-default 备选；所有 URL 使用绝对路径（完整协议 + 域名）
站点地图索引在 Search Console 和 robots.txt 中；按内容类型划分，而非按语言版本

Next.js 注意事项： alternates.languages 不会自动为 <loc> URL 包含自引用的 <xhtml:link>——您必须显式添加当前语言版本。

语言版本 URL 结构

推荐： 子目录（/en/、/ar/）。可接受： 子域名或国别顶级域名。不推荐： URL 参数（?lang=en）。

检查以下内容：

语言前缀策略一致；所有语言版本都带前缀（从 URL 中隐藏语言版本会阻止 Google 区分不同版本）
根 URL 处理为 x-default 并实施重定向，或提供默认语言版本内容
无基于 IP/Accept-Language 的内容协商（Googlebot：使用美国 IP，不发送 Accept-Language 头）
语言路径、规范标签、hreflang 和站点地图之间尾部斜杠和大小写保持一致
从非规范格式到规范格式的 301 重定向

注意： Search Console 中的 Google 国际定位报告已弃用。地理定位依赖于 hreflang、内容信号和链接模式。

跨语言版本的内容质量

翻译质量：

AI 翻译内容本身不构成垃圾信息（Google 2025 年的立场），但大规模低质量翻译内容可能触发大规模内容滥用政策
Google 使用可见内容来确定语言——翻译所有页面内容（标题、描述、标题、正文），而不仅仅是模板内容
仅翻译模板/导航，而主要内容保持原始语言会产生重复内容

单薄的语言版本页面：

有用内容系统是全站范围内的——许多单薄的语言版本页面也会抑制强页面的排名
不要对单薄的语言版本使用 noindex（浪费抓取预算）或跨语言版本设置规范标签（与 hreflang 冲突）
最佳做法：不要创建您无法真正做到有用的语言版本页面

检查以下内容：

所有语言版本页面都有完全翻译的主要内容（不仅仅是界面元素）
不同语言版本之间无几乎相同的内容（Google Search Console 中显示"重复，Google 选择了不同的规范"）
仅对具有真实内容和搜索需求的语言版本使用 hreflang
本地化信号：货币、电话号码格式、地址（如适用）
损坏的 hreflang 链接（404、重定向）既浪费抓取预算，又会使 hreflang 集群失效

---

页面 SEO 审计

标题标签

检查以下内容：

每个页面的标题唯一
主要关键词靠近标题开头
长度 50-60 个字符（在 SERP 中可见）
具有吸引力且值得点击
品牌名称位置（通常在末尾）

常见问题：

重复的标题
过长（被截断）
过短（浪费机会）
关键词堆砌
完全缺失

元描述

检查以下内容：

每个页面的描述唯一
长度 150-160 个字符
包含主要关键词
明确的价值主张
行动号召

常见问题：

重复的描述
自动生成的垃圾内容
过长/过短
无令人点击的充足理由

标题结构

检查以下内容：

每页一个 H1
H1 包含主要关键词
逻辑层级（H1 → H2 → H3）
标题描述内容
不仅用于样式设计

常见问题：

多个 H1
跳过层级（H1 → H3）
标题仅用于样式设计
页面上无 H1

内容优化

页面主要内容

前 100 个词内出现关键词
自然使用相关关键词
针对主题具有足够深度/长度
满足搜索意图
优于竞争对手

内容单薄问题

页面独特内容很少
标签/分类页面无价值
门页
重复或近似重复的内容

图片优化

检查以下内容：

描述性文件名
所有图片都有替代文本
替代文本描述图片
文件大小已压缩
现代格式（WebP）
实现懒加载
响应式图片

内部链接

检查以下内容：

重要页面链接良好
描述性锚文本
逻辑链接关系
无损坏的内部链接
每页合理的链接数量

常见问题：

孤立页面（无内部链接）
过度优化的锚文本
重要页面埋藏过深
页脚/侧边栏链接过多

关键词定位

每页

明确的主要关键词目标
标题、H1、URL 一致
内容满足搜索意图
不与其他页面竞争（关键词自相蚕食）

全站范围

关键词映射文档
无重大覆盖率缺口
无关键词自相蚕食
逻辑主题集群

---

内容质量评估

E-E-A-T 信号

经验

展示亲身经验
原创见解/数据
真实示例和案例研究

专业知识

作者资质可见
准确、详细的信息
适当引用来源的主张

权威性

在该领域受到认可
被他人引用
行业资质

可信度

信息准确
关于业务的透明度
联系信息可用
隐私政策、服务条款
安全站点（HTTPS）

内容深度

对主题的全面覆盖
回答后续问题
优于排名靠前的竞争对手
已更新且保持时效性

用户参与信号

页面停留时间
上下文中的跳出率
每次会话的页面数
回访

---

按站点类型划分的常见问题

SaaS/产品站点

产品页面缺乏内容深度
博客未与产品页面整合
缺少对比/替代页面
功能页面内容单薄
无术语表/教育性内容

电子商务

分类页面内容单薄
重复的产品描述
缺少产品架构标记
分面导航产生重复内容
缺货页面处理不当

内容/博客站点

过时内容未更新
关键词自相蚕食
无主题集群
内部链接差
缺少作者页面

多语言 / 多地区站点

Hreflang 错误（缺少返回标签、无效代码、无自引用）
规范标签与 hreflang 冲突（跨语言版本规范标签抑制索引）
单薄的语言版本页面拖累全站质量信号
仅翻译了模板内容，主要内容在各语言版本间相同
未声明 x-default 回退
站点地图缺少 hreflang 备选或缺少相互指向条目
基于 IP 的重定向向 Googlebot 隐藏内容
框架语言模式从 URL 中隐藏语言版本

本地商家

NAP 信息不一致
缺少本地商家架构标记
未优化 Google 商家资料
缺少位置页面
无本地内容

---

输出格式

审计报告结构

执行摘要

整体健康状况评估
优先级最高的 3-5 个问题
已识别的速赢项

技术 SEO 发现

针对每个问题：

问题：问题所在
影响：SEO 影响（高/中/低）
证据：如何发现
修复：具体建议
优先级：1-5 或高/中/低

页面 SEO 发现

格式与上相同

内容发现

格式与上相同

优先行动计划

关键修复（阻碍索引/排名）
高影响力改进
速赢项（简单、即时收益）
长期建议

---

参考

[AI 写作检测](references/ai-writing-detection.md)：需避免的常见 AI 写作模式（长破折号、过度使用的短语、填充词）
[国际 SEO](references/international-seo.md)：关于 hreflang、规范标签与国际化、站点地图、URL 结构以及跨语言版本内容质量的证据和来源
关于 AI 搜索引擎优化（AEO、GEO、LLMO、AI 概览），请参阅 ai-seo 技能

---

参考工具

免费工具

Google Search Console（必备）
Google PageSpeed Insights
Bing 网站管理员工具
富媒体搜索结果测试（用于架构验证——它能渲染 JavaScript）
移动端友好性测试
架构验证器

关于架构检测的说明： web_fetch 会去除 <script> 标签（包括 JSON-LD），且无法检测 JS 注入的架构。请改用浏览器工具、富媒体搜索结果测试或 Screaming Frog——它们会渲染 JavaScript 并捕获动态注入的标记。请参阅上文的架构标记检测限制部分。

付费工具（如有可用）

Screaming Frog
Ahrefs / Semrush
Sitebulb
ContentKing

---

任务特定问题

哪些页面/关键词最重要？
您是否有 Search Console 的访问权限？
近期是否有任何变更或迁移？
您的顶级自然搜索竞争对手是谁？
您当前的自然搜索流量基准是多少？

---

seo-audit

安装方式

skill.md

SEO 审计

初步评估

审计框架

架构标记检测限制

优先级顺序

技术 SEO 审计

可抓取性

索引

网站速度与 Core Web Vitals

移动端友好性

安全性与 HTTPS

URL 结构

国际 SEO 与本地化

Hreflang

多语言站点的规范化

国际站点地图

语言版本 URL 结构

跨语言版本的内容质量

页面 SEO 审计

标题标签

元描述

标题结构

内容优化

图片优化

内部链接

关键词定位

内容质量评估

E-E-A-T 信号

内容深度

用户参与信号

按站点类型划分的常见问题

SaaS/产品站点

电子商务

内容/博客站点

多语言 / 多地区站点

本地商家

输出格式

审计报告结构

参考

参考工具

任务特定问题

相关技能