seo-schema

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Schema Markup Analysis & Generation

Schema标记分析与生成

Detection

检测

  1. Scan page source for JSON-LD
    <script type="application/ld+json">
  2. Check for Microdata (
    itemscope
    ,
    itemprop
    )
  3. Check for RDFa (
    typeof
    ,
    property
    )
  4. Always recommend JSON-LD as primary format (Google's stated preference)
  1. 扫描页面源代码,查找JSON-LD格式的
    <script type="application/ld+json">
    标签
  2. 检查是否存在Microdata(
    itemscope
    itemprop
    属性)
  3. 检查是否存在RDFa(
    typeof
    property
    属性)
  4. 始终推荐将JSON-LD作为首选格式(这是谷歌明确表示的偏好)

Validation

验证

  • Check required properties per schema type
  • Validate against Google's supported rich result types
  • Test for common errors:
    • Missing @context
    • Invalid @type
    • Wrong data types
    • Placeholder text
    • Relative URLs (should be absolute)
    • Invalid date formats
  • Flag deprecated types (see below)
  • 根据Schema类型检查必填属性
  • 针对谷歌支持的富媒体结果类型进行验证
  • 检测常见错误:
    • 缺少@context
    • 无效的@type
    • 错误的数据类型
    • 占位符文本
    • 相对URL(应使用绝对URL)
    • 无效的日期格式
  • 标记已弃用的类型(详见下文)

Schema Type Status (as of Feb 2026)

Schema类型状态(截至2026年2月)

Read
references/schema-types.md
for the full list. Key rules:
完整列表请查看
references/schema-types.md
。核心规则:

ACTIVE — recommend freely:

活跃类型——可自由推荐:

Organization, LocalBusiness, SoftwareApplication, WebApplication, Product (with Certification markup as of April 2025), ProductGroup, Offer, Service, Article, BlogPosting, NewsArticle, Review, AggregateRating, BreadcrumbList, WebSite, WebPage, Person, ProfilePage, ContactPage, VideoObject, ImageObject, Event, JobPosting, Course, DiscussionForumPosting
Organization、LocalBusiness、SoftwareApplication、WebApplication、Product(2025年4月起支持认证标记)、ProductGroup、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting

VIDEO & SPECIALIZED — recommend freely:

视频与专业类型——可自由推荐:

BroadcastEvent, Clip, SeekToAction, SoftwareSourceCode
See
schema/templates.json
for ready-to-use JSON-LD templates for these types.
JSON-LD and JavaScript rendering: Per Google's December 2025 JS SEO guidance, structured data injected via JavaScript may face delayed processing. For time-sensitive markup (especially Product, Offer), include JSON-LD in the initial server-rendered HTML.
BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode
可在
schema/templates.json
中获取这些类型的即用型JSON-LD模板。
JSON-LD与JavaScript渲染: 根据谷歌2025年12月发布的JS SEO指南,通过JavaScript注入的结构化数据可能会面临延迟处理的问题。对于时间敏感的标记(尤其是Product、Offer类型),建议将JSON-LD包含在初始服务器渲染的HTML中。

RESTRICTED — only for specific sites:

受限类型——仅适用于特定站点:

  • FAQ: ONLY for government and healthcare authority sites (restricted Aug 2023)
  • FAQ:仅适用于政府和医疗权威机构站点(2023年8月起受限)

DEPRECATED — never recommend:

已弃用类型——绝不推荐:

  • HowTo: Rich results removed September 2023
  • SpecialAnnouncement: Deprecated July 31, 2025
  • CourseInfo, EstimatedSalary, LearningVideo: Retired June 2025
  • ClaimReview: Retired from rich results June 2025
  • VehicleListing: Retired from rich results June 2025
  • Practice Problem: Retired from rich results late 2025
  • Dataset: Retired from rich results late 2025
  • Book Actions: Deprecated then reversed — still functional as of Feb 2026 (historical note)
  • HowTo:富媒体结果于2023年9月移除
  • SpecialAnnouncement:2025年7月31日弃用
  • CourseInfo、EstimatedSalary、LearningVideo:2025年6月停用
  • ClaimReview:2025年6月从富媒体结果中移除
  • VehicleListing:2025年6月从富媒体结果中移除
  • Practice Problem:2025年末从富媒体结果中移除
  • Dataset:2025年末从富媒体结果中移除
  • Book Actions:先弃用后恢复——截至2026年2月仍可正常使用(历史说明)

Generation

生成

When generating schema for a page:
  1. Identify page type from content analysis
  2. Select appropriate schema type(s)
  3. Generate valid JSON-LD with all required + recommended properties
  4. Include only truthful, verifiable data — use placeholders clearly marked for user to fill
  5. Validate output before presenting
为页面生成Schema标记时:
  1. 通过内容分析确定页面类型
  2. 选择合适的Schema类型
  3. 生成包含所有必填及推荐属性的有效JSON-LD代码
  4. 仅包含真实、可验证的数据——使用明确标记的占位符供用户填写
  5. 在呈现前验证输出内容

Common Schema Templates

常用Schema模板

Organization

组织

json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}
json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}

LocalBusiness

本地商家

json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Business Name]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State]",
    "postalCode": "[ZIP]",
    "addressCountry": "US"
  },
  "telephone": "[Phone]",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "[Lat]",
    "longitude": "[Long]"
  }
}
json
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Business Name]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State]",
    "postalCode": "[ZIP]",
    "addressCountry": "US"
  },
  "telephone": "[Phone]",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "[Lat]",
    "longitude": "[Long]"
  }
}

Article/BlogPosting

文章/博客文章

json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Title]",
  "author": {
    "@type": "Person",
    "name": "[Author Name]"
  },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[Image URL]",
  "publisher": {
    "@type": "Organization",
    "name": "[Publisher]",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}
json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Title]",
  "author": {
    "@type": "Person",
    "name": "[Author Name]"
  },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[Image URL]",
  "publisher": {
    "@type": "Organization",
    "name": "[Publisher]",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}

Output

输出

  • SCHEMA-REPORT.md
    — detection and validation results
  • generated-schema.json
    — ready-to-use JSON-LD snippets
  • SCHEMA-REPORT.md
    —— 检测与验证结果
  • generated-schema.json
    —— 可直接使用的JSON-LD代码片段

Validation Results

验证结果

SchemaTypeStatusIssues
......✅/⚠️/❌...
Schema类型状态问题
......✅/⚠️/❌...

Recommendations

建议

  • Missing schema opportunities
  • Validation fixes needed
  • Generated code for implementation
  • 缺失的Schema应用机会
  • 需要修复的验证问题
  • 供实施使用的生成代码