Codex × 网页结构化数据 Skill

网页结构化数据 Skill不在 Codex 的前十推荐里——Codex更擅长本地文件、数据、代码和正式交付物，这个 Skill 的重心不完全在这里。它仍然可以正常安装使用，只是如果你要做的就是这件事，可以先看看下面几个更合适的 Agent。

用这个 Agent 跑网页结构化数据 Skill，「编写 JSON-LD 代码」和「输出验证测试建议」直接在产物区生成，写代码前会停下来让你确认，避免整批页面写错 Schema 字段。在「提取页面实体信息」和「串联全站实体图谱」这两个环节，它只有条件支持页面预览，你得自己导出页面纯文本喂给它。如果你的需求是跑几万个页面全自动生成标记，或者要求定时巡检收录情况，不要选它，它的确认流程会打断长流程，且没有定时器，得靠人记着触发。它最适合需要把网页改动交付上线、写错结构化数据代价高的海外营销团队。

「操作前确认与产物区」特性直接落在「编写 JSON-LD 代码」和「输出验证测试建议」环节。Agent 生成完代码不直接写入前端项目，而是在独立产物区逐份输出 JSON-LD 代码和网页类型对照表，等你审阅放行后再落盘。这省掉了 SEO 经理把生成结果复制到 Google 富媒体结果测试工具里排查报错再回滚的手工动作。判断标准很简单：如果即将上线的网页需要写对结构化数据标记，这个写前确认机制能帮你拦住字段错配问题，代价是批量处理时要预留确认时间。

1. 01

   编写 JSON-LD 代码

   基于提取的实体信息直接生成 JSON-LD 代码，但写入前端代码库前会触发操作前确认。你需要在产物区核对生成的代码内容是否包含具体字段，确认无误后放行写入。

2. 02

   筛选适用实体类别

   通过联网检索核对实体后，这个环节原生支持自动完成。Agent 会把适用的 Schema 类别和不适用类别连同排除的实际原因说明一起列在产物区，供你比对。

3. 03

   提取页面实体信息

   受限于本地页面预览限制，你需要把目标页面 URL 的前端代码结构或网页实际文本内容手动提取出来喂给它。Agent 读取这些资料后再执行后续的匹配。

把目标页面的前端代码结构、实际文本内容、期望的搜索展示样式和当前网站部署的实体信息存为 Markdown 或 CSV 文件，放到工作区目录下。在工作区里发任务时直接说「读取刚才放入的页面资料，生成对应的 JSON-LD 代码」。Agent 会先复述它的执行计划，你确认后它开始读取并编写代码。关键写入步骤前它会停下来等你确认。你在工作区底部的进度条或日志面板看它的执行状态。

装完技能目录后，先跑一个最小任务：给它一个包含产品价格和星级评价的页面文本，让它执行「编写 JSON-LD 代码」。检查它是否在产物区生成了包含具体字段和内容的 JSON-LD 代码，并且在写文件前停下来请求了你的确认。再让它执行「输出验证测试建议」，看它是否给出了 Google 富媒体结果测试工具的验证链接。如果你看到了确认提示和验证建议，说明技能在正常工作。