结构化数据Skill：先定类型再写JSON-LD

网页结构化数据 Skill 适合在你已经写好页面正文之后调用：它根据页面真实出现的实体，生成一段可嵌入的 JSON-LD，用来申请 Google 仍支持的富结果，并给机器一份可核对的实体说明。它不负责替你发明价格、评分或发布日期，也不保证页面因此进入 AI Overviews。2026年9月7日核验的 VibeMKT Hub 产品页把它归在 SEO 与 GEO 系列，当前托管版本为 v1.0.0，固定版本号 70987bad4ebe，许可证 MIT，由加搜科技镜像托管；上游项目名是 schema-markup。站内《GEO内容结构怎么设计》讲正文怎么写得可被抽取，本文只判断这个 Skill 何时该用、输入什么、输出怎样算合格。

30 秒结论：谁该用，谁不该用

适合：产品页要补价格和库存、文章页要补作者与日期、招聘页要补职位字段、全站需要统一的 Organization 与 WebSite 实体。不适合：页面正文还没写完，指望代码“补出”事实；把 HowTo 标记当成教程页的流量开关；或者把“加了 schema 就会被 ChatGPT / Perplexity 引用”写成验收标准。后一件事和 Google Search Central 在 2026 年公开的生成式搜索指南冲突——该指南写明，生成式功能不要求专门的 structured data。

在 Vibe Marketing 里，这个 Skill 落在内容资产的“生成与执行”阶段：人先定页面主体和可见事实，Skill 生成标记，人再用 Google 富媒体结果测试工具核对，最后由前端或发布流程写入页面。人的判断点是类型有没有选对、字段是否和肉眼可见内容一致。

身份与触发

触发它的任务应接近“给这个 URL 生成与可见内容一致的 JSON-LD”，而不是“帮我做 SEO”或“帮我做 GEO”。后两类任务会把调研、正文、内链和监测混进来，超出这个执行单元。

先定类型，再让它写代码

Schema.org 的词汇远多于搜索引擎会拿去画富结果的那一份。Skill 产品页自己的流程也是先匹配网页类型、再对照 Google 支持列表、再排除已停用类型。写作当天仍应按这个顺序，不要先生成一段“看起来很全”的代码。

HowTo 要单独记一笔。Google 在 2023 年 9 月宣布桌面端也不再展示 How-to 富结果，该外观类型随后被废弃；Search Engine Journal 当时引用了 Search Central 公告。2026年9月7日仍把“Google 教程富结果已停用”当作已确认事实。Schema.org 的 HowTo 类型本身还在，但用它换 Google 可视化富结果已经不成立。第三方文章常说 AI 搜索仍会读 HowTo，这属于未经验证的推断，不能写成验收承诺。

输入、输出与一次完整调用

输入至少五样：目标 URL、当前页面可见正文或前端源码、你希望申请的展示样式（例如产品信息、文章信息，而不是“越多越好”）、全站官方名称与社交主页、多语言页的语言/地区标签。缺价格却要求 Product，Skill 只能空着或编造——编造必须退回。

输出契约按产品页 2026-09-07 的说明来验收：一段可嵌入的 JSON-LD；一张页面类型与实体类别对照表；一份“为何排除某类型”的说明；指向 Google 富媒体结果测试工具的验证入口；以及面包屑文字是否与页面可见导航一致。少任何一项，都只算半成品。

用产品页给出的 SaaS 产品页场景改写成可检查的调用。输入：页面是海外 AI 写作工具的定价可见产品页，要申请 SoftwareApplication，并希望组织实体能和官网、社交主页连上。不允许假设月活、评分和“被 ChatGPT 引用”。预期输出特征：代码里出现工具名、可见价格字段、Organization 的 @id 关联；对照表写明为何不用 HowTo 和 JobPosting；验证清单里把货币和价格标成人工确认项。如果你拿到的是一段没有对照表、也没有排除说明的代码，就按失败处理，不要直接上线。

安装入口与权限

产品页默认做法是把安装提示词交给当前 Agent，让它下载完整 ZIP，而不是保存 HTML。OpenClaw 的目录规则在产品页写为 openclaw skills install ./skill-schema --as schema_skill；Hermes 为把解压目录复制进 ~/.hermes/skills。具体路径以你所用 Agent 当天文档为准。装完先做只读小任务：给一个已发布 URL，要求只输出类型建议和对照表，不改站点文件。

这个 Skill 会读页面源码、可能联网打开 URL，并产出要写入站点的代码。写入 head 或模板属于外部变更，必须人工批准。不要把密钥、未上线后台地址或含顾客数据的内页源码直接喂给它。

和 AI 引用的边界

产品页和上游文档会提到结构化数据有助于 AI 引用。Google Search Central《Optimizing your website for generative AI features on Google Search》在写作当天的表述是：生成式功能建立在核心搜索系统上，不要求 llms.txt 或特殊 markup，也不把 structured data 当成生成式搜索的前提；structured data 仍可用于传统富结果。两套口径同时成立的写法是：用这个 Skill 把富结果和实体一致性做好；AI Overviews 的可见度另用可索引、有信息增量的正文和 Search Console 的生成式效果报告衡量。站内《AI Overviews怎么优化》走后一条，不要和这篇抢同一验收表。

风险、失败信号和下一步

失败信号包括：测试工具报可见内容与标记不一致；日期在页面上写了两个、代码里又写了第三套；HowTo 仍被当成“必做项”；组织实体只出现在关于我们页。替代方案是对照 Google 搜索图库当天支持列表手写最小 JSON-LD，或先改正文再补标记。权限过大时，只让 Skill 输出代码草案，由发布流程合并。

如果你还没确认页面主体，先把正文写清楚再回来调用。已经装好、但不知道标题怎么写进 SERP 的，用站内搜索标题提示词，而不是继续往 schema 里加字段。