構造化データの実装方法｜JSON-LDでリッチリザルト獲得

<!-- 基本的なJSON-LD構造 -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "SEO最適化の完全ガイド",
  "author": {
    "@type": "Person",
    "name": "田中太郎"
  },
  "datePublished": "2024-01-01",
  "dateModified": "2024-01-15",
  "image": "https://example.com/seo-guide.jpg",
  "description": "SEOの基礎から応用まで包括的に解説"
}
</script>

{
  "@context": "https://schema.org",
  "@type": "Article",
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://example.com/article/seo-guide"
  },
  "headline": "SEO完全ガイド：検索エンジン最適化のすべて",
  "image": [
    "https://example.com/images/seo-guide-1x1.jpg",
    "https://example.com/images/seo-guide-4x3.jpg",
    "https://example.com/images/seo-guide-16x9.jpg"
  ],
  "datePublished": "2024-01-01T08:00:00+09:00",
  "dateModified": "2024-01-15T10:30:00+09:00",
  "author": {
    "@type": "Person",
    "name": "田中太郎",
    "url": "https://example.com/author/tanaka"
  },
  "publisher": {
    "@type": "Organization",
    "name": "SEO専門メディア",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png",
      "width": 600,
      "height": 60
    }
  },
  "description": "SEOの基礎知識から最新のテクニックまで、検索エンジン最適化のすべてを包括的に解説します。",
  "articleBody": "記事の本文内容...",
  "wordCount": 2500,
  "articleSection": "SEO",
  "inLanguage": "ja-JP"
}

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "SEOコンサルティングサービス",
  "image": [
    "https://example.com/service-image-1.jpg",
    "https://example.com/service-image-2.jpg"
  ],
  "description": "専門家によるSEO診断と改善提案サービス",
  "sku": "SEO-CONSULTING-001",
  "mpn": "SEO-001",
  "brand": {
    "@type": "Brand",
    "name": "SEO Pro"
  },
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "4.8",
      "bestRating": "5"
    },
    "author": {
      "@type": "Person",
      "name": "佐藤花子"
    },
    "reviewBody": "非常に詳細で実践的な改善提案をいただきました。"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "32",
    "bestRating": "5"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/seo-consulting",
    "priceCurrency": "JPY",
    "price": "150000",
    "priceValidUntil": "2024-12-31",
    "availability": "https://schema.org/InStock",
    "seller": {
      "@type": "Organization",
      "name": "SEO専門会社"
    }
  },
  "category": "SEOサービス"
}

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "SEO専門コンサルティング株式会社",
  "image": "https://example.com/company-logo.jpg",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "渋谷区代々木1-1-1",
    "addressLocality": "渋谷区",
    "addressRegion": "東京都",
    "postalCode": "151-0053",
    "addressCountry": "JP"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 35.6870,
    "longitude": 139.6981
  },
  "url": "https://example.com",
  "telephone": "+81-3-1234-5678",
  "priceRange": "¥¥¥",
  "openingHours": [
    "Mo-Fr 09:00-18:00",
    "Sa 10:00-16:00"
  ],
  "sameAs": [
    "https://www.facebook.com/seocompany",
    "https://www.twitter.com/seocompany",
    "https://www.linkedin.com/company/seocompany"
  ],
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "5",
      "bestRating": "5"
    },
    "author": {
      "@type": "Person",
      "name": "山田一郎"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "25"
  }
}

<!-- 配列形式での複数スキーマ -->
<script type="application/ld+json">
[
  {
    "@context": "https://schema.org",
    "@type": "Organization",
    "name": "SEO専門会社",
    "url": "https://example.com",
    "logo": "https://example.com/logo.png"
  },
  {
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "SEO最新トレンド2024",
    "author": {
      "@type": "Person",
      "name": "SEO専門家"
    },
    "publisher": {
      "@id": "#organization"
    }
  }
]
</script>

<!-- 別々のscriptタグでの実装 -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "ホーム",
      "item": "https://example.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "SEOガイド",
      "item": "https://example.com/seo-guide"
    }
  ]
}
</script>

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "SEOとは何ですか？",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEO（Search Engine Optimization）は、検索エンジンでの表示順位を向上させるための最適化手法です。ウェブサイトの構造、コンテンツ、技術的要素を改善することで、検索結果での視認性を高めます。"
      }
    },
    {
      "@type": "Question",
      "name": "SEO対策にはどのくらいの期間が必要ですか？",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "SEOの効果が現れるまでには通常3-6ヶ月程度かかります。競合性やキーワードの難易度、サイトの現状によって期間は変動します。継続的な改善と品質の高いコンテンツ作成が重要です。"
      }
    }
  ]
}

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "SEO監査の実行方法",
  "description": "ウェブサイトのSEO状況を包括的に分析する手順",
  "image": "https://example.com/seo-audit-guide.jpg",
  "totalTime": "PT2H",
  "estimatedCost": {
    "@type": "MonetaryAmount",
    "currency": "JPY",
    "value": "0"
  },
  "tool": [
    {
      "@type": "HowToTool",
      "name": "Google Search Console"
    },
    {
      "@type": "HowToTool",
      "name": "Google Analytics"
    }
  ],
  "step": [
    {
      "@type": "HowToStep",
      "name": "技術的SEO分析",
      "text": "サイトの技術的な問題を特定します",
      "image": "https://example.com/step1.jpg",
      "url": "https://example.com/seo-audit#step1"
    },
    {
      "@type": "HowToStep",
      "name": "コンテンツ分析",
      "text": "コンテンツの品質と最適化状況を確認します",
      "image": "https://example.com/step2.jpg",
      "url": "https://example.com/seo-audit#step2"
    }
  ]
}

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "SEO専門メディア",
  "url": "https://example.com/",
  "potentialAction": {
    "@type": "SearchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://example.com/search?q={search_term_string}"
    },
    "query-input": "required name=search_term_string"
  }
}

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "ホーム",
      "item": "https://example.com"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "SEOガイド",
      "item": "https://example.com/seo"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "構造化データ",
      "item": "https://example.com/seo/structured-data"
    }
  ]
}

<?php
// functions.phpでのJSON-LD出力
function add_structured_data() {
    if (is_single()) {
        global $post;
        $schema = array(
            '@context' => 'https://schema.org',
            '@type' => 'Article',
            'headline' => get_the_title(),
            'author' => array(
                '@type' => 'Person',
                'name' => get_the_author()
            ),
            'datePublished' => get_the_date('c'),
            'dateModified' => get_the_modified_date('c')
        );

        echo '<script type="application/ld+json">';
        echo json_encode($schema, JSON_UNESCAPED_UNICODE);
        echo '</script>';
    }
}
add_action('wp_head', 'add_structured_data');
?>

<!-- product.liquid テンプレートでの商品スキーマ -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "{{ product.title | escape }}",
  "description": "{{ product.description | strip_html | escape }}",
  "image": [
    {% for image in product.images limit: 3 %}
      "{{ image | img_url: 'master' }}"{% unless forloop.last %},{% endunless %}
    {% endfor %}
  ],
  "offers": {
    "@type": "Offer",
    "price": "{{ product.price | money_without_currency }}",
    "priceCurrency": "{{ shop.currency }}",
    "availability": "{% if product.available %}https://schema.org/InStock{% else %}https://schema.org/OutOfStock{% endif %}",
    "url": "{{ shop.url }}{{ product.url }}"
  },
  {% if product.reviews.size > 0 %}
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "{{ product.reviews_average }}",
    "reviewCount": "{{ product.reviews.size }}"
  },
  {% endif %}
  "brand": {
    "@type": "Brand",
    "name": "{{ product.vendor | escape }}"
  }
}
</script>

// Next.js でのJSON-LD実装
import Head from 'next/head';

const BlogPost = ({ post }) => {
  const structuredData = {
    '@context': 'https://schema.org',
    '@type': 'Article',
    headline: post.title,
    author: {
      '@type': 'Person',
      name: post.author.name
    },
    datePublished: post.publishedAt,
    dateModified: post.updatedAt,
    image: post.featuredImage.url,
    description: post.excerpt
  };

  return (
    <>
      <Head>
        <script
          type="application/ld+json"
          dangerouslySetInnerHTML={{
            __html: JSON.stringify(structuredData)
          }}
        />
      </Head>
      <article>
        <h1>{post.title}</h1>
        <div dangerouslySetInnerHTML={{ __html: post.content }} />
      </article>
    </>
  );
};

export default BlogPost;

// JavaScript での動的構造化データ生成
class StructuredDataGenerator {
  constructor(pageData) {
    this.data = pageData;
    this.schema = {};
  }

  generateArticleSchema() {
    if (this.data.type !== 'article') return null;

    return {
      '@context': 'https://schema.org',
      '@type': 'Article',
      headline: this.data.title,
      author: this.generateAuthorSchema(),
      datePublished: this.data.publishedDate,
      dateModified: this.data.modifiedDate || this.data.publishedDate,
      image: this.selectBestImages(),
      description: this.data.excerpt || this.generateExcerpt(),
      publisher: this.generatePublisherSchema(),
      mainEntityOfPage: {
        '@type': 'WebPage',
        '@id': this.data.url
      },
      articleSection: this.data.category,
      inLanguage: this.data.language || 'ja'
    };
  }

  generateAuthorSchema() {
    if (!this.data.author) return null;

    return {
      '@type': 'Person',
      name: this.data.author.name,
      url: this.data.author.url,
      sameAs: this.data.author.socialUrls || []
    };
  }

  selectBestImages() {
    const images = this.data.images || [];
    return images
      .filter(img => img.width >= 696 && img.height >= 696)
      .slice(0, 3)
      .map(img => img.url);
  }

  generateExcerpt() {
    if (!this.data.content) return '';
    return this.data.content
      .replace(/<[^>]*>/g, '')
      .substring(0, 160)
      .trim() + '...';
  }

  injectSchema() {
    const schema = this.generateArticleSchema();
    if (!schema) return;

    const script = document.createElement('script');
    script.type = 'application/ld+json';
    script.textContent = JSON.stringify(schema);
    document.head.appendChild(script);
  }
}

// 使用例
const pageData = {
  type: 'article',
  title: 'SEO最新動向2024',
  author: { name: '田中太郎', url: '/author/tanaka' },
  publishedDate: '2024-01-01T09:00:00+09:00',
  images: [{ url: '/hero.jpg', width: 1200, height: 800 }],
  category: 'SEO',
  language: 'ja'
};

const generator = new StructuredDataGenerator(pageData);
generator.injectSchema();

// 構造化データ検証スクリプト例
class StructuredDataValidator {
  constructor() {
    this.errors = [];
    this.warnings = [];
  }

  validateArticle(schema) {
    // 必須プロパティチェック
    const requiredProps = ['@type', 'headline', 'author', 'datePublished'];
    requiredProps.forEach(prop => {
      if (!schema[prop]) {
        this.errors.push(`必須プロパティ '${prop}' が不足しています`);
      }
    });

    // 日付形式チェック
    if (schema.datePublished && !this.isValidDate(schema.datePublished)) {
      this.errors.push('datePublishedの形式が不正です (ISO 8601形式で入力してください)');
    }

    // 画像要件チェック
    if (!schema.image || schema.image.length === 0) {
      this.warnings.push('画像が設定されていません (リッチリザルト表示には画像が推奨)');
    }

    // 文字数チェック
    if (schema.headline && schema.headline.length > 110) {
      this.warnings.push('タイトルが長すぎます (110文字以内推奨)');
    }

    return {
      isValid: this.errors.length === 0,
      errors: this.errors,
      warnings: this.warnings
    };
  }

  isValidDate(dateString) {
    const iso8601Regex = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}[+-]\d{2}:\d{2}$/;
    return iso8601Regex.test(dateString);
  }

  async testWithGoogleAPI(url) {
    // Google Rich Results Test API (仮想的な例)
    try {
      const response = await fetch(`https://searchconsole.googleapis.com/v1/urlTestingTools/richResults:run`, {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({
          url: url,
          mobileCompatibilityTest: true
        })
      });

      const result = await response.json();
      return {
        richResultsDetected: result.richResultsDetected,
        issues: result.issues || []
      };
    } catch (error) {
      console.error('API test failed:', error);
      return null;
    }
  }
}

// 使用例
const validator = new StructuredDataValidator();
const articleSchema = {
  '@type': 'Article',
  'headline': 'SEO構造化データガイド',
  'author': { '@type': 'Person', 'name': '田中太郎' },
  'datePublished': '2024-01-01T09:00:00+09:00',
  'image': ['https://example.com/image.jpg']
};

const validation = validator.validateArticle(articleSchema);
console.log('検証結果:', validation);

# GitHub Actions での構造化データテスト自動化
name: Structured Data Test
on:
  push:
    paths:
      - '**/*.html'
      - '**/*.php'
      - '**/*.js'

jobs:
  test-structured-data:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - name: Setup Node.js
        uses: actions/setup-node@v2
        with:
          node-version: '16'

      - name: Install dependencies
        run: |
          npm install -g @google/structured-data-testing-tool
          npm install lighthouse

      - name: Build site
        run: npm run build

      - name: Start local server
        run: |
          npm run serve &
          sleep 10

      - name: Test structured data
        run: |
          # 主要ページの構造化データをテスト
          npx structured-data-testing http://localhost:3000/
          npx structured-data-testing http://localhost:3000/blog/sample-post/
          npx structured-data-testing http://localhost:3000/products/sample/

      - name: Rich Results Test
        run: |
          # カスタムスクリプトでリッチリザルトテスト
          node scripts/test-rich-results.js

      - name: Generate report
        run: |
          node scripts/generate-structured-data-report.js > structured-data-report.md

      - name: Upload report
        uses: actions/upload-artifact@v2
        with:
          name: structured-data-report
          path: structured-data-report.md

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "株式会社SEO専門",
  "alternateName": "SEO Pro",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+81-3-1234-5678",
    "contactType": "customer service",
    "availableLanguage": ["Japanese", "English"],
    "areaServed": "JP"
  },
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "渋谷区代々木1-1-1",
    "addressLocality": "渋谷区",
    "addressRegion": "東京都",
    "postalCode": "151-0053",
    "addressCountry": "JP"
  },
  "sameAs": [
    "https://www.facebook.com/seopro",
    "https://www.twitter.com/seopro",
    "https://www.linkedin.com/company/seopro"
  ],
  "foundingDate": "2020-01-01",
  "numberOfEmployees": {
    "@type": "QuantitativeValue",
    "value": 25
  },
  "description": "SEOとデジタルマーケティングの専門会社"
}

{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "田中太郎",
  "jobTitle": "SEOコンサルタント",
  "worksFor": {
    "@type": "Organization",
    "name": "株式会社SEO専門"
  },
  "email": "tanaka@example.com",
  "url": "https://example.com/author/tanaka",
  "image": "https://example.com/authors/tanaka.jpg",
  "sameAs": [
    "https://twitter.com/tanaka_seo",
    "https://www.linkedin.com/in/tanaka-taro"
  ],
  "alumniOf": {
    "@type": "EducationalOrganization",
    "name": "東京大学"
  },
  "knowsAbout": [
    "SEO",
    "デジタルマーケティング",
    "コンテンツマーケティング"
  ],
  "description": "10年以上のSEO経験を持つコンサルタント"
}

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "SEOの基礎：完全初心者ガイド",
  "description": "SEO初心者向けに基本概念から実践方法まで分かりやすく解説",
  "thumbnailUrl": "https://example.com/video-thumbnail.jpg",
  "uploadDate": "2024-01-01T10:00:00+09:00",
  "duration": "PT15M33S",
  "contentUrl": "https://example.com/videos/seo-basics.mp4",
  "embedUrl": "https://example.com/embed/seo-basics",
  "publisher": {
    "@type": "Organization",
    "name": "SEO専門チャンネル",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/channel-logo.png"
    }
  },
  "creator": {
    "@type": "Person",
    "name": "田中太郎"
  },
  "inLanguage": "ja",
  "isFamilyFriendly": true,
  "keywords": "SEO, 検索エンジン最適化, デジタルマーケティング",
  "interactionStatistic": [
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/WatchAction",
      "userInteractionCount": 1523
    },
    {
      "@type": "InteractionCounter",
      "interactionType": "https://schema.org/LikeAction",
      "userInteractionCount": 89
    }
  ]
}

{
  "@context": "https://schema.org",
  "@type": "Course",
  "name": "実践SEOマスタークラス",
  "description": "実際のサイト改善を通じてSEOを学ぶ実践型コース",
  "provider": {
    "@type": "Organization",
    "name": "SEO専門アカデミー"
  },
  "instructor": {
    "@type": "Person",
    "name": "田中太郎"
  },
  "courseCode": "SEO-MASTER-001",
  "educationalLevel": "intermediate",
  "inLanguage": "ja",
  "totalTime": "PT20H",
  "numberOfCredits": 4,
  "learningResourceType": "online course",
  "teaches": [
    "SEO戦略立案",
    "テクニカルSEO",
    "コンテンツ最適化",
    "効果測定"
  ],
  "coursePrerequisites": "基本的なWebマーケティング知識",
  "occupationalCredentialAwarded": "SEOスペシャリスト認定",
  "offers": {
    "@type": "Offer",
    "price": "89000",
    "priceCurrency": "JPY",
    "availability": "https://schema.org/InStock",
    "validFrom": "2024-01-01",
    "validThrough": "2024-12-31"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "156",
    "bestRating": "5"
  }
}

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "SEOコンサルティングサービス",
  "description": "企業のWebサイト集客力向上を支援するSEOコンサルティング",
  "provider": {
    "@type": "Organization",
    "name": "株式会社SEO専門"
  },
  "areaServed": [
    "東京都",
    "神奈川県",
    "埼玉県",
    "千葉県"
  ],
  "hasOfferCatalog": {
    "@type": "OfferCatalog",
    "name": "SEOサービス一覧",
    "itemListElement": [
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "SEO診断サービス"
        },
        "price": "50000",
        "priceCurrency": "JPY"
      },
      {
        "@type": "Offer",
        "itemOffered": {
          "@type": "Service",
          "name": "継続SEOコンサルティング"
        },
        "price": "150000",
        "priceCurrency": "JPY",
        "priceSpecification": {
          "@type": "UnitPriceSpecification",
          "price": "150000",
          "priceCurrency": "JPY",
          "unitText": "monthly"
        }
      }
    ]
  },
  "category": "デジタルマーケティング",
  "serviceType": "コンサルティング",
  "audience": {
    "@type": "BusinessAudience",
    "audienceType": "中小企業"
  }
}

{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "name": "構造化データ実装ガイド",
  "description": "Schema.orgを使った構造化データの実装方法を詳しく解説",
  "url": "https://example.com/seo/structured-data-guide",
  "inLanguage": "ja-JP",
  "isPartOf": {
    "@type": "WebSite",
    "name": "SEO専門メディア",
    "url": "https://example.com"
  },
  "about": {
    "@type": "Thing",
    "name": "構造化データ",
    "description": "検索エンジンがWebページの内容を理解しやすくするデータ形式"
  },
  "audience": {
    "@type": "Audience",
    "audienceType": "Webマーケター"
  },
  "datePublished": "2024-01-01",
  "dateModified": "2024-01-15",
  "author": {
    "@type": "Person",
    "name": "田中太郎"
  },
  "publisher": {
    "@type": "Organization",
    "name": "SEO専門メディア"
  },
  "breadcrumb": {
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "ホーム",
        "item": "https://example.com"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "SEOガイド",
        "item": "https://example.com/seo"
      },
      {
        "@type": "ListItem",
        "position": 3,
        "name": "構造化データ"
      }
    ]
  }
}

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "SEOガイド",
  "datePublished": "2024-01-01"
  // authorが不足
}

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "SEOガイド",
  "datePublished": "2024-01-01",
  "author": {
    "@type": "Person",
    "name": "田中太郎"
  }
}

<!-- 最適化された構造化データ実装例 -->
<script type="application/ld+json" defer>
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "構造化データ最適化ガイド",
  "author": {"@type": "Person", "name": "田中太郎"},
  "datePublished": "2024-01-01",
  "image": "https://cdn.example.com/optimized-image.webp",
  "publisher": {
    "@type": "Organization",
    "name": "SEOメディア",
    "logo": "https://cdn.example.com/logo.webp"
  }
}
</script>

<!-- 条件分岐による動的最適化 -->
<script>
// 必要な場合のみ詳細なスキーマを追加
if (window.innerWidth > 768 && 'IntersectionObserver' in window) {
  // デスクトップかつモダンブラウザの場合のみ
  // より詳細な構造化データを追加
}
</script>

// 良い例：ページ内容と一致した正確な情報
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "SEOコンサルティングサービス",
  "description": "専門家による包括的なSEO改善サービス",
  "offers": {
    "@type": "Offer",
    "price": "150000",
    "priceCurrency": "JPY",
    "availability": "https://schema.org/InStock",
    "priceValidUntil": "2024-12-31"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "23"
  }
}

// 悪い例：不正確な情報
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "SEOコンサルティングサービス",
  "offers": {
    "@type": "Offer",
    "price": "1000",
    "priceCurrency": "JPY"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "5.0",
    "reviewCount": "100"
  }
}

// 構造化データ品質監視スクリプト
class StructuredDataQualityMonitor {
  constructor() {
    this.checks = [
      this.validateRequiredFields,
      this.checkDataConsistency,
      this.verifyImageAccess,
      this.validateDateFormats,
      this.checkUrlValidity
    ];
  }

  async runQualityCheck(url) {
    const pageData = await this.fetchPageData(url);
    const structuredData = this.extractStructuredData(pageData);
    const results = [];

    for (const schema of structuredData) {
      const checkResult = await this.runChecks(schema);
      results.push({
        url: url,
        schemaType: schema['@type'],
        issues: checkResult.issues,
        score: this.calculateQualityScore(checkResult)
      });
    }

    return results;
  }

  validateRequiredFields(schema) {
    const requiredFields = this.getRequiredFields(schema['@type']);
    const missingFields = requiredFields.filter(field => !schema[field]);

    return {
      type: 'required_fields',
      issues: missingFields.map(field => ({
        severity: 'error',
        message: `必須フィールド '${field}' が不足しています`,
        field: field
      }))
    };
  }

  checkDataConsistency(schema) {
    // HTMLコンテンツとの整合性チェック
    const htmlContent = this.getPageContent();
    const issues = [];

    if (schema['@type'] === 'Article') {
      const pageTitle = document.querySelector('h1')?.textContent;
      if (pageTitle && pageTitle !== schema.headline) {
        issues.push({
          severity: 'warning',
          message: 'H1タグと構造化データのheadlineが一致しません',
          expected: pageTitle,
          actual: schema.headline
        });
      }
    }

    return { type: 'consistency', issues };
  }

  async verifyImageAccess(schema) {
    if (!schema.image) return { type: 'images', issues: [] };

    const images = Array.isArray(schema.image) ? schema.image : [schema.image];
    const issues = [];

    for (const imageUrl of images) {
      try {
        const response = await fetch(imageUrl, { method: 'HEAD' });
        if (!response.ok) {
          issues.push({
            severity: 'error',
            message: `画像にアクセスできません: ${imageUrl}`,
            statusCode: response.status
          });
        }
      } catch (error) {
        issues.push({
          severity: 'error',
          message: `画像の検証に失敗: ${imageUrl}`,
          error: error.message
        });
      }
    }

    return { type: 'images', issues };
  }

  generateQualityReport(results) {
    const report = {
      totalPages: results.length,
      errorCount: 0,
      warningCount: 0,
      averageScore: 0,
      recommendations: []
    };

    results.forEach(result => {
      result.issues.forEach(issue => {
        if (issue.severity === 'error') report.errorCount++;
        if (issue.severity === 'warning') report.warningCount++;
      });
      report.averageScore += result.score;
    });

    report.averageScore /= results.length;

    return report;
  }
}

// 使用例
const monitor = new StructuredDataQualityMonitor();
monitor.runQualityCheck('https://example.com/article')
  .then(results => {
    const report = monitor.generateQualityReport(results);
    console.log('品質レポート:', report);
  });