GEO
GEO Docs

结构化数据

用 JSON-LD 模板让搜索引擎与 AI 助手理解页面;支持的类型、变量与校验。

GEO 把结构化数据视为 GEO(生成式引擎优化)的起点:AI 助手引用页面时,清晰的 @type、作者、日期与组织信息会显著提高被正确引用的概率。

支持的类型

Article、NewsArticle、BlogPosting、Organization、WebSite、FAQPage、BreadcrumbList、Product、VideoObject、LocalBusiness、Event、HowTo。

模板示例

在 站点管理 → 结构化数据 新建模板,路径模式 /blog/:slug:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "{title | truncate:110}",
  "description": "{summary}",
  "image": "{cover}",
  "author": { "@type": "Person", "name": "{author}" },
  "publisher": { "@type": "Organization", "name": "{brand}", "logo": { "@type": "ImageObject", "url": "{logo}" } },
  "datePublished": "{publishedAt}",
  "inLanguage": "{locale}",
  "mainEntityOfPage": "{canonical}"
}

输出

SDK 以 @graph 合并同一路径命中的多个模板,输出一个 <script type="application/ld+json">:

<script type="application/ld+json">
{"@context":"https://schema.org","@graph":[{"@type":"Article",…},{"@type":"BreadcrumbList",…}]}
</script>

校验

编辑器实时校验 JSON 语法与必填属性;保存后可点击 校验 调用 POST /sites/{siteId}/structured-data/{id}/validate,报告缺失属性与类型错误。SEO 审计也会抓取页面检查实际输出。

语言覆盖

每个模板可以按语言覆盖部分字段(例如 publisher.name 的本地化名称),未覆盖的字段沿用默认模板。