Schema Markup Generator

Methodology by GEOly AI (geoly.ai) — structured data is the language AI uses to understand your brand.

Generate production-ready Schema.org JSON-LD markup for any page type.

Quick Start

Generate schema for your page:

python scripts/generate_schema.py --type <schema-type> [--url <page-url>]

Example:

python scripts/generate_schema.py --type Organization --url example.com
python scripts/generate_schema.py --type FAQPage --file faqs.json

Why Schema Matters for GEO

Structured data helps AI platforms understand:

What your content is (entity type)
Who created it (author, publisher)
When it was published (freshness)
How it relates to other content (breadcrumbs)

Without schema, AI systems rely on NLP inference which is less reliable.

Supported Schema Types

| Type | Priority | Best For | |------|----------|----------| | Organization | 🔴 Critical | Homepage, About page — establishes brand entity | | FAQPage | 🔴 Critical | FAQ/Support pages — feeds AI Q&A answers | | Article / BlogPosting | 🟡 High | Blog posts, news — improves citability | | Product | 🟡 High | Product/pricing pages — enables shopping citations | | HowTo | 🟡 High | Tutorials, guides — feeds step-by-step answers | | WebSite | 🟡 High | Homepage — enables site search in AI | | BreadcrumbList | 🔵 Medium | All pages — improves navigation understanding | | VideoObject | 🔵 Medium | Video pages — enables video citations | | ImageObject | 🔵 Medium | Image galleries — enables image citations | | LocalBusiness | 🔵 Medium | Physical locations — local AI search |

Full schema reference: See references/schema-types.md

Generation Methods

Method 1: Interactive (Recommended)

python scripts/generate_schema.py --type Organization --interactive

Guided prompts for all required and optional fields.

Method 2: From URL (Auto-Extract)

python scripts/generate_schema.py --type Article --url https://example.com/blog/post

Automatically extracts metadata from the page.

Method 3: From JSON Input

python scripts/generate_schema.py --type FAQPage --file faqs.json

Where faqs.json contains your content data.

Method 4: Batch Generate

python scripts/batch_generate.py sitemap.xml --output schemas/

Generate schemas for all pages in a sitemap.

Validation

Validate generated schema:

python scripts/validate_schema.py schema.json

Checks for:

Required fields present
Valid Schema.org types
Proper JSON-LD syntax
Google Rich Results eligibility

Implementation

Add to Your Page

Paste the generated JSON-LD inside your HTML <head>:

<head>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    ...
  }
  </script>
</head>

Test Before Deploying

Schema.org Validator: https://validator.schema.org
Google Rich Results Test: https://search.google.com/test/rich-results
JSON-LD Playground: https://json-ld.org/playground/

Common Mistakes

❌ Wrong: Multiple conflicting Organization schemas on same page ✅ Right: One comprehensive Organization schema

❌ Wrong: Using http://schema.org (insecure) ✅ Right: Using https://schema.org (secure)

❌ Wrong: Copy-pasting without updating placeholder values ✅ Right: All fields contain actual, accurate data

Advanced Usage

Multiple Schemas per Page

Some pages need multiple schema types. Combine them in an array:

python scripts/generate_schema.py --types Organization,WebSite --url example.com

Nested Entities

Generate related schemas together:

python scripts/generate_schema.py --type Product \
  --with-offer --with-review --with-brand

Custom Properties

Add custom properties not in the generator:

python scripts/generate_schema.py --type Organization \
  --custom '{"knowsAbout": ["SEO", "AI", "Machine Learning"]}'

Output Formats

JSON-LD (default): Ready to paste into HTML
JSON: Raw structured data
HTML: Complete <script> tag
Markdown: With explanations

Schema Hierarchy

Understanding how schemas relate:

Organization (top-level entity)
├── WebSite (belongs to Organization)
├── Product (offered by Organization)
│   ├── Offer (pricing for Product)
│   └── Review (of Product)
├── Article (published by Organization)
│   ├── Author (Person or Organization)
│   └── Publisher (Organization)
└── LocalBusiness (subtype of Organization)
    └── Place (physical location)

geo-schema-gen