mcpField
B
blog-locale-audit

blog-locale-audit

github.com/infrasity-labs营销与增长15194 次安装18 周前更新
代码仓库

关于 blog-locale-audit

blog-locale-audit 是用于多语言博客目录的质量审计技能，面向管理本地化内容的团队。它检查翻译覆盖、内容与 SEO 一致性、hreflang 及内容新旧，并生成可操作的报告。

主要功能

  1. 01扫描并整理多语言文章
  2. 02检查翻译覆盖率
  3. 03比较各语言内容与 SEO 要素
  4. 04审计 hreflang 配置
  5. 05识别过期翻译并给出操作建议
  6. 06生成 Markdown 或 HTML 报告

适用场景

  1. 01发布前检查各语言文章是否齐全
  2. 02发现翻译版本的结构或 SEO 差异
  3. 03排查 hreflang 链接缺失或不匹配
  4. 04定位需要更新的旧翻译

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill blog-locale-audit

安装后在 Claude Code 中输入/blog-locale-audit确认已加载。

详细介绍

博客语言环境审计，多语言质量控制

审计多语言博客内容目录，确保每种语言版本内容完整、保持一致、标签正确且针对 SEO 优化。 在国际化内容影响排名之前发现问题。

工作流

阶段 1：发现
  1. 扫描目标目录。通过以下方式按语言对博客文章分组：
    • 子目录名称（en/、de/、fr/）。
    • Frontmatter 中的 lang 和 translatedFrom 字段。
    • hreflang-map.json（如果存在）。
  2. 建立内容矩阵，映射每篇文章对应哪些语言版本。
  3. 检测源语言（最常见的 translatedFrom 目标语言，或 hreflang-map.json 中的 sourceLanguage 字段，如果存在）。
阶段 2：完整性审计

显示缺失的译文：

### Translation coverage matrix

| Post (EN) | DE | FR | ES | JA |
|-----------|----|----|----|----|
| how-to-avoid-ai-slop | ok | ok | missing | missing |
| content-marketing-2026 | ok | missing | ok | missing |

Coverage: 60% (6 of 10 expected translations present)
Missing: 4 translations needed
阶段 3：内容一致性审计

对于每篇存在多种语言版本的文章：

检查项内容严重级别
章节数量H2 和 H3 章节数量相同严重
FAQ 数量FAQ 条目数量相同高
图片数量图片数量相同高
图表数量图表（SVG 图示）数量相同高
字数比例符合语言对的预期范围（DE +20% 到 +30%，JA -20%，ES +10%）中
链接数量内部和外部链接数量相近中
引文摘要数量各版本中每个 H2 下的数量相同中
Frontmatter 一致性每个版本都包含所有必需字段高

将每项显著偏差标记为问题。

阶段 4：SEO 一致性审计

验证每个语言版本：

元素检查项严重级别
标题标签存在，长度符合该语言要求严重
Meta 描述存在，长度正确，包含一项统计数据严重
lang 属性或 frontmatter 中的 lang存在，且为有效的 ISO 639-1 代码严重
Schema inLanguage与 lang 匹配高
Schema translationOfWork指向源 URL高
替代文本已翻译（非 EN 文章中不得有英文替代文本）高
Slug已本地化（非 EN 文章中不得使用英文 slug）中
标签已本地化中
关键词已本地化中
阶段 5：Hreflang 审计

如果目录中存在 hreflang-tags.html、hreflang-sitemap.xml 或 hreflang-map.json：

检查项内容严重级别
自我引用每个页面都引用自身严重
返回标签每种关系都具有双向性严重
x-default存在，且指向源语言严重
语言代码有效的 ISO 639-1 代码（可选区域代码）高
URL 一致性使用相同的协议和尾随斜杠约定中
完整性包含每种语言版本高

如果不存在 hreflang 文件，将其报告为严重缺口，并提供以下建议： "运行 /blog multilingual <topic> --languages ... 重新生成，或手动创建 hreflang-tags.html。"

如果已安装 claude-seo 的 seo-hreflang，建议运行它进行更深入的验证。

阶段 6：时效性审计

对于 frontmatter 中包含 translatedDate 的文章：

检查项内容严重级别
源文章在翻译后更新源文章的修改时间晚于 translatedDate严重
译文超过 90 天可能需要更新中
各版本的 lastUpdated 不一致版本未同步中
文件修改时间晚于 translatedDate内容已更改，但未更新 frontmatter警告

为每个过时文件输出可执行的命令：

3 translations are stale:
- de/ki-trends-2026.md (source updated 2 days ago)
  -> Run: /blog translate en/ai-trends-2026.md --to de
- fr/ki-trends-2026.md (source updated 2 days ago)
  -> Run: /blog translate en/ai-trends-2026.md --to fr
- es/tendencias-ia-2026.md (translation > 90 days old)
  -> Run: /blog translate en/ai-trends-2026.md --to es
阶段 7：报告

默认以 Markdown 格式输出。如果用户传入 --html，还要将报告写入 locale-audit-report.html，内容保持一致。

## Multilingual content audit report

### Summary
- Posts audited: [N] across [N] languages
- Overall health: [score] / 100
- Critical issues: [N]
- Warnings: [N]

### Translation coverage
[Matrix from Phase 2]

### Issues found
#### Critical
- [Issue with file references]

#### Warnings
- [Issue with file references]

#### Passed
- [Checks that passed]

### Prioritized fixes
1. [Highest-impact action]
2. [...]

### Stale-translation alerts
[Runnable commands from Phase 6]

### Quick fixes
- Run `/blog translate <file> --to <missing-langs>` for [N] missing translations.
- Run `/blog multilingual` to regenerate hreflang assets.
- Run `/blog localize <file> --locale <code>` for weak cultural adaptations.

错误处理

场景操作
目录为空"在 [path] 中未找到博客文章"
仅有一种语言报告覆盖情况，并建议目标语言
没有 hreflang 文件标记为严重缺口，并提供重新生成选项
无法识别的文件格式跳过并发出警告

交叉引用

  • 填补缺失的翻译：/blog translate <file> --to <missing-codes>
  • 深化适配不足的译文：/blog localize <file> --locale <code>
  • 重新生成 hreflang 资源：/blog multilingual <topic> --languages <codes>

评论

支持 Markdown