gsc-assistant

GSC 助手技能

用途

此技能通过维护两个 Markdown 跟踪文件，帮助管理 Google Search Console 的索引状态：

1. indexed.md - 分为两个表格，列出所有已编入索引的页面：

   • “Indexed Public”——GSC 导出数据中确认的 URL
   • “Indexed With Lag”——通过 URL Inspection 确认、但尚未出现在导出数据中的 URL

2. to-index.md - 列出等待编入索引的页面：

   • 站点地图与已编入索引的 URL 总数之间的差异
   • 按类别排序（可配置优先级）
   • 跟踪提交日期

何时使用此技能

• 用户询问“索引状态”或“GSC 索引”
• 用户想要“比较站点地图与已编入索引的页面”
• 用户提到“URL Inspection”或“误报”
• 用户需要“跟踪提交”或“索引进度”
• 用户要求“移动已编入索引的页面”或“更新索引状态”
• 用户想要“生成索引报告”

核心概念

GSC 数据延迟

Google Search Console 导出数据大约会延迟 2 周。URL Inspection 中显示已编入索引的页面，可能尚未出现在导出数据中。这些页面会单独跟踪为“Indexed With Lag”。

误报

通过 URL Inspection 检查待索引页面时：

• 如果已编入索引：在 Submitted 列中标记为“false positive - indexed”
• 预处理会将这些页面移至 indexed.md（Indexed With Lag 表格）
• “Detected”日期根据条目添加到 to-index 的时间推断

优先级类别

to-index.md 按优先级组织页面：

• 优先级 1：高价值内容系列
• 优先级 2：近期内容（当年／上一年）
• 优先级 3：特定内容合集
• 更低优先级：归档页面、分页等

文件结构

indexed.md

# Indexed Pages

## Indexed Public (GSC Export)

*Last updated: YYYY-MM-DD*
*Source: gsc-export.csv*

| # | URL | Last Crawled |
|---|-----|--------------|
| 1 | https://example.com/page-1/ | 2025-12-01 |
| 2 | https://example.com/page-2/ | 2025-12-02 |

## Indexed With Lag (URL Inspection Confirmed)

*Pages confirmed indexed via URL Inspection but not yet in GSC export*

| # | URL | Detected | Confirmed |
|---|-----|----------|-----------|
| 1 | https://example.com/new-page/ | 12 Dec 2025 | 12 Dec 2025 |

to-index.md

# Pages To Index

*Generated: YYYY-MM-DD*
*Total: X pages*

## Priority 1: [Category Name]

| # | URL | Submitted |
|---|-----|-----------|
| 1 | https://example.com/important-page/ | 12 Dec |
| 2 | https://example.com/another-page/ | - |

## Priority 2: [Category Name]

| # | URL | Submitted |
|---|-----|-----------|
| 1 | https://example.com/recent-post/ | - |

工作流

初始设置

1. 导入 GSC 导出 CSV，创建 indexed.md（Indexed Public 表格）
2. 提取站点地图 URL
3. 计算差异（站点地图 - 已编入索引 = 待索引）
4. 按优先级对待索引页面分类
5. 生成 to-index.md

定期更新

1. 预处理：扫描 to-index.md，查找标记为“false positive - indexed”的条目
2. 将误报移至 indexed.md（Indexed With Lag 表格）
3. 根据条目位于 to-index 中的时间设置“Detected”日期
4. 将“Confirmed”日期设为当前日期
5. 从 to-index.md 中移除
6. 更新数量和统计信息

手动操作

• 标记提交：使用日期更新“Submitted”列
• 检查状态：使用 URL Inspection，并标记结果
• 刷新数据：导入新的 GSC 导出数据并重新计算

配置

在项目目录中创建工作文件：

project/
├── gsc-export.csv          # GSC indexed pages export
├── sitemap.xml             # Site sitemap (or use dist/sitemap.xml)
├── indexed.md              # Tracking file (generated)
└── to-index.md             # Tracking file (generated)

命令

生成初始文件

"Generate indexing tracking files from GSC export and sitemap"

预处理误报

"Process false positives and update indexed list"

更新提交状态

"Mark [URL] as submitted on [date]"

从新导出数据刷新

"Update indexed list from new GSC export"

生成统计信息

"Show indexing progress statistics"

统计信息输出

INDEXING STATUS SUMMARY
=======================

Indexed Public (GSC):     789 pages
Indexed With Lag:          12 pages
Total Indexed:            801 pages

Sitemap Total:          2,054 pages
To Index:               1,253 pages

Progress:                 39.0%

By Priority:
- Priority 1: 55 remaining (4 false positives moved)
- Priority 2: 7 remaining
- Priority 3: 290 remaining

使用示例

用户：“我刚在 GSC URL Inspection 中检查了一些 URL，并将它们标记为 false positive - indexed。请处理这些条目并更新跟踪文件。”

Claude 将会：

1. 扫描 to-index.md，查找标记为“false positive - indexed”的条目
2. 提取这些 URL 及其原始检测日期
3. 将它们添加到 indexed.md 的 Indexed With Lag 表格
4. 从 to-index.md 中移除它们
5. 更新行号和数量
6. 报告所做的更改