Schema Generator

Phase 1: Schema Type Resolution

Determine Required Schema Types

Based on page_type, identify the primary schema and any supplementary schemas:

Phase 2: Field Gathering

If URL Provided

• Visit the page via browser automation
• Auto-extract relevant fields:
  • Page title, description, headings
  • Product details: name, price, currency, availability, images, SKU, brand
  • Article details: headline, author, datePublished, dateModified, image
  • FAQ: extract Q&A pairs from heading + paragraph patterns
  • Business: name, address, phone, hours from footer/contact page
  • Breadcrumb: derive from URL path structure
• Present extracted data for user confirmation before generating

If Data Object Provided

• Validate that all required fields for the schema type are present
• Prompt for any missing required fields
• Apply defaults from config where appropriate

Required vs Recommended Fields

For each schema type, clearly separate:

• Required fields: schema will fail validation without these
• Recommended fields: improve rich snippet eligibility
• Optional fields: enhance completeness but not required

Phase 3: Schema Generation

Product Schema

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "{{product_name}}",
  "image": ["{{image_url_1}}", "{{image_url_2}}"],
  "description": "{{description}}",
  "sku": "{{sku}}",
  "brand": {
    "@type": "Brand",
    "name": "{{brand_name}}"
  },
  "offers": {
    "@type": "Offer",
    "url": "{{page_url}}",
    "priceCurrency": "{{currency}}",
    "price": "{{price}}",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "{{seller_name}}"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "{{rating}}",
    "reviewCount": "{{review_count}}"
  }
}

Article Schema

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "{{headline}}",
  "image": ["{{image_url}}"],
  "datePublished": "{{date_published}}",
  "dateModified": "{{date_modified}}",
  "author": {
    "@type": "Person",
    "name": "{{author_name}}",
    "url": "{{author_url}}"
  },
  "publisher": {
    "@type": "Organization",
    "name": "{{publisher_name}}",
    "logo": {
      "@type": "ImageObject",
      "url": "{{publisher_logo_url}}"
    }
  },
  "description": "{{description}}",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "{{page_url}}"
  }
}

FAQ Schema

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "{{question_1}}",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "{{answer_1}}"
      }
    }
  ]
}

LocalBusiness Schema

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "{{business_name}}",
  "image": "{{image_url}}",
  "url": "{{website_url}}",
  "telephone": "{{phone}}",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "{{street}}",
    "addressLocality": "{{city}}",
    "addressRegion": "{{state}}",
    "postalCode": "{{zip}}",
    "addressCountry": "{{country}}"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "{{lat}}",
    "longitude": "{{lng}}"
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "17:00"
    }
  ]
}

Organization Schema

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "{{org_name}}",
  "url": "{{org_url}}",
  "logo": "{{logo_url}}",
  "sameAs": [
    "{{linkedin_url}}",
    "{{twitter_url}}",
    "{{facebook_url}}"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "{{phone}}",
    "contactType": "customer service"
  }
}

HowTo Schema

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "{{title}}",
  "description": "{{description}}",
  "totalTime": "{{duration_iso8601}}",
  "step": [
    {
      "@type": "HowToStep",
      "name": "{{step_name}}",
      "text": "{{step_text}}",
      "image": "{{step_image_url}}"
    }
  ]
}

BreadcrumbList Schema

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "{{base_url}}"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "{{category_name}}",
      "item": "{{category_url}}"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "{{page_name}}",
      "item": "{{page_url}}"
    }
  ]
}

Service Schema

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "{{service_name}}",
  "description": "{{description}}",
  "provider": {
    "@type": "Organization",
    "name": "{{provider_name}}",
    "url": "{{provider_url}}"
  },
  "serviceType": "{{service_type}}",
  "areaServed": {
    "@type": "Country",
    "name": "{{country}}"
  },
  "offers": {
    "@type": "Offer",
    "price": "{{starting_price}}",
    "priceCurrency": "{{currency}}"
  }
}

Phase 4: Validation

Schema.org Compliance Check

• Verify all required properties are present for the schema type
• Verify data types match expectations (string, number, URL, date in ISO 8601)
• Verify URLs are absolute, not relative
• Verify image URLs are accessible
• Check for deprecated properties and suggest current alternatives
• Ensure @context is https://schema.org (not http)

Common Error Prevention

• No trailing commas in JSON
• No single quotes (must be double quotes)
• Dates in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
• Prices as strings with decimals: "29.99" not 29.99
• Availability values must be full schema.org URLs: https://schema.org/InStock

Rich Results Eligibility

• Check which Google rich result types the schema qualifies for
• Flag any missing fields that would prevent rich result display
• Note: FAQ rich results, Product rich results, Review stars, Recipe cards, How-to steps

Phase 5: Output

Return structured JSON:

{
  "page_url": "https://example.com/products/widget",
  "generated_at": "2024-01-15T14:30:00Z",
  "page_type": "product",
  "schemas_generated": ["Product", "BreadcrumbList"],
  "validation_status": "PASS",
  "rich_result_eligible": ["Product snippet", "Review stars", "Price display"],
  "script_tags": [
    {
      "schema_type": "Product",
      "json_ld": "<script type=\"application/ld+json\">\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"Product\",\n  ...\n}\n</script>"
    },
    {
      "schema_type": "BreadcrumbList",
      "json_ld": "<script type=\"application/ld+json\">\n{\n  \"@context\": \"https://schema.org\",\n  \"@type\": \"BreadcrumbList\",\n  ...\n}\n</script>"
    }
  ],
  "validation_notes": [
    "All required Product fields present",
    "AggregateRating included -- eligible for review stars in SERPs",
    "BreadcrumbList derived from URL path structure"
  ],
  "missing_recommended_fields": [
    { "field": "gtin", "impact": "Adds product identification for Google Shopping" },
    { "field": "review", "impact": "Individual reviews strengthen review star display" }
  ],
  "implementation_instructions": "Add both script tags to the <head> section of the page. Test with Google Rich Results Test: https://search.google.com/test/rich-results"
}

Example Usage

Trigger phrases:

• "Generate schema for [page type]"
• "Create JSON-LD for [url]"
• "Add structured data to [page type]"
• "Schema markup for my [product/article/FAQ]"
• "Generate FAQ schema for these questions"

User: Generate product schema for plasho.com/services/shopify-setup
Assistant: [visits page, extracts service details, generates Service + Organization + BreadcrumbList JSON-LD, validates, returns ready-to-paste script tags]

User: Create FAQ schema for these Q&As: "How long does setup take?" "2-3 weeks", "What's included?" "Full store setup with theme customization"
Assistant: [generates FAQPage JSON-LD with both Q&A pairs, validates, returns script tag]

User: What schema should I add to my homepage?
Assistant: [recommends Organization + WebSite + SearchAction, gathers details, generates all three, returns validated script tags]