technical-seo

技术 SEO

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 文件夹同级。请使用 Python 3.10 或更高版本运行：使用 python；如果找不到 python，则使用 python3（适用于 macOS 和许多 Linux 系统）。

何时使用此技能

当用户的请求涉及以下任一内容时，启用此模块：

• Core Web Vitals：优化 LCP、INP 或 CLS 分数；诊断页面速度问题；解读 CrUX 数据或 PageSpeed Insights 报告
• 可抓取性：配置 Robots.txt、创建或审核 XML 站点地图、管理抓取预算，或处理 Googlebot 访问问题
• 网站架构：规划 URL 结构、信息架构、内链策略、网站深度优化或内容分组
• 索引：实施规范标签、设置 noindex/nofollow 指令、处理索引膨胀和重复内容，或解决 Google Search Console 索引覆盖率问题
• 重定向：审核重定向链、制定 301/302 策略、为网站迁移创建重定向映射，或从 HTTP 迁移至 HTTPS
• JavaScript SEO：处理客户端渲染问题、评估 SSR、CSR 与 SSG、动态渲染，或解决 JavaScript 可抓取性问题
• 移动优先索引：处理移动端渲染问题、检查移动端一致性、审核响应式设计，或解决移动端易用性错误
• 结构化数据：实施 Schema 标记（JSON-LD）、检查富媒体搜索结果资格、验证 Schema，或制定结构化数据策略
• 日志文件分析：解读服务端日志、分析抓取频率、识别无效抓取，或审核机器人行为
• 国际 SEO：实施 Hreflang、决定采用 ccTLD、子域名还是子目录、进行地理定位，或规划多语言网站架构
• 安全性：迁移至 HTTPS、解决混合内容、实施 HSTS，或配置安全标头
• HTTP 状态码：诊断 4xx/5xx 错误、检测软 404、分析服务器错误模式，或制定状态码策略
• 页面速度：服务器响应时间（TTFB）、阻塞渲染的资源、图像优化、代码拆分，或 CDN 配置
• 网站迁移：更改域名、迁移平台、切换至 HTTPS、重构 URL，或整合并购后的网站

触发短语：“技术 SEO”、“Core Web Vitals”、“页面速度”、“抓取预算”、“robots.txt”、“站点地图”、“重定向”、“规范标签”、“索引”、“noindex”、“hreflang”、“JavaScript SEO”、“移动优先索引”、“日志文件分析”、“网站架构”、“内链”、“抓取错误”、“HTTP 状态”、“Schema 标记”、“结构化数据”、“网站迁移”、“TTFB”、“LCP”、“INP”、“CLS”、“阻塞渲染”、“可抓取性”、“索引膨胀”、“重定向链”、“混合内容”、“HTTPS”

上下文效率

此技能开销较大。读取任何提及的文件前，先使用 Grep 搜索；然后仅使用 offset 和 limit 读取匹配范围。打开文件前，先列出 ${CLAUDE_PLUGIN_DATA}/<brand>/。在会话中途再次调用时，跳过已载入上下文的文件。

品牌背景（自动应用）

在使用本模块生成任何营销内容之前：

1. 检查会话上下文 — 会话开始时已输出当前品牌摘要。请使用其中显示的品牌名称、行业、语气设置、渠道、目标、合规要求和竞争对手。
2. 如需完整档案，请读取：~/.claude-marketing/brands/{slug}/profile.json
3. 应用品牌语气 — 正式程度、活力、幽默感和权威感都必须影响所有内容的语气和措辞。
4. 检查合规要求 — 根据品牌的 target_markets 和行业，使用 skills/context-engine/compliance-rules.md 自动应用规则。
5. 参考行业基准 — 查阅 skills/context-engine/industry-profiles.md 中适用于品牌所在行业的内容。
6. 使用平台规范 — 参阅 skills/context-engine/platform-specs.md，了解字符限制和格式要求。
7. 检查营销活动历史 — 在规划新工作前，运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/campaign-tracker.py" --brand {slug} --action list-campaigns。
8. 如果不存在品牌，请说：“未找到品牌档案。请使用 /digital-marketing-pro:brand-setup 创建档案，或者我也可以根据通用最佳实践继续。”
9. 检查品牌指南 — 如果 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 存在，请加载并执行以下文件中的要求：restrictions.md 中的禁用词、受限声明和强制免责声明；channel-styles.md 中的渠道专属语气覆盖规则（可能与基础语气不同）；messaging.md 中已批准的关键信息、标语和定位用语；voice-and-tone.md 中超出 4 项数值评分的详细语气规则。如果要为特定渠道制作内容，渠道风格规则优先于基础语气设置。

不要向用户询问其品牌档案中已有的信息。

必需的上下文

执行技术 SEO 工作之前，请收集：

1. 网站 URL：需要审核或优化的域名
2. CMS / 平台：WordPress、Shopify、Webflow、自定义、无头等 — 这决定了实施路径
3. 托管环境：共享主机、VPS、专用服务器、云（AWS/GCP/Azure）、CDN 提供商 — 这会影响服务器端建议
4. 当前性能数据：Google Search Console 访问权限、PageSpeed Insights 评分、CrUX 数据或现有审核报告
5. 网站规模：大致页面数量（数百、数千、数十万）— 这决定抓取预算是否相关
6. 渲染方式：静态 HTML、服务器端渲染、客户端渲染（React/Angular/Vue）、混合渲染（Next.js/Nuxt）— 对 JavaScript SEO 至关重要
7. 国际业务范围：目标国家和语言，以及国际版本当前的 URL 结构
8. 已知问题：用户已了解的现有问题（抓取错误、索引量下降、速度投诉、排名下滑）
9. 迁移计划：即将进行的域名变更、平台迁移或 URL 重构
10. 技术栈限制：开发团队可用情况、部署流程、CDN 限制、插件/扩展限制

对于快速诊断请求（例如“为什么我的页面很慢”），请推断合理的默认情况并立即给出结果。对于全面审核，请收集完整上下文。

能力

• Core Web Vitals 优化：诊断并修复 LCP（目标 < 2.5s）、INP（目标 < 200ms）和 CLS（目标 < 0.1）问题，提供可直接实施的具体建议；解读现场数据（CrUX）与实验室数据（Lighthouse）之间的差异；根据用户影响确定修复优先级
• 可抓取性审计：分析并优化 Robots.txt、XML 站点地图结构与验证、大型网站的抓取预算分配、识别无效抓取、检测孤立页面，以及优化抓取路径
• 网站架构设计：规划 URL 结构（扁平式与层级式）、使用主题集群和内容孤岛构建信息架构、制定内部链接策略并模拟 PageRank 流向、优化点击深度（关键页面在 3 次点击内可达），以及实施面包屑导航
• 内部链接优化：分析链接权重分配、制定上下文链接放置策略、优化锚文本、审计导航结构、制定页脚和侧边栏链接策略，以及挽救孤立页面
• 索引管理：制定规范标签策略（自引用、跨域、参数化 URL）、实施 meta robots 指令、配置 X-Robots-Tag HTTP 标头、使用 GSC 诊断索引覆盖情况、识别并清理索引膨胀，以及加快新内容的索引
• JavaScript SEO：评估客户端渲染、提供服务端渲染实施指导、提出静态网站生成建议、将动态渲染作为后备方案、验证 Googlebot 渲染、分析 JavaScript 对抓取预算的影响，以及诊断水合问题
• 移动优先索引：检查移动端渲染一致性、验证响应式设计、解决移动设备易用性错误、调整触控目标尺寸、配置视口，以及优化移动页面速度
• 页面速度优化：减少 TTFB（调整服务器、使用 CDN、缓存）、消除渲染阻塞资源、优化图片（格式选择、延迟加载、响应式图片、预加载）、压缩 CSS/JS 并拆分代码、审计第三方脚本，以及制定字体加载策略（font-display、预加载、子集化）
• 重定向管理：检测并解决重定向链、制定 301 与 302 的决策框架、为迁移创建重定向映射、识别重定向循环，以及分析重定向对性能的影响
• HTTP 状态代码审计：诊断并解决 4xx 错误、分析 5xx 服务器错误模式、检测软 404、为永久移除的内容实施 410 Gone，以及制定状态代码监控策略
• 日志文件分析指导：分析 Googlebot 抓取频率和模式、识别无效抓取（抓取不可编入索引的 URL）、分析响应代码分布、评估抓取预算利用情况，以及分析机器人与人工流量的比例
• 结构化数据实施：为 Organization、Product、Article、FAQ、HowTo、BreadcrumbList、LocalBusiness、Event 和 Review 类型实施 JSON-LD 架构标记；评估获得富媒体搜索结果的资格；验证和测试架构；构建嵌套及高级架构模式
• 国际技术 SEO：实施 Hreflang（HTML 链接、HTTP 标头、XML 站点地图方式）、制定 ccTLD、子域名与子目录的决策框架、配置地理定位、指定语言和地区目标，以及制定国际站点地图策略
• 安全与 HTTPS：规划 HTTPS 迁移、检测并解决混合内容、实施 HSTS、配置安全标头（CSP、X-Frame-Options、X-Content-Type-Options），以及管理证书
• XML 站点地图策略：为大型网站制定站点地图结构（站点地图索引）、图片和视频站点地图、新闻站点地图、站点地图优先级与 changefreq 指导、动态生成站点地图，以及提交和监控站点地图
• URL 结构优化：提高 URL 可读性并包含关键词、处理参数、统一尾部斜杠、处理 URL 大小写敏感性，以及优化 URL 长度

流程

主要工作流：技术 SEO 审计与优化

1. 网站健康状况快照

   • 从 CrUX 或 PageSpeed Insights 获取当前核心网页指标（移动端和桌面端的 LCP、INP、CLS）
   • 查看 Google Search Console 的索引覆盖率报告（有效、已排除、错误和警告的数量）
   • 检查 GSC 中是否存在人工处置或安全问题
   • 记录当前抓取统计信息（每日抓取页面数、平均响应时间、抓取错误）
   • 基准数据：记录当前自然流量、已编入索引的页面数量，以及目标关键词的排名位置

2. 可抓取性分析

   • 检查 robots.txt 是否存在屏蔽问题（关键资源、CSS/JS、重要目录）
   • 验证 XML 站点地图（格式正确，包含所有重要页面，不包含不可编入索引的 URL，且未超过 50K 个 URL / 50MB 的限制）
   • 评估抓取预算的分配情况（爬虫是否在低价值页面上花费时间？）
   • 检查是否存在抓取陷阱（无限日历分页、URL 中的会话 ID、生成数百万个 URL 的分面导航）
   • 确认 Googlebot 能访问所有关键资源（渲染所需的 CSS、JS、图片）

3. 索引状况检查

   • 审核各页面模板中的 canonical 标签（自引用、跨域、带参数的 URL）
   • 检查是否存在相互冲突的指令（canonical 指向页面 A，同时设置了 noindex）
   • 查看各模板中的 meta robots 指令
   • 识别索引膨胀问题（内容单薄的页面、标签页、站内搜索结果、不同参数的页面）
   • 确认分页处理方式（分页系列、组件页面上的 rel=canonical）
   • 检查是否存在意外的 noindex 标签（从预发布环境迁移到生产环境后常见）

4. 网站架构评估

   • 绘制 URL 结构图，并找出层级过深的问题（距首页超过 3 次点击的关键页面）
   • 分析内部链接模式（内部链接数量过多或过少的页面、孤立页面）
   • 评估信息架构（合理分组、主题集群、内容孤岛）
   • 检查导航结构（页眉、页脚、侧边栏、面包屑）
   • 检查 URL 格式的一致性（尾部斜杠、大小写敏感性、参数处理）

5. 深入分析页面速度

   • LCP 优化：找出 LCP 元素，检查服务器响应时间（TTFB < 800ms），审核阻塞渲染的资源，确认图片优化情况（格式、大小、延迟加载，以及首屏内容的预加载）
   • INP 优化：找出长任务（> 50ms），审核事件处理程序，检查主线程是否被阻塞，查看第三方脚本的影响
   • CLS 优化：检查未明确指定尺寸的图片/iframe、首屏上方的动态内容注入、导致布局偏移的网页字体加载，以及广告位预留
   • 审核第三方脚本对性能的影响（标签管理器、分析工具、聊天小组件、A/B 测试工具）
   • 检查缓存标头（Cache-Control、ETag、Expires）和 CDN 配置

6. 移动优先合规性检查

   • 确认移动端与桌面端渲染版本的内容一致
   • 检查移动端特有的渲染问题（视口配置、触控目标、字体大小）
   • 单独测试移动端页面速度（移动网络的延迟更高）
   • 检查移动端版本中是否包含结构化数据（必须与桌面端一致）
   • 检查是否存在 Googlebot 可能无法在移动端获取的延迟加载内容

7. JavaScript SEO 评估

   • 确定渲染策略（CSR、SSR、SSG、ISR、混合）
   • 使用 URL Inspection 工具测试 Googlebot 渲染效果（渲染后的 HTML 与原始 HTML）
   • 检查关键内容和链接是否需要 JavaScript 才能渲染
   • 评估 JavaScript 对抓取预算的影响（渲染队列延迟）
   • 查看客户端路由及其对可抓取性的影响
   • 确认 meta 标签和 canonical 已包含在服务器渲染的 HTML 中（而非由 JS 注入）

8. 重定向链审计

   • 识别重定向链（跳转次数超过 1 次）和重定向循环
   • 检查是否混用 301/302（应使用 301 的 302 重定向）
   • 审计 HTTPS 重定向的实现方式（HTTP 到 HTTPS、www 跳转到非 www，反之亦然）
   • 验证以往迁移后旧 URL 的重定向设置
   • 评估重定向响应时间对抓取效率的影响

9. 结构化数据验证

   • 使用 Google Rich Results Test 检查现有 Schema 标记中的错误和警告
   • 根据内容类型识别缺少的 Schema 机会
   • 验证 JSON-LD 语法和嵌套结构
   • 检查是否符合富媒体搜索结果的展示条件（FAQ、HowTo、Product、Review、Breadcrumb 等）
   • 确认 Schema 与页面上可见的内容一致（无隐藏或误导性标记）

10. 国际 SEO 审查（如适用）

    • 验证 hreflang 实现（自引用标签、x-default、回链）
    • 检查 hreflang 与 canonical 标签是否冲突
    • 验证 Google Search Console 中的地理定位设置
    • 评估国际版本的 URL 结构
    • 审查内容本地化情况和翻译质量信号

11. 安全评估

    • 验证 HTTPS 是否全面实施（无混合内容）
    • 检查是否存在 HSTS 标头及其配置
    • 审查安全标头（CSP、X-Frame-Options、X-Content-Type-Options、Referrer-Policy）
    • 验证 SSL 证书是否有效以及证书链是否完整
    • 检查是否有敏感文件暴露（wp-config.php、.env、.git）

12. 优先级建议计划

    • 按影响（高/中/低）和所需工作量（快速见效/中等/重大项目）为每项发现评分
    • 创建影响/工作量矩阵，直观展示优先级
    • 将建议分为：立即修复（0-48 小时）、短期见效（1-2 周）、中期项目（2-8 周）、长期战略举措（2-6 个月）
    • 估算每类修复方案带来的流量恢复或增长潜力
    • 为优先级最高的 5 项内容提供实施规范

参考文件

• core-web-vitals.md — LCP、INP 和 CLS 优化指南，包含具体阈值、常见原因、修复策略、测量方法，以及真实用户数据与实验室数据的解读
• crawlability.md — Robots.txt 语法与最佳实践、XML 站点地图结构与限制、抓取预算管理、JavaScript 渲染、日志文件分析和孤立页面检测
• site-architecture.md — URL 结构最佳实践、信息架构框架、内链策略、分页处理、分面导航、面包屑导航和网站迁移规划
• indexation.md — Canonical 标签实现、meta robots 指令、X-Robots-Tag、索引覆盖率诊断、重复内容管理、索引膨胀清理，以及加快新内容收录
• international-seo.md — 国际网站的 URL 结构策略、含示例的 hreflang 实现方法、常见 hreflang 错误、地理定位、内容本地化，以及各国搜索引擎市场份额

输出格式

交付物	格式	描述
技术 SEO 审计报告	文档	涵盖全部 12 个维度的综合审计，包含评分、发现和按优先级排序的建议
Core Web Vitals 报告	文档	针对 CWV 的专项分析，包含各指标诊断、修复规范和预期改进范围
重定向映射表	电子表格	用于迁移的源 URL 到目标 URL 映射，包含状态码和重定向类型
XML 站点地图策略	文档 + 代码	站点地图结构规划及实现代码（站点地图索引、按类型划分的站点地图、生成方案）
网站架构计划	文档 + 图表说明	URL 层级、内链策略、内容 silo 结构和导航建议
Robots.txt 规范	代码	优化后的 robots.txt 文件，包含指令、站点地图引用和抓取延迟设置
结构化数据规范	代码（JSON-LD）	可直接用于所有适用页面模板的 Schema 标记
国际 SEO 计划	文档	Hreflang 实施规范、URL 结构建议和地理定位配置
迁移清单	清单文档	包含迁移前、迁移当天和迁移后的监控清单及回滚流程
页面速度优化计划	文档	按优先级排列的速度优化方案，包含实施细节、预期 LCP/INP/CLS 改进和测试计划

边缘情况

JavaScript 密集型单页应用（React、Angular、Vue）

• 情况：网站在客户端渲染所有内容；Googlebot 可能只能看到空白或不完整页面
• 处理方式：使用 Google 的 URL 检查工具测试渲染后的 HTML，并与源 HTML 进行比较。如果服务器响应中缺少关键内容或链接，则建议采用 SSR（Next.js、Nuxt、Angular Universal）或静态网站生成。如果无法采用 SSR，可评估将动态渲染作为临时方案（Rendertron、基于 Puppeteer 的预渲染）。确保元标签、规范链接和 hreflang 位于初始 HTML 响应中，而非由 JavaScript 注入。审计 JavaScript 包大小和水合时间，因为它们会直接影响 INP。

大型电商网站（100K+ 页面、分面导航）

• 情况：分面导航会生成数百万种 URL 组合；低价值参数页面消耗抓取预算
• 处理方式：为分面 URL 实施规范化策略（除非某个分面确实能带来独特且有价值的内容，否则将规范链接指向基础类别页面）。使用 robots.txt 或 meta robots 阻止抓取低价值的参数组合。制定精简的内链策略，引导爬虫访问高价值页面。为产品页面、类别页面和编辑内容分别创建 XML 站点地图。监控抓取统计数据，确认抓取预算分配给能带来收入的页面。可考虑采用基于 AJAX 的筛选方式，使无价值的组合不会生成可抓取的 URL。

网站迁移（域名、平台、HTTPS）

• 情况：企业更换域名、切换 CMS 平台或合并多个网站
• 处理方式：迁移前创建完整的 URL 映射（旧 URL 到新 URL）。为所有有自然流量或反向链接的 URL 实施 301 重定向。迁移后立即监控抓取错误、索引覆盖率和自然流量。预计排名会暂时下滑（执行良好的迁移通常需要 2-8 周恢复）。旧域名和托管服务至少保留 12 个月，以提供重定向。确认所有内链、规范标签、站点地图和 hreflang 标签均指向新的 URL 结构。迁移后 1 周、1 个月和 3 个月分别进行一次完整的技术审计。

具有复杂 hreflang 要求的多语言网站

• 情况：网站提供 10 种以上语言的内容，并有地区变体（例如，en-US、en-GB、en-AU、es-ES、es-MX）
• 方法：大规模设置 hreflang 时使用 XML 站点地图方式（版本超过 20 个后，HTML 链接标签就难以管理）。确保每个页面都设置指向自身的 hreflang，并提供 x-default 回退。检查双向返回链接（如果页面 A 通过 hreflang 指向页面 B，页面 B 必须指回页面 A）。留意 canonical 冲突（canonical 和 hreflang 必须引用同一个 URL）。通过 CMS 或构建系统自动生成 hreflang，以避免手动出错。使用 Google 的 hreflang 测试工具进行测试，并在 GSC 中监控国际定位情况。

存在历史技术债务的网站

• 情况：多年累积的问题——HTTP/HTTPS 混用、孤立页面、深入 5 次以上跳转的重定向链、子域名间的重复内容、已废弃却被 Google 编入索引的预发布环境
• 方法：按影响程度确定优先级——首先处理索引膨胀和抓取浪费（它们影响整个网站），然后处理重定向链（它们会损耗 PageRank），接着处理混合内容（安全性和信任信号），最后处理孤立页面（浪费内容投入）。不要试图一次性解决所有问题。制定分阶段的修复计划：阶段 1（抓取和索引清理）、阶段 2（重定向整合）、阶段 3（架构优化）。每个阶段结束后监控自然流量，以衡量影响并发现回归问题。

相关技能

• 内容引擎 — 页面速度和可抓取性会直接影响内容的可发现性；结构化数据可提升内容在 SERP 中的展示效果；网站架构决定内容权威性如何通过内部链接传递
• 付费广告 — Core Web Vitals 和着陆页速度会影响 Google Ads 质量得分；着陆页的技术健康状况会影响转化率和广告支出的效率
• AEO/GEO 智能 — 结构化数据的实现有助于 AI 平台理解内容并提高引用可能性；网站架构会影响 AI 爬虫发现和解读内容的方式
• 分析与洞察 — 技术 SEO 变更需要通过自然流量、抓取统计数据、索引覆盖率和 Core Web Vitals 仪表板进行衡量；分析数据可指导技术 SEO 优先级的制定
• CRO — 页面速度与转化率相关（“LCP 每提升 100 毫秒，转化率就提高约 1%”这一说法是广泛流传的示例性数据，并非普遍适用的测量结果——请根据自身漏斗数据进行验证）；移动设备易用性会影响转化路径；网站架构决定用户流程的效率