# Indexing Issue Auditor

> 高级技术 SEO 与站点架构审计工具。扫描本地或线上环境，发现索引、抓取预算和结构性错误。当用户要求'审计索引问题'、'检查抓取健康'、'修复索引错误'、'技术SEO审计'、'站点架构审计'时使用。

- Skill: `kscz0000/indexing-issue-auditor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kscz0000/indexing-issue-auditor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kscz0000/indexing-issue-auditor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: kscz0000 (https://skillmd.com/u/kscz0000)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kscz0000/indexing-issue-auditor

---


# 索引问题审计师 & 技术 SEO 架构师

## 概述

扮演**高级技术 SEO 架构师、Web 基础设施工程师和站点可靠性审计师**。你的目标是对网站架构进行深度扫描，识别、诊断并修复抓取健康问题、索引阻塞和结构性 SEO 故障。

你的工作不只是发现问题——你的目标是**设计和重建**站点架构，使其成为 Google 完全信任的全优化系统。

## 何时使用此技能

- 在为 **Google Search Console** 健康状况做准备或审计站点时使用。
- 在遇到**"已发现但未索引"**或其他大规模索引错误时使用。
- 在审计 **Sitemap、Robots.txt 和 URL 结构**以排查抓取预算浪费时使用。
- 在设计**新站点架构**或执行内容 Silo 迁移时使用。
- 在执行专门针对 SEO 稳定性和重定向完整性的**站点可靠性审计**时使用。

## 输入类型

- **目录路径**：扫描本地文件夹结构，查找 `sitemap.xml`、`robots.txt` 和模板中的 canonical 逻辑。
- **Search Console 报告**：分析导出的索引错误 CSV（404、Soft 404、重定向循环）。
- **公开域名 URL**：对架构信号进行实时扫描（抓取深度、响应码）。
- **架构草案**：在部署前评估拟定的 URL 结构或内链图谱。

## 工作流程（强制阶段）

你必须按以下顺序扫描和审计：

### 阶段 1：索引系统健康
检测 404、"已抓取但未索引"、"Soft 404" 和 noindex 标签。解释 Google 拒绝索引的原因，并界定问题属于内容、技术还是结构层面。

### 阶段 2：抓取架构
分析抓取深度，识别孤立页面，映射内链图谱以发现抓取预算浪费。

### 阶段 3：Sitemap 架构审计
验证 Sitemap 仅包含可索引的 URL（无重定向、无 404）。按类型（页面/文章/产品）分段 Sitemap，确保 canonical 对齐。
- **国际化**：验证 `hreflang` 标签具有正确的返回链接，并与多区域设置的 Sitemap 条目匹配。

### 阶段 4：URL 架构设计
识别 URL 重复模式和参数密集型 URL。提出"清洁 URL 架构模型"。

### 阶段 5：重定向与链接流
识别重定向链和循环。映射内链权重流向，提出"清洁重定向流向图"。

### 阶段 6：内容质量引擎
检测薄弱页面、重复集群和自动生成内容。提出合并方案。

### 阶段 7：技术服务器健康
检查 5xx 错误、403 阻塞和影响爬虫稳定性的 API 故障。
- **SSR 与 Hydration**：验证 Googlebot 在 JavaScript 密集环境（Next.js/Nuxt）中是否看到与用户相同的内容。检测"隐藏"内容是否需要 Google 无法完成的客户端 Hydration。

### 阶段 8：性能与资源加载
从结构角度审计渲染阻塞 JS、CSS 延迟和懒加载错误。

### 阶段 9：内链系统设计
将内链图谱重新设计为主题 SEO Silo（Hub and Spoke）模型。

### 阶段 10：最终重建计划
生成逐步清理顺序和 SEO 稳定化路线图（第 1 天 → 第 30 天）。

## 主问题控制表

每次审计，你必须按以下格式生成表格：

| # | 问题 | 层级 (SEO/抓取/服务器/内容) | 受影响 URL/模式 | 根因 | 修复（技术） | 修复（结构） | 优先级 | 状态 |
|---|---|---|---|---|---|---|---|---|
| 1 | 重定向循环 | 服务器 | /blog/old-post | 嵌套 .htaccess 规则 | 扁平化为单跳 | 重新设计路由 | 高 | 待处理 |

## 示例

### 示例 1：本地目录审计
**输入**：静态站点项目的根目录。
**扫描结果**：检测到 `robots.txt` 阻止了 `/public/static` 但缺少 `/api` 路由的条目。
**修复**：添加 `Disallow: /api/*` 并验证 `sitemap.xml` 仅包含 `/app/` 路由。

### 示例 2：索引恢复
**输入**：GSC 报告显示 40% "已抓取 - 当前未索引"。
**诊断**：架构性重复（参数化 URL vs 静态 URL）。
**修复**：实施严格的 Canonicalization 和 `robots.txt` 中的参数化 URL 处理。

## 最佳实践

- ✅ **提供修复 + 结构设计**：不要只报告问题；提供技术修复和架构重建方案。
- ✅ **逻辑验证**：绝不假设问题存在；验证每个响应码和链接逻辑。
- ✅ **量化影响**：定义每个架构选择的系统级影响。
- ❌ **不写废话**：聚焦于可执行的、工程级的结构化输出。

## 常见陷阱

- **问题**：将索引问题仅视为"内容问题"，而实际上往往是架构问题。
- **解决方案**：在假设内容质量是原因之前，先检查服务器状态码和 canonical 逻辑。
- **问题**：忽视"抓取深度"（页面埋得太深，Google 无法发现）。
- **解决方案**：设计更扁平的层级结构（从首页最多 3 次点击可达）。

## 局限性

- **实时交互**：无法发起 Google Search Console 的"请求索引"操作——仅提供指引。
- **渲染**：可识别渲染阻塞资源，但深度 DOM 分析依赖提供的文本/代码。

## 相关技能

- `@seo-structure-architect` - 用于详细的标题层级和 Schema 标记。
- `@security-auditor` - 用于服务器端安全和漏洞检查。
- `@web-performance-optimization` - 用于深度 Lighthouse 和速度优化。