用途
blog-schema 用于为博客文章生成完整且经过校验的 JSON-LD 结构化数据标记。它采用 @graph 模式,将多种 schema 类型组合进单个 script 标签,并使用稳定的 @id 引用进行实体关联。
主要能力
覆盖的 schema 类型
- BlogPosting:完整的文章标记,包含必需属性(@type、headline、datePublished、author、publisher、image)与推荐属性(description、dateModified、mainEntityOfPage、wordCount、articleBody 摘要)。
- Person:作者标记,使用稳定的 @id 以便交叉引用,可包含 jobTitle、url、sameAs,以及可选属性 alumniOf、worksFor。
- Organization:博客所属组织实体,包含 name、url、logo(ImageObject)、sameAs。
- BreadcrumbList:内容层级导航面包屑,包含 position 与 item;若无分类,第二个面包屑项使用 "Blog" 与 {siteUrl}/blog。
- FAQPage:从文章 FAQ 部分提取问答对,mainEntity 使用 Question 与 acceptedAnswer。
- ImageObject:文章封面图标记,包含 url、width、height、caption。
使用方式
工作流分为九个步骤:
- 读取内容:从博客文章中提取标题、作者、日期、描述、FAQ 问答、图片、组织信息、字数、标签/分类、slug 等所有与 schema 相关的数据。
- 生成 BlogPosting schema。
- 生成 Person schema。
- 生成 Organization schema。
- 生成 BreadcrumbList。
- 生成 FAQPage schema。
- 生成 ImageObject。
- 校验与警告:检查已弃用类型并应用校验规则。
- 输出:使用 @graph 模式将所有 schema 合并到单个 script 标签。
输出形式可选:内嵌 HTML(可直接粘贴到 head 或 body 结束前)、独立 JSON(用于 CMS schema 字段或 API 注入)、MDX 组件(若项目使用 MDX)。生成结果可保存到博客文章文件或单独的 schema 文件。
校验规则
步骤 8 会检查弃用的 schema 类型,明确不应使用:HowTo(2023 年 9 月弃用)、SpecialAnnouncement(2025 年 7 月弃用)、Practice Problem、Dataset(通用用途弃用)、Sitelinks Search Box、Q&A(2026 年 1 月弃用,与 FAQPage 不同)。
校验检查项包括:所有 @id 引用都能在 @graph 内解析到实体;dateModified 等于或晚于 datePublished;headline 不超过 110 字符;description 在 50–160 字符之间;所有 URL 为绝对地址;图片尺寸为正整数;BreadcrumbList 的 position 从 1 开始连续;FAQPage 至少有 2 个问题。
适用场景
用于博客文章的搜索引擎结构化数据与 AI 提取优化。资料提到,使用 3 种或以上 schema 类型的页面,AI 引用可能性约高 13%;该技能默认生成 6 种类型。FAQ schema 自 2023 年 8 月起被 Google 限制为仅政府与健康类网站可显示富结果,但资料指出其仍有价值:AI 系统会提取 FAQ 数据用于引用,可结构化内容以备未来富结果资格变化,并改善内容组织信号。
限制与要求
图片 URL 必须可抓取且公开可访问;width 与 height 应反映实际图片尺寸;caption 应与图片 alt 文本一致或高度接近;首选尺寸为 1200x630(兼容 OG)或 1920x1080。Logo 必须是有效图片 URL,Google 建议最小 112x112px、最大宽度 600px,BlogPosting 发布者建议使用矩形 logo。headline 上限 110 字符,description 建议 150–160 字符。
暂未提供
资料未提供该工具的安装命令、收费方式、价格、平台支持范围与实际效果数据。