README.md
Web app with live preview + MCP server for AI-powered schema generation.
Features
- :sparkles: 12 Schema Types — Person, Organization, Product, FAQ, Article, LocalBusiness, Event, WebSite, BreadcrumbList, HowTo, Review, VideoObject
- :eyes: Live JSON-LD Preview — See your structured data rendered in real-time as you fill in fields
- :clipboard: One-Click Copy — Copy generated JSON-LD to clipboard instantly
- :white_check_mark: Google Rich Results Ready — Output is validated against Google's structured data requirements
- :robot: MCP Server — Use with Claude Desktop, Cursor, or any MCP-compatible AI assistant
- :shield: Schema Validation — Validate existing JSON-LD for errors and warnings
- :zap: No Dependencies — Clean, standalone web app with zero external runtime dependencies
Supported Schema Types
| Type | Description | Google Rich Result |
|---|---|---|
| Person | People, professionals, public figures | :white_check_mark: Knowledge Panel |
| Organization | Companies, non-profits, institutions | :white_check_mark: Logo, Knowledge Panel |
| Product | Products with pricing and reviews | :white_check_mark: Product Rich Snippet |
| FAQPage | Frequently asked questions | :white_check_mark: FAQ Rich Result |
| Article | Blog posts, news articles | :white_check_mark: Article Rich Result |
| LocalBusiness | Physical stores, restaurants, services | :white_check_mark: Local Business Panel |
| Event | Concerts, conferences, meetups | :white_check_mark: Event Rich Result |
| WebSite | Websites with search functionality | :white_check_mark: Sitelinks Search Box |
| BreadcrumbList | Navigation breadcrumb trails | :white_check_mark: Breadcrumb Rich Result |
| HowTo | Step-by-step instructions | :white_check_mark: How-to Rich Result |
| Review | Product or service reviews | :white_check_mark: Review Snippet |
| VideoObject | Videos with metadata | :white_check_mark: Video Rich Result |
Screenshots
Screenshots coming soon.
Getting Started
Web App
# Clone the repository
git clone https://github.com/sharozdawa/schema-gen.git
cd schema-gen
# Install dependencies
npm install
# Start the development server
npm run dev
Open http://localhost:3000 in your browser.
MCP Server
The MCP server lets AI assistants generate Schema.org markup directly. Install it in your preferred AI tool:
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"schema-gen": {
"command": "npx",
"args": ["-y", "schema-gen-mcp"]
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"schema-gen": {
"command": "npx",
"args": ["-y", "schema-gen-mcp"]
}
}
}
Available MCP Tools
| Tool | Description |
|---|---|
generate_schema |
Generate JSON-LD for any of the 12 schema types |
list_schema_types |
List all supported types with their fields |
generate_person_schema |
Quick Person schema generation |
generate_product_schema |
Quick Product schema with pricing |
generate_faq_schema |
Quick FAQ schema from Q&A pairs |
generate_article_schema |
Quick Article schema for blog posts |
generate_organization_schema |
Quick Organization schema |
validate_schema |
Validate existing JSON-LD markup |
Example Output
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Jane Doe",
"jobTitle": "Software Engineer",
"url": "https://janedoe.com",
"worksFor": {
"@type": "Organization",
"name": "Acme Corp"
},
"sameAs": [
"https://twi
Tools 8
generate_schemaGenerate JSON-LD for any of the 12 schema typeslist_schema_typesList all supported types with their fieldsgenerate_person_schemaQuick Person schema generationgenerate_product_schemaQuick Product schema with pricinggenerate_faq_schemaQuick FAQ schema from Q&A pairsgenerate_article_schemaQuick Article schema for blog postsgenerate_organization_schemaQuick Organization schemavalidate_schemaValidate existing JSON-LD markupTry it
→Generate a Person schema for Jane Doe, a software engineer at Acme Corp.
→Create a Product schema for a new laptop priced at 999 USD.
→Validate this JSON-LD snippet to ensure it meets Google's requirements.
→Generate an FAQ schema for my website with these three questions and answers.
→List all supported schema types I can generate with this tool.