用途:为博客文章生成完整、可校验的 JSON-LD 结构化数据,使用 @graph 模式把多种 schema 类型合并到单个 script 标签,并通过稳定的 @id 引用实现实体关联。
主要能力:从文章提取标题、作者、日期、描述、FAQ、图片、组织信息、字数、标签与 slug;生成 BlogPosting(含 headline、datePublished、dateModified、author、publisher、image、mainEntityOfPage、wordCount、articleBody 等)、Person(作者,含 sameAs、可选 alumniOf、worksFor)、Organization(含 logo、sameAs)、BreadcrumbList(无分类时第二项用 Blog)、可选 FAQPage、VideoObject(YouTube 嵌入视频)与 ImageObject(封面图,建议 1200x630 或 1920x1080)。
使用方式:按步骤读取内容后逐类生成,最后合并为单个 script type="application/ld+json" 的 @graph 输出,可嵌入 HTML、独立 JSON 或 MDX 组件。安全要求:必须用真正的 JSON 编码器构建,禁止字符串拼接;嵌入 HTML 前转义 </ 为 </、< 为 \u003c,用户可控字段只能以 JSON 编码值进入。
校验:检查 @id 引用可解析、dateModified 不早于 datePublished、headline 简洁、description 不重复、URL 为绝对地址、图片尺寸为正整数、面包屑 position 从 1 连续;若输出 FAQPage 需存在可见问答。
限制:Google 已于 2026-05-07 停止所有站点的 FAQ 富媒体结果,FAQPage 不带来 SEO 或 AI 优化收益,仅在可见 FAQ 真正有益时输出,且不得用 QAPage 替代。HowTo、Dataset、Course、ClaimReview、SpecialAnnouncement、PracticeProblem 等类型不应为 Google 资格推荐。结构化数据并非 Google 生成式 AI 搜索的必需项,也不存在专门的 AI schema。Google 可处理渲染 DOM 中的 JSON-LD,但服务端渲染对非 Google 爬虫更通用。