Structured Data Builder
Generates JSON-LD schema markup that unlocks rich results and helps AI systems parse your content. Schema is both a ranking signal and a comprehension aid.
Quick Start
Generate schema for a [blog post / product / FAQ / event]
Build FAQ schema for these questions: [list]
What schema should I add to [URL]?
Engine Contract
- Reads: page type, content details, target rich result, existing markup if any
- Writes: valid JSON-LD markup with implementation notes
- Promotes: schema opportunities and entity mappings to hot cache
- Next handoff: signal packet with markup specs
Instructions
Run three phases:
- Identify Type — determine the best schema type(s) for the page: Article, Product, FAQPage, HowTo, LocalBusiness, Organization, Person, Review, Event, SoftwareApplication
- Build Markup — generate complete, valid JSON-LD with all required and recommended properties
- Validate — check for common errors (missing required fields, incorrect nesting, invalid values) and provide placement instructions
Common Schema Types
| Page Type |
Schema |
Rich Result |
| Blog post |
Article, BlogPosting |
Headlines, images, date |
| Product page |
Product, Offer, Review |
Price, availability, rating |
| FAQ page |
FAQPage |
Expandable questions in SERP |
| How-to guide |
HowTo |
Steps, images, time |
| Local business |
LocalBusiness |
Map, hours, contact |
| Software |
SoftwareApplication |
Rating, OS, price |
| Event |
Event |
Date, location, tickets |
| Organization |
Organization |
Knowledge panel |
Best Practices
- Place JSON-LD in the
<head>
- Match on-page content exactly (no bait-and-switch)
- Include
@id for entity disambiguation
- Combine multiple schemas when logical (e.g., Article + FAQPage)
- Test with Google's Rich Results Test before shipping
Next Best Engine
- Primary: page-diagnostics — verify full on-page health
- Alternatives: entity-harmonizer, site-health-audit
1---2name: structured-data-builder3description: Generate JSON-LD structured data for rich results, knowledge panels, and AI comprehension. 结构化数据/Schema生成4license: MIT5---67# Structured Data Builder89Generates JSON-LD schema markup that unlocks rich results and helps AI systems parse your content. Schema is both a ranking signal and a comprehension aid.1011## Quick Start1213```14Generate schema for a [blog post / product / FAQ / event]15```1617```18Build FAQ schema for these questions: [list]19```2021```22What schema should I add to [URL]?23```2425## Engine Contract2627- **Reads**: page type, content details, target rich result, existing markup if any28- **Writes**: valid JSON-LD markup with implementation notes29- **Promotes**: schema opportunities and entity mappings to hot cache30- **Next handoff**: signal packet with markup specs3132## Instructions3334Run three phases:35361. **Identify Type** — determine the best schema type(s) for the page: Article, Product, FAQPage, HowTo, LocalBusiness, Organization, Person, Review, Event, SoftwareApplication372. **Build Markup** — generate complete, valid JSON-LD with all required and recommended properties383. **Validate** — check for common errors (missing required fields, incorrect nesting, invalid values) and provide placement instructions3940## Common Schema Types4142| Page Type | Schema | Rich Result |43|-----------|--------|-------------|44| Blog post | Article, BlogPosting | Headlines, images, date |45| Product page | Product, Offer, Review | Price, availability, rating |46| FAQ page | FAQPage | Expandable questions in SERP |47| How-to guide | HowTo | Steps, images, time |48| Local business | LocalBusiness | Map, hours, contact |49| Software | SoftwareApplication | Rating, OS, price |50| Event | Event | Date, location, tickets |51| Organization | Organization | Knowledge panel |5253## Best Practices5455- Place JSON-LD in the `<head>`56- Match on-page content exactly (no bait-and-switch)57- Include `@id` for entity disambiguation58- Combine multiple schemas when logical (e.g., Article + FAQPage)59- Test with Google's Rich Results Test before shipping6061## Next Best Engine6263- **Primary**: [page-diagnostics](refine/page-diagnostics/SKILL.md) — verify full on-page health64- **Alternatives**: [entity-harmonizer](guardian/entity-harmonizer/SKILL.md), [site-health-audit](refine/site-health-audit/SKILL.md)
excelle