SuperAPI AI 工具集

structured-data

营销与增长

查看项目

更新于 10-16 02:20

技能介绍

用途

本技能是一份 Schema.org 结构化数据参考,用于帮助用户编写正确的 JSON-LD 标记、为页面选择合适的 schema 类型、验证结构化数据,并在不同平台上实现。结构化数据是机器可读的标记,用于向搜索引擎、语音助手和 AI 系统明确说明页面内容的含义,通过 Schema.org 词汇表显式声明。

主要能力

  • 提供各类主流 schema 类型的 JSON-LD 示例,包括 Organization、LocalBusiness、Product、FAQPage、HowTo、Article/BlogPosting、BreadcrumbList、Review/AggregateRating、Event、VideoObject、SoftwareApplication、Course、JobPosting。
  • 说明每种类型的必填属性、推荐属性以及可获得的富媒体结果(如星级评分、价格、FAQ 折叠、步骤说明、活动列表、知识面板等)。
  • 提供测试与验证指南、schema 最佳实践、富媒体结果资格表。
  • 在可用时使用 Search Console MCP 工具:通过 tool_get_search_analytics(按搜索外观筛选)检查哪些页面有富媒体结果;通过 tool_inspect_url 检查特定 URL 的结构化数据问题;通过 tool_list_properties 列出属性以确定要审计的站点。

使用方式

通过命令调用,可传入参数聚焦特定 schema 类型或主题:

  • /structured-data:完整参考概览
  • /structured-data Product:显示 Product schema 示例
  • /structured-data FAQPage:显示 FAQPage 示例
  • /structured-data LocalBusiness:显示 LocalBusiness 示例
  • /structured-data validate:测试与验证指南
  • /structured-data best-practices:Schema 最佳实践
  • /structured-data rich-results:富媒体结果资格表

当用户提供具体 schema 类型或主题作为参数时,聚焦该领域;否则提供概览并帮助确定所需的 schema 类型。

格式说明

存在三种格式,Google 明确推荐 JSON-LD:

  • JSON-LD(推荐):与 HTML 解耦,可由 JS 框架注入,易于验证,无布局风险。
  • Microdata:内联 HTML 属性(itemscope、itemtype、itemprop),仅用于无法添加 script 标签的遗留系统。
  • RDFa:内联属性(vocab、typeof、property),在 Web 上较少见,更常见于 XML/SVG 场景。

所有新实现建议使用 JSON-LD。

适用场景

  • 为电商产品页添加价格、库存、评分等富媒体结果。
  • 为 FAQ 页面添加可展开的问答折叠。
  • 为教程内容添加带图片的分步说明。
  • 为文章、博客、新闻添加作者与日期信息。
  • 为本地商家添加地图、营业时间、电话等知识面板信息。
  • 为活动、视频、软件应用、课程、招聘信息添加对应富媒体结果。
  • 验证与排查结构化数据问题,审计站点富媒体结果覆盖情况。

限制

  • 结构化数据不直接影响排名,但可通过富媒体结果提升点击率,间接影响表现。
  • 评论必须嵌套在被评论的项目内,独立的 Review 标记不会生成富媒体结果。
  • FAQ 折叠最多显示 10 个问题。
  • 各 schema 类型的必填与推荐属性需遵循文档说明,缺失必填属性将无法获得对应富媒体结果。
  • 完整文档见 https://cogny.com/docs/structured-data-reference。