AEM 页面 JSON-LD 结构化数据生成

要解决什么问题

AEM Edge Delivery Services（EDS）站点的正文内容托管在 Google Docs 或 Word 文档里，作者无法在源文档中直接写结构化数据。JSON-LD 只能落到项目代码里，而且有两种路径：放在仓库根目录的 head.html（适合全站通用的 Organization、WebSite+SearchAction 这类 schema），或在 scripts.js 中运行时注入（适合按页面元数据驱动的 article、FAQ、product 等 schema）。实际开发中常见的坑是：schema 类型选得不具体、必填属性漏掉、值用占位符硬凑、图片路径没有落在 EDS 的 /media/ 目录下，最终导致富媒体搜索结果出不来。

这个技能如何工作

技能围绕一条可勾选的工作流推进：

1. 抓取页面：同时取完整 HTML 和 .plain.html（根路径用 /index.plain.html），前者看 <head> 元数据，后者看干净正文，据此判断页面内容类型。
2. 选 schema 并生成：选择可用的最具体的 schema.org 类型，URL 层级清晰时补一个 BreadcrumbList；每种类型输出为独立的 JSON-LD 块。所有属性值只从真实页面内容中提取——没有数据就省略该属性，绝不用占位文本。
3. 校验：检查必填属性是否符合 Google 富媒体结果要求、URL 是否为绝对地址、图片路径是否在站点上真实存在、headline 是否与 H1 一致、description 是否与 meta description 一致，发现问题直接纠正。
4. 给出落地方式：全站级 schema 直接写入 head.html；页面级 schema 通过 scripts.js 运行时注入，依据是源文档底部元数据表里的自定义字段（如 schema-type、author、publication-date）。最终交付可直接复制的 JSON-LD 代码块，并说明应往元数据表里补哪些字段；若页面已有结构化数据，会说明是替换还是补充。

适用边界

• 仅适用于 EDS 架构站点，实现指引与 EDS 的代码路径强绑定，非 EDS 项目不要照搬。
• 不做结构化数据校验服务——部署后仍需用 Google Rich Results Test 复核。
• 不修改页面内容，只基于既有内容生成 JSON-LD。
• 只抓取用户提供的 URL（含派生的 .plain.html），抓取失败会报告并继续，所有外部内容按不可信输入处理。