企业官网建设流程全解析

claude-blog 结构化数据教程：/blog schema 一键生成 JSON-LD，5 步提升搜索引擎展示效果

【免费下载链接】claude-blogClaude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.项目地址: https://gitcode.com/gh_mirrors/cl/claude-blog

claude-blog是一款面向 Claude Code 的博客写作与 SEO 优化技能套件，其中内置的/blog schema命令可以为一篇博客自动生成完整、可校验的 JSON-LD 结构化数据（Schema Markup），帮助页面在 Google 搜索结果中呈现作者、面包屑、图片等富媒体信息。本教程面向新手，用 5 个简单步骤讲清楚：结构化数据是什么、如何用一条命令生成 JSON-LD、自动产出了哪些 Schema 类型，以及生成后如何校验、如何避坑。

什么是结构化数据？为什么博客需要 JSON-LD

结构化数据（Structured Data）是一段嵌在网页里的"机器可读说明书"，用最通用的JSON-LD格式告诉搜索引擎：这篇文章的标题、作者、发布时间、配图、所属组织分别是什么。

对新手来说，它的作用可以简单概括为三点：

• 让搜索结果更丰富：作者头像与名称、面包屑导航、图片等可以直接展示在结果卡片里，点击率更高。
• 帮助引擎理解实体关系：作者（Person）、组织（Organization）、文章（BlogPosting）之间用稳定的@id相互引用，形成清晰的"实体图谱"。
• 对 AI 引用更友好：准确、与可见内容一致的结构化实体，有助于 AI 系统在总结时正确归因。

💡 小提示：Google 对 Article 类结构化数据"没有强制必填字段"，但headline、author、publisher、datePublished、image等是最值得补齐的推荐项。

准备工作：安装 claude-blog 并确认命令

在使用/blog schema之前，先把 claude-blog 装到本地。它需要Python 3.11+环境。

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/cl/claude-blog

2. 运行安装脚本，把 30+ 个子技能与 5 个智能体安装到 Claude Code 的技能目录中（~/.claude/skills/、~/.claude/agents/）。

安装完成后，在 Claude Code 里直接输入/blog即可看到路由表；完整命令说明见 docs/COMMANDS.md，安装细节见 docs/INSTALLATION.md。

最快上手：/blog schema 一条命令生成 JSON-LD

/blog schema的用法非常直白——把文章路径作为参数传进去即可：

/blog schema <file> /blog schema content/blog/my-post.mdx

执行后，它会读取这篇博客，自动抽取标题、作者、日期、描述、FAQ、封面图、组织信息、词数、标签与 slug 等数据，然后生成一个可直接注入页面<head>（或</body>之前）的<script type="application/ld+json">代码块。整个过程无需手写任何 Schema，对新手最友好。

自动生成的 5 种 Schema 类型

根据文章内容，/blog schema会按需组合以下类型（规则见 docs/COMMANDS.md）：

如果文章内嵌了 YouTube 视频，它还会额外产出VideoObject；封面图会生成ImageObject，保证宽高与真实尺寸一致。

@graph 模式：一个脚本标签搞定全部

生成的 JSON-LD 采用@graph结构——所有实体放在一个@graph数组里、用一个<script>标签输出，而不是散落多个代码块。这样做的好处是 HTML 更干净、实体之间用@id相互引用（例如文章只写一行指向作者的@id，无需重复整个作者对象）、便于统一维护与校验。

{ "@context": "https://schema.org", "@graph": [ { "@type": "BlogPosting", "@id": "https://你的域名/blog/文章#article", "...": "..." }, { "@type": "Person", "@id": "https://你的域名/author/作者#person", "...": "..." }, { "@type": "Organization", "@id": "https://你的域名#organization", "...": "..." }, { "@type": "BreadcrumbList", "@id": "https://你的域名/blog/文章#breadcrumb", "...": "..." } ] }

生成结果可以按你的偏好保存进文章文件，或单独存为一个 schema 文件。

生成后如何验证：JSON-LD 校验清单

生成不等于完成，校验是保证展示效果的关键一步。/blog schema内置了校验与告警逻辑，你也可以用官方工具二次确认：

• 所有@id引用都能在 @graph 内解析（没有悬空引用）；
• dateModified不早于datePublished，且与 frontmatter 的lastUpdated一致；
• 所有 URL 都是绝对路径（以https://开头，不能用相对路径）；
• 图片宽高为正的整数，caption与 alt 文本保持一致；
• BreadcrumbList 的位置号从 1 开始连续递增。

常用校验工具：Schema.org Validator（校验结构合法性）与Google Rich Results Test（仅对符合资格的富结果类型做检查）。完整清单见 brain/wiki/schema/Schema Validation Workflow.md。

⚠️ 对 JavaScript 动态生成的 JSON-LD，请直接测试最终渲染出的 URL，而不是复制代码片段，确保它真实出现在渲染后的 DOM 中，且每个标注事实都与页面可见内容一致。

新手常见避坑：哪些类型别乱加

这是最容易"白费力气"的地方。Schema.org 里合法的类型，不等于 Google 搜索会给你富结果展示。按项目规范，以下类型不要默认添加：

• HowTo：目前没有对应的 Google 富结果体验，普通博客直接用 Article + 清晰的步骤小标题即可。
• FAQPage / QAPage：FAQ 富结果已对普通站点下线，仅在"页面真有可见 FAQ 且对读者有用"时才输出，不要为凑标记而硬造问答，更不要用 QAPage 替代编辑类 FAQ。
• ClaimReview、SpecialAnnouncement、Course Info 等：均已从 Google 搜索结果中退役，切勿再为"搜索资格"推荐。

更稳妥的做法是坚持"文章 + 作者 + 组织 + 面包屑"这个基础实体组合。详细的类型对照表见 skills/blog/references/schema-stack.md 与 brain/wiki/schema/Structured Data Deprecation Register.md。

另外，生成的 markup 若校验不通过，常见原因包括：缺少@context/@type、dateModified与lastUpdated不一致、图片 URL 返回 404、作者@type误写成Organization（应为Person）。排查细节见 docs/TROUBLESHOOTING.md。

小结与延伸阅读

用一句话回顾：/blog schema <file>→ 自动抽取内容 → 生成 @graph 结构的 JSON-LD → 用官方工具校验 → 按需补齐实体。配合/blog seo-check检查 Schema 是否存在且正确，就能形成完整的结构化数据闭环。

想深入了解，可以从这些文件入手：

• 核心技能定义：skills/blog-schema/SKILL.md
• 完整 Schema 属性参考与 @graph 示例：skills/blog/references/schema-stack.md
• 博客 Schema 组合与实体图谱：brain/wiki/schema/Blog Schema Stack.md
• 所有/blog命令速查：docs/COMMANDS.md

【免费下载链接】claude-blogClaude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.项目地址: https://gitcode.com/gh_mirrors/cl/claude-blog