schema-markup-generator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Schema Markup Generator

Schema标记生成器

This skill creates Schema.org structured data markup in JSON-LD format to help search engines understand your content and enable rich results in SERPs.
本工具可创建Schema.org标准的JSON-LD格式结构化数据标记,帮助搜索引擎理解您的内容,从而在搜索结果页(SERPs)中展示富结果。

When This Must Trigger

触发场景

Use this when the conversation involves any of these situations — even if the user does not use SEO terminology:
Use this whenever the task needs a shippable asset or transformation that should feed directly into quality review, deployment, or monitoring.
  • Adding FAQ schema for expanded SERP presence
  • Creating How-To schema for step-by-step content
  • Adding Product schema for e-commerce pages
  • Implementing Article schema for blog posts
  • Adding Local Business schema for location pages
  • Creating Review/Rating schema
  • Implementing Organization schema for brand presence
  • Any page where rich results would improve visibility
当对话涉及以下任一情况时使用本工具——即使用户未使用SEO术语:
当任务需要可直接用于质量审核、部署或监控的可交付资产或转换内容时,使用本工具。
  • 添加FAQ schema以扩大搜索结果页展示范围
  • 为分步内容创建How-To schema
  • 为电商页面添加Product schema
  • 为博客文章实现Article schema
  • 为本地商家页面添加LocalBusiness schema
  • 创建Review/Rating schema
  • 为品牌展示实现Organization schema
  • 任何可通过富结果提升可见性的页面

What This Skill Does

工具功能

  1. Schema Type Selection: Recommends appropriate schema types
  2. JSON-LD Generation: Creates valid structured data markup
  3. Property Mapping: Maps your content to schema properties
  4. Validation Guidance: Ensures schema meets requirements
  5. Nested Schema: Handles complex, multi-type schemas
  6. Rich Result Eligibility: Identifies which rich results you can target
  1. Schema类型选择:推荐合适的schema类型
  2. JSON-LD生成:创建有效的结构化数据标记
  3. 属性映射:将您的内容映射到schema属性
  4. 验证指导:确保schema符合要求
  5. 嵌套Schema:处理复杂的多类型schema
  6. 富结果适配性:识别可适配的富结果类型

Quick Start

快速开始

Start with one of these prompts.
使用以下任一指令启动。

Generate Schema for Content

为内容生成Schema

Generate schema markup for this [content type]: [content/URL]
Create FAQ schema for these questions and answers: [Q&A list]
Generate schema markup for this [content type]: [content/URL]
Create FAQ schema for these questions and answers: [Q&A list]

Specific Schema Types

指定Schema类型

Create Product schema for [product name] with [details]
Generate LocalBusiness schema for [business name and details]
Create Product schema for [product name] with [details]
Generate LocalBusiness schema for [business name and details]

Audit Existing Schema

审核现有Schema

Review and improve this schema markup: [existing schema]
Review and improve this schema markup: [existing schema]

Data Sources

数据来源

With ~~web crawler connected: Automatically crawl and extract page content (visible text, headings, lists, tables), existing schema markup, page metadata, and structured content elements that map to schema properties.
With manual data only: Ask the user to provide:
  1. Page URL or full HTML content
  2. Page type (article, product, FAQ, how-to, local business, etc.)
  3. Specific data needed for schema (prices, dates, author info, Q&A pairs, etc.)
  4. Current schema markup (if optimizing existing)
Proceed with the full workflow using provided data. Note in the output which data is from automated extraction vs. user-provided data.
连接~~web crawler后: 自动抓取并提取页面内容(可见文本、标题、列表、表格)、现有schema标记、页面元数据及可映射到schema属性的结构化内容元素。
仅手动提供数据时: 请用户提供:
  1. 页面URL或完整HTML内容
  2. 页面类型(文章、产品、FAQ、指南、本地商家等)
  3. schema所需的特定数据(价格、日期、作者信息、问答对等)
  4. 当前schema标记(如需优化现有内容)
使用提供的数据完成完整流程。在输出中注明各数据点的来源是自动提取还是用户提供。

Instructions

操作步骤

When a user requests schema markup:
  1. Identify Content Type and Rich Result Opportunity
    Reference the CORE-EEAT Benchmark item O05 (Schema Markup) for content-type to schema mapping:
    markdown
    ### CORE-EEAT Schema Mapping (O05)
    
    | Content Type | Required Schema | Conditional Schema |
    |-------------|----------------|--------------------|
    | Blog (guides) | Article, Breadcrumb | FAQ, HowTo |
    | Blog (tools) | Article, Breadcrumb | FAQ, Review |
    | Blog (insights) | Article, Breadcrumb | FAQ |
    | Alternative | Comparison*, Breadcrumb, FAQ | AggregateRating |
    | Best-of | ItemList, Breadcrumb, FAQ | AggregateRating per tool |
    | Use-case | WebPage, Breadcrumb, FAQ ||
    | FAQ | FAQPage, Breadcrumb ||
    | Landing | SoftwareApplication, Breadcrumb, FAQ | WebPage |
    | Testimonial | Review, Breadcrumb | FAQ, Person |
    
    *Use the mapping above to ensure schema type matches content type (CORE-EEAT O05: Pass criteria).*
    markdown
    ### Schema Analysis
    
    **Content Type**: [blog/product/FAQ/how-to/local business/etc.]
    **Page URL**: [URL]
    
    **Eligible Rich Results**:
    
    | Rich Result Type | Eligibility | Impact |
    |------------------|-------------|--------|
    | FAQ | ✅/❌ | High - Expands SERP presence |
    | How-To | ✅/❌ | Medium - Shows steps in SERP |
    | Product | ✅/❌ | High - Shows price, availability |
    | Review | ✅/❌ | High - Shows star ratings |
    | Article | ✅/❌ | Medium - Shows publish date, author |
    | Breadcrumb | ✅/❌ | Medium - Shows navigation path |
    | Video | ✅/❌ | High - Shows video thumbnail |
    
    **Recommended Schema Types**:
    1. [Primary schema type] - [reason]
    2. [Secondary schema type] - [reason]
  2. Generate Schema Markup
    Based on the identified content type, generate the appropriate JSON-LD schema. Supported types: FAQPage, HowTo, Article/BlogPosting/NewsArticle, Product, LocalBusiness, Organization, BreadcrumbList, Event, Recipe, and combined multi-type schemas.
    Reference: See references/schema-templates.md for complete, copy-ready JSON-LD templates for all schema types with required and optional properties.
    For each schema generated, include:
    • All required properties for the chosen type
    • Rich result preview showing expected SERP appearance
    • Notes on which properties are required vs. optional
    When combining multiple schema types on one page, wrap them in a JSON array inside a single
    <script type="application/ld+json">
    tag.
  3. Provide Implementation and Validation
    markdown
    ## Implementation Guide
    
    ### Adding Schema to Your Page
    
    **Option 1: In HTML <head>**
    ```html
    <head>
      <script type="application/ld+json">
        [Your JSON-LD schema here]
      </script>
    </head>
    Option 2: Before closing </body>
    html
      <script type="application/ld+json">
        [Your JSON-LD schema here]
      </script>
    </body>

    Validation Steps

    1. ~~schema validator
      • Test your live URL or paste code
      • Check for errors and warnings
    2. Schema.org Validator
    3. ~~search console
      • Monitor rich results in ~~search console
      • Check Enhancements reports for issues

    Validation Checklist

    • JSON syntax is valid (no trailing commas)
    • All required properties present
    • URLs are absolute, not relative
    • Dates are in ISO 8601 format
    • Content matches visible page content
    • No policy violations
    undefined
当用户请求schema标记时:
  1. 识别内容类型与富结果机会
    参考CORE-EEAT基准项**O05 (Schema Markup)**进行内容类型到schema的映射:
    markdown
    ### CORE-EEAT Schema映射(O05)
    
    | 内容类型 | 必填Schema | 可选Schema |
    |-------------|----------------|--------------------|
    | 博客(指南类) | Article, Breadcrumb | FAQ, HowTo |
    | 博客(工具类) | Article, Breadcrumb | FAQ, Review |
    | 博客(洞察类) | Article, Breadcrumb | FAQ |
    | 对比类 | Comparison*, Breadcrumb, FAQ | AggregateRating |
    | 最佳推荐类 | ItemList, Breadcrumb, FAQ | 每个工具对应AggregateRating |
    | 用例类 | WebPage, Breadcrumb, FAQ ||
    | FAQ类 | FAQPage, Breadcrumb ||
    | 落地页 | SoftwareApplication, Breadcrumb, FAQ | WebPage |
    | 推荐证言类 | Review, Breadcrumb | FAQ, Person |
    
    *使用上述映射确保schema类型与内容类型匹配(CORE-EEAT O05:通过标准)。*
    markdown
    ### Schema分析
    
    **内容类型**:[博客/产品/FAQ/指南/本地商家等]
    **页面URL**:[URL]
    
    **适配的富结果**
    | 富结果类型 | 适配性 | 影响 |
    |------------------|-------------|--------|
    | FAQ | ✅/❌ | 高 - 扩大搜索结果页展示范围 |
    | How-To | ✅/❌ | 中 - 在搜索结果页展示步骤 |
    | Product | ✅/❌ | 高 - 展示价格、库存状态 |
    | Review | ✅/❌ | 高 - 展示星级评分 |
    | Article | ✅/❌ | 中 - 展示发布日期、作者 |
    | Breadcrumb | ✅/❌ | 中 - 展示导航路径 |
    | Video | ✅/❌ | 高 - 展示视频缩略图 |
    
    **推荐Schema类型**1. [主schema类型] - [理由]
    2. [次schema类型] - [理由]
  2. 生成Schema标记
    根据识别的内容类型,生成对应的JSON-LD schema。支持类型包括:FAQPage、HowTo、Article/BlogPosting/NewsArticle、Product、LocalBusiness、Organization、BreadcrumbList、Event、Recipe及组合多类型schema。
    参考:查看references/schema-templates.md获取所有schema类型的完整可复制JSON-LD模板,包含必填和可选属性。
    生成的每个schema需包含:
    • 所选类型的所有必填属性
    • 富结果预览,展示预期的搜索结果页外观
    • 注明哪些属性是必填,哪些是可选
    当在单个页面组合多个schema类型时,将其包裹在单个
    <script type="application/ld+json">
    标签内的JSON数组中。
  3. 提供实施与验证指导
    markdown
    ## 实施指南
    
    ### 为页面添加Schema
    
    **选项1:添加到HTML <head>中**
    ```html
    <head>
      <script type="application/ld+json">
        [Your JSON-LD schema here]
      </script>
    </head>
    选项2:添加到</body>闭合标签前
    html
      <script type="application/ld+json">
        [Your JSON-LD schema here]
      </script>
    </body>

    验证步骤

    1. ~~schema validator
      • 测试您的在线URL或粘贴代码
      • 检查错误与警告
    2. Schema.org Validator
    3. ~~search console
      • 在~~search console中监控富结果
      • 查看增强功能报告排查问题

    验证清单

    • JSON语法有效(无尾随逗号)
    • 所有必填属性已包含
    • URL为绝对路径,而非相对路径
    • 日期采用ISO 8601格式
    • 内容与页面可见内容一致
    • 无政策违规
    undefined

Validation Checkpoints

验证检查点

Input Validation

输入验证

  • Page URL or content provided
  • Schema type appropriate for content (Article for blog, Product for e-commerce, etc.)
  • All required data available (author, dates, prices, etc. depending on schema type)
  • Content eligibility for rich results confirmed
  • 已提供页面URL或内容
  • Schema类型与内容匹配(博客用Article,电商用Product等)
  • 所有必要数据可用(根据schema类型,如作者、日期、价格等)
  • 已确认内容适配富结果

Output Validation

输出验证

  • JSON syntax validates (no trailing commas, proper quotes)
  • All required properties present for chosen schema type
  • URLs are absolute, not relative
  • Dates in ISO 8601 format (YYYY-MM-DDTHH:MM:SS+00:00)
  • Schema content matches visible page content exactly
  • Passes ~~schema validator with no errors
  • Source of each data point clearly stated (~~web crawler extraction, user-provided, or manual entry)
  • JSON语法验证通过(无尾随逗号、引号格式正确)
  • 所选schema类型的所有必填属性已包含
  • URL为绝对路径,而非相对路径
  • 日期采用ISO 8601格式(YYYY-MM-DDTHH:MM:SS+00:00)
  • Schema内容与页面可见内容完全一致
  • 通过~~schema validator验证且无错误
  • 每个数据点的来源已明确说明(~~web crawler提取、用户提供或手动输入)

Example

示例

User: "Generate FAQ schema for a page about SEO with 3 questions"
Output:
markdown
undefined
用户:"Generate FAQ schema for a page about SEO with 3 questions"
输出
markdown
undefined

FAQ Schema for SEO Page

FAQ Schema for SEO Page

Schema Markup

Schema Markup

json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is SEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO (Search Engine Optimization) is the practice of optimizing websites and content to rank higher in search engine results pages (SERPs). It involves technical optimizations, content creation, and link building to increase organic visibility and drive qualified traffic to your website."
      }
    },
    {
      "@type": "Question",
      "name": "How long does SEO take to work?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO typically takes 3-6 months to show significant results, though this varies based on competition, domain authority, and effort invested. New websites may take 6-12 months, while established sites with existing authority can see improvements in 1-3 months for less competitive keywords."
      }
    },
    {
      "@type": "Question",
      "name": "Is SEO better than paid advertising?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO and paid advertising serve different purposes. SEO provides sustainable, long-term traffic without per-click costs but takes time to build. Paid advertising delivers immediate results but stops when you stop paying. Most successful businesses use both: paid ads for immediate leads and SEO for long-term growth."
      }
    }
  ]
}
Implementation: Wrap the above JSON-LD in
<script type="application/ld+json">...</script>
and place in
<head>
or before
</body>
. Test with ~~schema validator.
json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is SEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO (Search Engine Optimization) is the practice of optimizing websites and content to rank higher in search engine results pages (SERPs). It involves technical optimizations, content creation, and link building to increase organic visibility and drive qualified traffic to your website."
      }
    },
    {
      "@type": "Question",
      "name": "How long does SEO take to work?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO typically takes 3-6 months to show significant results, though this varies based on competition, domain authority, and effort invested. New websites may take 6-12 months, while established sites with existing authority can see improvements in 1-3 months for less competitive keywords."
      }
    },
    {
      "@type": "Question",
      "name": "Is SEO better than paid advertising?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO and paid advertising serve different purposes. SEO provides sustainable, long-term traffic without per-click costs but takes time to build. Paid advertising delivers immediate results but stops when you stop paying. Most successful businesses use both: paid ads for immediate leads and SEO for long-term growth."
      }
    }
  ]
}
Implementation: Wrap the above JSON-LD in
<script type="application/ld+json">...</script>
and place in
<head>
or before
</body>
. Test with ~~schema validator.

SERP Preview

SERP Preview

SEO Guide: Complete Beginner's Tutorial
yoursite.com/seo-guide/
Learn SEO from scratch with our comprehensive guide...

▼ What is SEO?
  SEO (Search Engine Optimization) is the practice of optimizing...
▼ How long does SEO take to work?
  SEO typically takes 3-6 months to show significant results...
▼ Is SEO better than paid advertising?
  SEO and paid advertising serve different purposes...
undefined
SEO Guide: Complete Beginner's Tutorial
yoursite.com/seo-guide/
Learn SEO from scratch with our comprehensive guide...

▼ What is SEO?
  SEO (Search Engine Optimization) is the practice of optimizing...
▼ How long does SEO take to work?
  SEO typically takes 3-6 months to show significant results...
▼ Is SEO better than paid advertising?
  SEO and paid advertising serve different purposes...
undefined

Schema Type Quick Reference

Schema类型速查

Content TypeSchema TypeKey Properties
Blog PostBlogPosting/Articleheadline, datePublished, author
ProductProductname, price, availability
FAQFAQPageQuestion, Answer
How-ToHowTostep, totalTime
Local BusinessLocalBusinessaddress, geo, openingHours
RecipeRecipeingredients, cookTime
EventEventstartDate, location
VideoVideoObjectuploadDate, duration
CourseCourseprovider, name
ReviewReviewitemReviewed, ratingValue
内容类型Schema类型核心属性
博客文章BlogPosting/Articleheadline, datePublished, author
产品Productname, price, availability
FAQFAQPageQuestion, Answer
指南HowTostep, totalTime
本地商家LocalBusinessaddress, geo, openingHours
食谱Recipeingredients, cookTime
活动EventstartDate, location
视频VideoObjectuploadDate, duration
课程Courseprovider, name
评价ReviewitemReviewed, ratingValue

Tips for Success

成功技巧

  1. Match visible content - Schema must reflect what users see
  2. Don't spam - Only add schema for relevant content
  3. Keep updated - Update dates and prices when they change
  4. Test thoroughly - Validate before deploying
  5. Monitor Search Console - Watch for errors and warnings
  1. 匹配可见内容 - Schema必须如实反映用户看到的内容
  2. 避免滥用 - 仅为相关内容添加Schema
  3. 及时更新 - 日期、价格变更时同步更新Schema
  4. 全面测试 - 部署前完成验证
  5. 监控Search Console - 关注错误与警告

Schema Type Decision Tree

Schema类型决策树

Reference: See references/schema-decision-tree.md for the full decision tree (content-to-schema mapping), industry-specific recommendations, implementation priority tiers (P0-P4), and validation quick reference.
参考:查看references/schema-decision-tree.md获取完整决策树(内容到Schema的映射)、行业特定建议、实施优先级层级(P0-P4)及验证速查指南。

Reference Materials

参考资料

  • Schema Templates - Copy-ready JSON-LD templates for all schema types
  • Validation Guide - Common errors, required properties, testing workflow
  • Schema Templates - 所有Schema类型的可复制JSON-LD模板
  • Validation Guide - 常见错误、必填属性、测试流程

Next Best Skill

关联工具

  • Primary: seo-analysis — verify implementation with a technical SEO audit.
  • 首选seo-analysis — 通过技术SEO审核验证实施效果。