seo-sitemap

seo-sitemap

热门

分析现有的XML站点地图或使用行业模板生成新的站点地图。验证格式、URL和结构。当用户提到“站点地图”、“生成站点地图”、“站点地图问题”或“XML站点地图”时使用。

1.2万Star
1738Fork
更新于 2026/7/20
SKILL.md
readonly只读
name
seo-sitemap
description

分析现有的XML站点地图或使用行业模板生成新的站点地图。 验证格式、URL和结构。当用户提到“站点地图”、 “生成站点地图”、“站点地图问题”或“XML站点地图”时使用。

站点地图分析与生成

模式1:分析现有站点地图

在报告站点地图缺失之前,先发现候选站点地图:

claude-seo run sitemap_discovery.py <url> --json

该辅助工具读取robots.txt中每个有界的Sitemap:声明,通过共享的SSRF安全获取层验证跨主机目标,并在声明的站点地图过期或无效时仍然探测常见路径。仅使用found中的条目;将声明的失败保留为发现结果,而不是仅凭robots.txt中的一行就证明站点地图有效。

验证检查

  • 有效的XML格式
  • 每个文件限制:≤50,000个URL且≤50MB未压缩(以先达到者为准)
  • 所有URL返回HTTP 200
  • <lastmod>准确:必须是有效的W3C日期时间,并反映最后一次重要内容更改(主要内容、结构化数据、链接,而非版权/样板编辑)。Google仅在<lastmod>一致且可验证准确时才认可,因此当值可疑地统一或比页面实际内容更新时发出警告。
  • 无已弃用标签:Google忽略<priority><changefreq>
  • 站点地图在robots.txt中被引用
  • 比较爬取页面与站点地图;标记缺失页面

质量信号

  • 如果超过50k个URL,使用站点地图索引文件
  • 按内容类型拆分(页面、文章、图片、视频)
  • 站点地图中无非规范URL
  • 站点地图中无noindexed URL
  • 站点地图中无重定向URL
  • 仅HTTPS URL(无HTTP)

常见问题

问题 严重程度 修复
单个文件中超过50k个URL 严重 使用站点地图索引拆分
单个文件未压缩超过50MB 严重 使用站点地图索引拆分
非200 URL 移除或修复损坏的URL
包含noindexed URL 从站点地图中移除
包含重定向URL 更新为最终URL
所有lastmod相同 使用实际修改日期
使用了priority/changefreq 信息 可移除(Google忽略)

扩展站点地图(图片/视频/新闻)

Google记录了三种子类型及其各自规则,按子类型验证:

  • 图片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年弃用,标记为信息级别可移除。
  • 视频:必需的<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>、播放器自动播放/allow_embed)为信息级别可移除;在引用移除日期前重新检查Google文档。
  • 新闻:每个文件最多1,000<news:news>(而非50,000);仅包含最近2天内的文章;必需的<news:publication>/<news:name>/<news:language>/<news:publication_date>/<news:title>;通过Search Console或robots.txt/站点地图索引提交/发现;仅在相关时使用Publisher Center进行出版物管理。当检测到news:命名空间时,将通用的50k检查覆盖为1,000上限。

模式2:生成新站点地图

流程

  1. 询问业务类型(或从现有网站自动检测)
  2. ../seo-plan/assets/目录加载行业模板
  3. 与用户交互式规划结构
  4. 应用质量门控:
    • ⚠️ 30+个位置页面时警告(要求60%+独特内容)
    • 🛑 50+个位置页面时硬性停止(需要理由)
  5. 生成有效的XML输出
  6. 以先达到者为准拆分:50,000个URL或50MB未压缩,并生成站点地图索引
  7. 生成STRUCTURE.md文档

安全的程序化页面(可规模化)

✅ 集成页面(附真实设置文档)
✅ 模板/工具页面(附可下载内容)
✅ 术语表页面(200+字定义)
✅ 产品页面(独特规格、评论)
✅ 用户个人资料页面(用户生成内容)

惩罚风险(避免规模化)

❌ 仅替换城市名称的位置页面
❌ 没有行业特定价值的“最佳[工具]用于[行业]”
❌ 没有真实比较数据的“[竞争对手]替代品”
❌ 未经人工审核且无独特价值的AI生成页面

站点地图格式

标准站点地图

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/page</loc>
    <lastmod>2026-02-07</lastmod>
  </url>
</urlset>

站点地图索引(用于超过50k个URL)

<?xml version="1.0" encoding="UTF-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <sitemap>
    <loc>https://example.com/sitemap-pages.xml</loc>
    <lastmod>2026-02-07</lastmod>
  </sitemap>
  <sitemap>
    <loc>https://example.com/sitemap-posts.xml</loc>
    <lastmod>2026-02-07</lastmod>
  </sitemap>
</sitemapindex>

错误处理

  • URL不可达:报告HTTP状态码,并建议检查网站是否在线
  • 未找到站点地图:运行sitemap_discovery.py,仅当其found列表在检查声明和常见候选后为空时报告“未找到”
  • 无效的XML格式:报告具体的解析错误及行号
  • 检测到速率限制:退避并报告部分结果,附上重试时间的说明

输出

分析输出

  • VALIDATION-REPORT.md:分析结果
  • 问题列表及严重程度
  • 建议

生成输出

  • sitemap.xml(或带索引的拆分文件)
  • STRUCTURE.md:网站架构文档
  • URL计数和组织摘要