问题修复
需要分析或生成 XML sitemap、排查…
用于分析现有 XML sitemap 或按行业模板生成新 sitemap,并校验格式、URL、lastmod、扩展类型和结构质量
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要分析或生成 XML sitemap、通用
解决思路
- 分析现有 sitemap:在报告 sitemap 缺失前运行 `"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run sitemap_discovery.py <url> --json` 发现候选。
- 该 helper 会读取 robots.txt 中每个有界的 `Sitemap:` 声明,通过共享的 SSRF-safe fetch 层验证跨主机目标;当已声明 sitemap 过期或无效时,仍探测常见路径。
- 只使用 `found` 中的条目;将已声明失败保留为 findings,不要仅凭 robots.txt 中的一行就认定 sitemap 可用。
- 校验 XML 格式是否有效。
- 检查单文件限制:≤50,000 URLs 且 ≤50MB 未压缩,以先达到者为准。
- 检查所有 URL 是否返回 HTTP 200。
- 检查 `<lastmod>` 是否准确:必须是有效的 W3C Datetime,并反映最后一次重要内容变更(正文内容、结构化数据、链接,而不是版权或样板文字编辑);Google 只在一致且可验证准确时认可 `<lastmod>`,因此当值异常统一或比页面真实内容更新时发出警告。
- 标记或移除已废弃标签:Google 忽略 `<priority>` 和 `<changefreq>`。
- 确保 sitemap 在 robots.txt 中被引用。
- 比较爬取页面与 sitemap,标记缺失页面。
- 当 URL 数 >50k 时使用 sitemap index 文件。
- 按内容类型拆分 sitemap(pages、posts、images、videos)。
- 确保 sitemap 中没有非 canonical URL。
- 确保 sitemap 中没有 noindexed URL。
- 确保 sitemap 中没有重定向 URL。
- 仅使用 HTTPS URL,不要使用 HTTP URL。
- 修复:单文件 >50k URLs 为 Critical,用 sitemap index 拆分。
- 修复:单文件 >50MB 未压缩为 Critical,用 sitemap index 拆分。
- 修复:非 200 URL 为 High,移除或修复损坏 URL。
- 修复:包含 noindexed URL 为 High,从 sitemap 移除。
- 修复:包含重定向 URL 为 Medium,更新为最终 URL。
- 修复:所有 lastmod 相同为 Low,使用实际修改日期。
- 修复:使用 priority/changefreq 为 Info,可移除(Google 忽略)。
- 对 image / video / news 三种扩展 sitemap 子类型分别按其规则验证。
- Image sitemap(`http://www.google.com/schemas/sitemap-image/1.1`):仅保留两个有效标签 `<image:image>` 和 `<image:loc>`;每个 `<url>` 最多 1,000 个 `<image:image>`;将 `<image:caption>`、`<image:geo_location>`、`<image:title>`、`<image:license>` 作为 2022 年已废弃项标记为 info 级可移除。
- Video sitemap:必需的 `<video:video>` 包含 `<video:thumbnail_loc>`、`<video:title>`、`<video:description>`,以及 `<video:content_loc>` 或 `<video:player_loc>`;也支持 mRSS;将已废弃/移除标签(`<video:category>`、`<video:gallery_loc>`、`<video:price>`、`<video:tvshow>`、player autoplay/allow_embed)标记为 info 级可移除;引用移除日期前重新核对 Google 文档。
- News sitemap:每个文件最多 1,000 个 `<news:news>`,不是 50,000;只包含最近 2 天的文章;必需 `<news:publication>`、`<news:name>`、`<news:language>`、`<news:publication_date>`、`<news:title>`;通过 Search Console 或 robots.txt/sitemap index 提交/发现;仅在相关时用 Publisher Center 管理出版物;检测到 `news:` namespace 时,用 1,000 上限覆盖通用 50k 检查。
- 生成新 sitemap:询问业务类型,或从现有站点自动检测。
- 从 `../seo-plan/assets/` 目录加载行业模板。
- 与用户交互式规划站点结构。
- 应用质量门禁:在 30+ location pages 时发出 WARNING,要求 60%+ 独特内容。
- 应用质量门禁:在 50+ location pages 时 HARD STOP,要求提供理由。
- 生成有效 XML 输出。
- 以先达到者为准拆分:50,000 URLs 或 50MB 未压缩,并生成 sitemap index。
- 生成 STRUCTURE.md 文档。
- 可规模化生成:Integration pages(附真实设置文档)。
- 可规模化生成:Template/tool pages(附可下载内容)。
- 可规模化生成:Glossary pages(200+ 词定义)。
- 可规模化生成:Product pages(独特规格、评论)。
- 可规模化生成:User profile pages(用户生成内容)。
- 规模化时避免:仅替换城市名的 location pages。
- 规模化时避免:没有行业特定价值的 「Best [tool] for [industry]」。
- 规模化时避免:没有真实对比数据的 「[Competitor] alternative」。
- 规模化时避免:未经人工审核且无独特价值的 AI-generated pages。
- 标准 sitemap 使用 `<urlset>`,其 `xmlns` 为 `http://www.sitemaps.org/schemas/sitemap/0.9`,每个 URL 包含 `<loc>` 和 `<lastmod>`。
- 当 >50k URLs 时,sitemap index 使用 `<sitemapindex>`,其 `xmlns` 为 `http://www.sitemaps.org/schemas/sitemap/0.9`,每个 `<sitemap>` 包含 `<loc>` 和 `<lastmod>`。
- 错误处理:URL 不可达时,报告 HTTP 状态码,并建议检查站点是否在线。
- 错误处理:未找到 sitemap 时,运行 `sitemap_discovery.py`;仅当声明的和常见候选检查后 `found` 列表为空时才报告 「not found」。
- 错误处理:XML 格式无效时,报告带行号的具体解析错误。
- 错误处理:检测到限流时,退避并报告部分结果,附上重试时间说明。
- 分析输出:生成 `VALIDATION-REPORT.md`:分析结果;生成按严重级别的问题列表;生成建议。
- 生成输出:生成 `sitemap.xml`(或拆分文件加 index);生成 `STRUCTURE.md`:站点架构文档;生成 URL 数量和结构摘要。
适用边界 · 注意事项
- 当目标不是 XML sitemap / SEO 站点地图,或只需要检查单个页面 URL 时,不适用。
- 不要用于规模化生成仅替换城市名、无行业特定价值、无真实对比数据或未经人工审核的 AI 生成页面;这类页面有惩罚风险。
- News sitemap 不要套用通用 50,000 条上限,也不要包含超过最近 2 天的文章。