<p align="center">
  <img src="https://capsule-render.vercel.app/api?type=waving&color=0:4F46E5,100:7C3AED&height=220&section=header&text=Schema%20Gen&fontSize=80&fontColor=ffffff&animation=fadeIn&fontAlignY=35&desc=Generate%20Schema.org%20markup%20in%20seconds&descSize=20&descAlignY=55&descColor=E0E7FF" width="100%" />
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/schema-gen-mcp"><img src="https://img.shields.io/npm/v/schema-gen-mcp?style=for-the-badge&color=4F46E5&labelColor=1E1B4B" alt="npm version" /></a>
  <a href="https://github.com/sharozdawa/schema-gen/stargazers"><img src="https://img.shields.io/github/stars/sharozdawa/schema-gen?style=for-the-badge&color=7C3AED&labelColor=1E1B4B" alt="GitHub stars" /></a>
  <a href="https://github.com/sharozdawa/schema-gen/blob/main/LICENSE"><img src="https://img.shields.io/github/license/sharozdawa/schema-gen?style=for-the-badge&color=6366F1&labelColor=1E1B4B" alt="License" /></a>
  <a href="https://glama.ai/mcp/servers/sharozdawa/schema-gen"><img src="https://glama.ai/mcp/servers/sharozdawa/schema-gen/badges/score.svg" alt="Schema Gen MCP server" /></a>
</p>

<p align="center">
  <strong>Generate Schema.org JSON-LD structured data markup for any schema type.</strong><br/>
  Web app with live preview + MCP server for AI-powered schema generation.
</p>

---

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

```bash
# 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](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`:

```json
{
  "mcpServers": {
    "schema-gen": {
      "command": "npx",
      "args": ["-y", "schema-gen-mcp"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

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

```json
{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "Jane Doe",
  "jobTitle": "Software Engineer",
  "url": "https://janedoe.com",
  "worksFor": {
    "@type": "Organization",
    "name": "Acme Corp"
  },
  "sameAs": [
    "https://twitter.com/janedoe",
    "https://linkedin.com/in/janedoe"
  ]
}
```

---

## Why Schema Gen vs Alternatives

| Feature | schema-gen | TechnicalSEO.com | Merkle Schema Generator |
|---------|-----------|-----------------|------------------------|
| Schema types | 12 | 8 | 6 |
| Live preview | Yes | Yes | No |
| MCP Server | Yes | No | No |
| Self-hostable | Yes | No | No |
| Open source | Yes | No | No |
| Price | Free | Free | Free |

## More Open Source SEO Tools

| Tool | Description |
|------|-------------|
| [awesome-seo-mcp-servers](https://github.com/sharozdawa/awesome-seo-mcp-servers) | Curated list of SEO MCP servers and agent skills |
| [robotstxt-ai](https://github.com/sharozdawa/robotstxt-ai) | Visual robots.txt manager for AI crawlers |
| [indexnow-mcp](https://github.com/sharozdawa/indexnow-mcp) | Instant URL indexing via IndexNow |
| [ai-visibility](https://github.com/sharozdawa/ai-visibility) | AI brand visibility tracker |

## License

MIT

---

<p align="center">
  Built by <strong>Sharoz Dawa</strong>
</p>

<p align="center">
  <a href="https://github.com/sharozdawa"><img src="https://img.shields.io/badge/GitHub-sharozdawa-181717?style=for-the-badge&logo=github" alt="GitHub" /></a>
  <a href="https://twitter.com/AISEOSharoz"><img src="https://img.shields.io/badge/Twitter-@AISEOSharoz-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white" alt="Twitter" /></a>
</p>

<img src="https://capsule-render.vercel.app/api?type=waving&color=0:4F46E5,100:7C3AED&height=120&section=footer" width="100%" />