什么是 Schema 标记生成器？

Schema 标记生成器是 Openclaw Skills 库中的专业技术工具，旨在弥合网页内容与搜索引擎理解之间的鸿沟。它能自动创建复杂的 JSON-LD 结构，确保您的网站符合高影响力的富媒体搜索结果资格，如 FAQ 片段、星级评分和产品轮播图。通过使用此技能，开发人员无需手动解析庞大的 Schema.org 词汇表即可实施 SEO 最佳实践。

此技能不仅能生成代码，还能将您的现有内容映射到 CORE-EEAT 基准标准，以确保最大的相关性和权威性。无论您是优化本地业务页面还是技术博客，这些 Openclaw Skills 都能为现代搜索引擎和 AI 系统准确索引、理解和引用您的信息提供所需的技术基础。

下载入口:https://github.com/openclaw/skills/tree/main/skills/aaron-he-zhu/schema-markup-generator

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Schema 标记生成器 应用场景

• 添加 FAQ 架构，通过可扩展的问答框扩大搜索结果页面（SERP）的占用面积。
• 生成产品和综合评分标记，在搜索结果中显示价格、库存情况和星级评分。
• 实施操作指南（How-To）架构，为分步指南捕获适合移动设备的富媒体摘要。
• 创建本地业务和组织标记，以增强品牌知名度和地理相关性。
• 审核并纠正现有的结构化数据验证错误，以保持搜索合规性。

1. 该技能分析提供的 URL 或原始 HTML 内容，以识别核心内容类型，如博客文章、产品页面或 FAQ 部分。
2. 它将识别出的内容与 CORE-EEAT Schema 映射表进行对比，为特定页面确定最有益的主要和条件架构类型。
3. 该工具生成经过验证的 JSON-LD 数据负载，包括专门针对 Google 和 Bing 富媒体搜索结果要求的所有必需和推荐属性。
4. 它提供视觉 SERP 预览，以准确展示标记将如何影响搜索结果在用户面前的呈现方式。
5. 生成一份全面的实施指南，提供将代码放置在 HTML 头部或正文中并进行最终验证的分步说明。

Schema 标记生成器 配置指南

要安装作为 SEO 和 GEO 库一部分的 Schema 标记生成器，请在终端中运行以下命令：

npx skills add aaron-he-zhu/seo-geo-claude-skills

不需要额外的系统包。该技能与 Claude Code 及更广泛的 Openclaw Skills 生态系统完全兼容。

Schema 标记生成器 数据架构与分类体系

该技能将结构化数据组织成有效的 JSON-LD 对象。以下是用于常见内容类型的映射分类：

所有生成的数据都遵循 ISO 8601 日期格式，并使用绝对 URL 以确保完整的搜索引擎兼容性。

name: schema-markup-generator
version: "3.0.0"
description: 'This skill should be used when the user asks to "add schema markup", "generate structured data", "JSON-LD", "rich snippets", "FAQ schema", "HowTo schema", "Product schema", "Article schema", "LocalBusiness schema", "Organization schema", "BreadcrumbList", "I want star ratings in Google", "rich results", "voice search optimization", "event markup", or "structured data validation errors". Generates Schema.org JSON-LD for FAQPage, HowTo, Article/BlogPosting, Product, AggregateRating, LocalBusiness, Organization, BreadcrumbList, Event, and Recipe types. Produces validated markup targeting Google Rich Results, Bing structured data, and AI system understanding (FAQ schema improves AI citation chances). Validates against Google Rich Results Test requirements. For broader technical SEO, see technical-seo-checker. For meta tag optimization, see meta-tags-optimizer.'
license: Apache-2.0
compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations."
allowed-tools: WebFetch
metadata:
  author: aaron-he-zhu
  version: "3.0.0"
  geo-relevance: "medium"
  tags:
    - seo
    - structured-data
    - json-ld
    - rich-results
    - rich-snippets
    - faq-schema
    - howto-schema
    - product-schema
    - article-schema
    - localbusiness-schema
    - schema-org
  triggers:
    - "add schema markup"
    - "generate structured data"
    - "JSON-LD"
    - "rich snippets"
    - "FAQ schema"
    - "schema.org"
    - "structured data markup"
    - "add FAQ rich results"
    - "I want star ratings in Google"
    - "product markup"
    - "recipe schema"

Schema Markup Generator

SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

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.

When to Use This Skill

• 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

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

How to Use

Generate Schema for Content

Generate schema markup for this [content type]: [content/URL]

Create FAQ schema for these questions and answers: [Q&A list]

Specific Schema Types

Create Product schema for [product name] with [details]

Generate LocalBusiness schema for [business name and details]

Audit Existing Schema

Review and improve this schema markup: [existing schema]

Data Sources

See CONNECTORS.md for tool category placeholders.

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.

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:

   ### 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).*
   

   ### 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

   Option 2: Before closing

   Validation Steps

   1. ~~schema validator

      • Test your live URL or paste code
      • Check for errors and warnings

   2. Schema.org Validator

      • URL: https://validator.schema.org/
      • Validates against Schema.org spec

   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

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

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)

Example

User: "Generate FAQ schema for a page about SEO with 3 questions"

Output:

## FAQ Schema for SEO Page

### 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 and place in or before . Test with ~~schema validator.

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...

## Schema Type Quick Reference

| Content Type | Schema Type | Key Properties |
|--------------|-------------|----------------|
| Blog Post | BlogPosting/Article | headline, datePublished, author |
| Product | Product | name, price, availability |
| FAQ | FAQPage | Question, Answer |
| How-To | HowTo | step, totalTime |
| Local Business | LocalBusiness | address, geo, openingHours |
| Recipe | Recipe | ingredients, cookTime |
| Event | Event | startDate, location |
| Video | VideoObject | uploadDate, duration |
| Course | Course | provider, name |
| Review | Review | itemReviewed, 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

## Schema Type Decision Tree

> **Reference**: See [references/schema-decision-tree.md](./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.

## Reference Materials

- [Schema Templates](./references/schema-templates.md) - Copy-ready JSON-LD templates for all schema types
- [Validation Guide](./references/validation-guide.md) - Common errors, required properties, testing workflow

## Related Skills

- [seo-content-writer](../seo-content-writer/) — Create content worth marking up
- [on-page-seo-auditor](../../optimize/on-page-seo-auditor/) — Audit existing schema
- [technical-seo-checker](../../optimize/technical-seo-checker/) — Technical validation
- [entity-optimizer](../../cross-cutting/entity-optimizer/) — Entity audit informs Organization, Person, Product schema