agentsclimarketplace
Sign in

30x seo hreflang

Skill norahe0304-art/30x-seo-cn/skills/30x-seo-hreflang

Hreflang 和国际 SEO 审核、验证和生成。检测常见错误，验证语言/地区代码， 生成正确的 hreflang 实现。当用户说"hreflang"、"国际SEO"、"多语言"、 "多地区"或"语言标签"时使用。From its SKILL.md

Install
npx -y skills add norahe0304-art/30x-seo-cn --skill 30x-seo-hreflang

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

7.6 KB, ~2.6k tokens by cl100k_base, as published. Nobody here has run it

Hreflang 与国际 SEO

验证现有 hreflang 实现或为多语言和多地区网站生成正确的 hreflang 标签。 支持 HTML、HTTP 响应头和 XML 站点地图实现。

验证检查

1. 自引用标签

  • 每个页面必须包含指向自身的 hreflang 标签
  • 自引用 URL 必须与页面的 canonical URL 完全匹配
  • 缺少自引用标签会导致 Google 忽略整个 hreflang 集

2. 返回标签

  • 如果页面 A 用 hreflang 链接到页面 B，页面 B 必须链接回页面 A
  • 每个 hreflang 关系必须是双向的（A→B 和 B→A）
  • 缺少返回标签会使两个页面的 hreflang 信号失效
  • 检查所有语言版本是否互相引用（完整网状）

3. x-default 标签

  • 必需：指定未匹配语言/地区的回退页面
  • 通常指向语言选择页面或英文版本
  • 每组备选项只有一个 x-default
  • 必须从所有其他语言版本获得返回标签

4. 语言代码验证

  • 必须使用 ISO 639-1 两字母代码（如 en、fr、de、ja）
  • 常见错误：
    • eng 而非 en（ISO 639-2，对 hreflang 无效）
    • jp 而非 ja（日语的错误代码）
    • zh 没有地区限定符（模糊 — 使用 zh-Hans 或 zh-Hant）

5. 地区代码验证

  • 可选的地区限定符使用 ISO 3166-1 Alpha-2（如 en-US、en-GB、pt-BR）
  • 格式：language-REGION（小写语言，大写地区）
  • 常见错误：
    • en-uk 而非 en-GB（UK 不是有效的 ISO 3166-1 代码）
    • es-LA（拉丁美洲不是国家 — 使用具体国家）
    • 没有语言前缀的地区

6. Canonical URL 对齐

  • Hreflang 标签只能出现在 canonical URL 上
  • 如果页面有 rel=canonical 指向其他地方，该页面上的 hreflang 被忽略
  • Canonical URL 和 hreflang URL 必须完全匹配（包括尾部斜杠）
  • 非 canonical 页面不应出现在任何 hreflang 集中

7. 协议一致性

  • hreflang 集中的所有 URL 必须使用相同协议（HTTPS 或 HTTP）
  • hreflang 集中混合 HTTP/HTTPS 导致验证失败
  • HTTPS 迁移后，更新所有 hreflang 标签为 HTTPS

8. 跨域支持

  • Hreflang 可跨不同域工作（如 example.com 和 example.de）
  • 跨域 hreflang 需要两个域都有返回标签
  • 验证两个域都在 Google Search Console 中验证
  • 跨域设置推荐使用基于站点地图的实现

常见错误

问题严重性修复
缺少自引用标签严重添加指向同一页面 URL 的 hreflang
缺少返回标签（A→B 但没有 B→A）严重在所有备选项上添加匹配的返回标签
缺少 x-default高添加指向回退/选择页面的 x-default
无效语言代码（如 eng）高使用 ISO 639-1 两字母代码
无效地区代码（如 en-uk）高使用 ISO 3166-1 Alpha-2 代码
非 canonical URL 上的 hreflang高只在 canonical URL 上放置 hreflang
URL 中 HTTP/HTTPS 不匹配中统一所有 URL 为 HTTPS
尾部斜杠不一致中精确匹配 canonical URL 格式
HTML 和站点地图中都有 hreflang低选择一种方法 — 大型网站推荐站点地图
需要时语言没有地区低为地理定向内容添加地区限定符

实现方法

方法 1：HTML Link 标签

最适合：每页语言/地区变体 <50 的网站。

<link rel="alternate" hreflang="en-US" href="https://example.com/page" />
<link rel="alternate" hreflang="en-GB" href="https://example.co.uk/page" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />

放在 <head> 部分。每个页面必须包含所有备选项包括自身。

方法 2：HTTP 响应头

最适合：非 HTML 文件（PDF、文档）。

Link: <https://example.com/page>; rel="alternate"; hreflang="en-US",
      <https://example.com/fr/page>; rel="alternate"; hreflang="fr",
      <https://example.com/page>; rel="alternate"; hreflang="x-default"

通过服务器配置或 CDN 规则设置。

方法 3：XML 站点地图（大型网站推荐）

最适合：有许多语言变体、跨域设置或 50+ 页面的网站。

参见下方 Hreflang 站点地图生成部分。

方法比较

方法最适合优点缺点
HTML link 标签小型网站（<50 变体）易于实现，源码可见<head> 膨胀，规模化难维护
HTTP 响应头非 HTML 文件适用于 PDF、图片服务器配置复杂，HTML 中不可见
XML 站点地图大型网站、跨域可扩展，集中管理页面上不可见，需要站点地图维护

Hreflang 生成

流程

  1. 检测语言：扫描网站的语言指示器（URL 路径、子域、TLD、HTML lang 属性）
  2. 映射等效页面：匹配跨语言/地区的对应页面
  3. 验证语言代码：对照 ISO 639-1 和 ISO 3166-1 验证所有代码
  4. 生成标签：为每个页面创建 hreflang 标签包括自引用
  5. 验证返回标签：确认所有关系是双向的
  6. 添加 x-default：为每组页面设置回退
  7. 输出：生成实现代码（HTML、HTTP 响应头或站点地图 XML）

Hreflang 站点地图生成

带 Hreflang 的站点地图

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://example.com/page</loc>
    <xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/page" />
    <xhtml:link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
    <xhtml:link rel="alternate" hreflang="de" href="https://example.de/page" />
    <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/page" />
  </url>
  <url>
    <loc>https://example.com/fr/page</loc>
    <xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/page" />
    <xhtml:link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
    <xhtml:link rel="alternate" hreflang="de" href="https://example.de/page" />
    <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/page" />
  </url>
</urlset>

关键规则：

  • 包含 xmlns:xhtml 命名空间声明
  • 每个 <url> 条目必须包含所有语言备选项（包括自身）
  • 每个备选项必须作为单独的 <url> 条目，有自己完整的集合
  • 每个站点地图文件在 50,000 URL 处拆分

输出

Hreflang 验证报告

摘要

  • 扫描的页面总数：XX
  • 检测到的语言变体：XX
  • 发现的问题：XX（严重：X，高：X，中：X，低：X）

验证结果

语言URL自引用返回标签x-default状态
en-UShttps://...✅✅✅✅
frhttps://...❌⚠️✅❌
dehttps://...✅❌✅❌

生成的 Hreflang 标签

  • HTML <link> 标签（如果选择 HTML 方法）
  • HTTP 响应头值（如果选择响应头方法）
  • hreflang-sitemap.xml（如果选择站点地图方法）

建议

  • 需要添加的缺失实现
  • 需要修复的错误代码
  • 方法迁移建议（如 HTML → 站点地图以便扩展）

[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most marketing audience skills give in ~2.6k tokens

Counted across 690 of the 894 authors here whose files we hold, read 2026-08-07

  • Apply Poppins font to headingsin 41 of 690, across 6 files
  • Apply Lora font to body textin 41 of 690, across 6 files
  • Use Arial fallback for headingsin 39 of 690, across 4 files
  • Use Georgia fallback for body textin 39 of 690, across 4 files
  • Maintain text hierarchy and formattingin 39 of 690, across 4 files
  • Use accent colors for non-text shapesin 38 of 690, across 3 files
  • Use RGB values for precise color matchingin 38 of 690, across 3 files
  • Use brand colors for primary text and backgroundsin 36 of 690, across 1 file
  • Read product marketing context file before asking questions, starting, or auditingin 35 of 690, across 23 files
  • Use active voice instead of passive voicein 26 of 690, across 10 files
  • Implement or generate appropriate JSON-LD structured datain 24 of 690, across 17 files
  • Prioritize clarity over clevernessin 22 of 690, across 8 files

Said here and by no other author read

  • Generate implementation code including self-references

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.