スキーママークアップの分析と生成

検出

1. ページソースから JSON-LD <script type="application/ld+json"> をスキャン
2. Microdata (itemscope, itemprop) をチェック
3. RDFa (typeof, property) をチェック
4. 常に JSON-LD をプライマリフォーマットとして推奨（Google公式の推奨）

検証

• スキーマタイプごとの必須プロパティをチェック
• Googleがサポートするリッチリザルトタイプに対して検証
• 一般的なエラーをテスト：
  • @context の欠落
  • @type の無効
  • データ型の不正
  • プレースホルダーテキスト
  • 相対URL（絶対URLであるべき）
  • 無効な日付フォーマット
• 非推奨タイプにフラグを立てる（下記参照）

スキーマタイプステータス（2026年2月時点）

詳細なリストは references/schema-types.md を参照してください。主なルール：

ACTIVE（自由に推奨）：

Organization、LocalBusiness、SoftwareApplication、WebApplication、Product（2025年4月時点でCertification markupを含む）、ProductGroup、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting

VIDEO & SPECIALIZED（自由に推奨）：

BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode

schema/templates.json でこれらのタイプ用の使用可能なJSON-LDテンプレートを参照してください。

JSON-LD と JavaScript レンダリング： Google の2025年12月のJS SEOガイダンスに従い、JavaScriptを介して挿入された構造化データは処理の遅延に直面する可能性があります。特にProduct、Offerなど時間的に重要なマークアップの場合は、初期サーバーレンダリングHTML内にJSON-LDを含めてください。

RESTRICTED（特定のサイトのみ）：

• FAQ：ONLY 政府機関およびヘルスケア当局サイト（2023年8月に制限）

DEPRECATED（決して推奨しないこと）：

• HowTo：リッチリザルト 2023年9月に削除
• SpecialAnnouncement：2025年7月31日に非推奨化
• CourseInfo、EstimatedSalary、LearningVideo：2025年6月に廃止
• ClaimReview：2025年6月にリッチリザルトから廃止
• VehicleListing：2025年6月にリッチリザルトから廃止
• Practice Problem：2025年後期にリッチリザルトから廃止
• Dataset：2025年後期にリッチリザルトから廃止
• Book Actions：非推奨化後に反転、2026年2月時点では機能可能（歴史的注記）

生成

ページのスキーマを生成する場合：

1. コンテンツ分析からページタイプを特定
2. 適切なスキーマタイプを選択
3. すべての必須プロパティと推奨プロパティを含む有効なJSON-LDを生成
4. 真実で検証可能なデータのみを含める。ユーザーが入力するプレースホルダーを明確にマーク
5. 表示前に出力を検証

一般的なスキーマテンプレート

Organization

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "[Company Name]",
  "url": "[Website URL]",
  "logo": "[Logo URL]",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "[Phone]",
    "contactType": "customer service"
  },
  "sameAs": [
    "[Facebook URL]",
    "[LinkedIn URL]",
    "[Twitter URL]"
  ]
}

LocalBusiness

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "[Business Name]",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "[Street]",
    "addressLocality": "[City]",
    "addressRegion": "[State]",
    "postalCode": "[ZIP]",
    "addressCountry": "US"
  },
  "telephone": "[Phone]",
  "openingHours": "Mo-Fr 09:00-17:00",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": "[Lat]",
    "longitude": "[Long]"
  }
}

Article/BlogPosting

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "[Title]",
  "author": {
    "@type": "Person",
    "name": "[Author Name]"
  },
  "datePublished": "[YYYY-MM-DD]",
  "dateModified": "[YYYY-MM-DD]",
  "image": "[Image URL]",
  "publisher": {
    "@type": "Organization",
    "name": "[Publisher]",
    "logo": {
      "@type": "ImageObject",
      "url": "[Logo URL]"
    }
  }
}

出力

• SCHEMA-REPORT.md：検出と検証の結果
• generated-schema.json：すぐに使用できるJSON-LDスニペット

検証結果

スキーマ	タイプ	ステータス	問題
...	...	✅/⚠️/❌	...

推奨事項

• 欠落しているスキーマの機会
• 必要な検証修正
• 実装用の生成されたコード

エラーハンドリング

シナリオ	アクション
URLに到達不可	ステータスコード付きの接続エラーを報告。URLの確認とページが認証を必要とするかどうかの確認を提案。
スキーママークアップが見つからない	JSON-LD、Microdata、RDFaが検出されなかったことを報告。ページコンテンツ分析に基づいて適切なスキーマタイプを推奨。
無効なJSON-LD構文	特定の構文エラー（欠落している括弧、末尾のカンマ、引用符なしキー）を解析して報告。修正されたJSON-LD出力を提供。
非推奨のスキーマタイプが検出された	廃止日付付きで非推奨タイプにフラグを立てる。現在の置換タイプを推奨するか、置換がない場合は削除を助言。