用途:帮助跟踪 Google Search Console(GSC)的页面收录状态,通过维护两个 Markdown 跟踪文件来管理收录进度。indexed.md 记录已收录页面,分为“Indexed Public”(GSC 导出数据中确认的 URL)和“Indexed With Lag”(经 URL Inspection 确认但尚未出现在导出数据中的 URL)两张表;to-index.md 记录待收录页面,即 sitemap 与已收录 URL 的差集,按可配置的优先级分类并跟踪提交日期。
主要能力:导入 GSC 导出 CSV 生成 indexed.md;提取 sitemap URL 并计算差集;按优先级分类生成 to-index.md;处理“false positive - indexed”条目,将其从 to-index.md 移入 indexed.md 的 Indexed With Lag 表;标记提交日期;刷新导出数据;生成收录进度统计。
使用方式:在项目目录中准备 gsc-export.csv、sitemap.xml(或 dist/sitemap.xml),生成 indexed.md 与 to-index.md。常用指令包括“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”。
关键概念:GSC 导出数据约有 2 周延迟,URL Inspection 显示已收录但导出未体现的页面单独记为 Indexed With Lag;URL Inspection 确认已收录的待收录页面标记为 false positive - indexed,预处理时移入 indexed.md,Detected 日期取该条目加入 to-index 的时间。
适用场景:查询收录状态、对比 sitemap 与已收录页面、URL Inspection 与误报处理、跟踪提交与收录进度、生成收录报告。
限制:依赖 GSC 导出数据与 sitemap 文件;导出数据存在约两周延迟;具体优先级分类规则需自行配置;资料未提供自动化抓取或 API 集成方式。