seo-schema

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

共有データキャッシュ

ステップ 0 -- 共有データキャッシュを確認します：

情報を収集する前に、関連する SEO スキルの再利用可能なコンテキストが .seo-cache/ にあるか確認します。 参照先：スキーマと依存関係マップについては、../seo/references/shared-data-cache.md を参照してください。

次のキャッシュファイルが存在する場合は確認します：

• .seo-cache/site-meta.json：ドメイン、ビジネスタイプ、業界、クロールコンテキスト

• .seo-cache/audit-scores.json：過去の全体監査での優先事項

• .seo-cache/pages/{url-slug}/page-analysis.json：URL が指定されている場合のページレベルのコンテキスト

• 見つかった場合：明らかに有効なフィールドを解析して使用します（「[日付] の [X] をキャッシュから使用」と記録します）

• ファイルがない、破損している、または無関係な場合：新たな証拠を使って続行します

• ユーザーが「refresh」または「re-run」と指定した場合：キャッシュの読み取りを無視し、書き込み時に上書きします

検出

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 を参照してください。主なルールは次のとおりです：

有効（自由に推奨できます）：

Organization、LocalBusiness、SoftwareApplication、WebApplication、Product（2025 年 4 月時点で Certification マークアップに対応）、ProductGroup、Offer、Service、Article、BlogPosting、NewsArticle、Review、AggregateRating、BreadcrumbList、WebSite、WebPage、Person、ProfilePage、ContactPage、VideoObject、ImageObject、Event、JobPosting、Course、DiscussionForumPosting

動画・専門タイプ（自由に推奨できます）：

BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode

すぐに使えるこれらのタイプの JSON-LD テンプレートについては schema/templates.json を参照してください。

JSON-LD と JavaScript レンダリング： Google の 2025 年 12 月の JS SEO ガイダンスによると、JavaScript 経由で挿入される構造化データは、処理が遅れる場合があります。時間的制約のあるマークアップ（特に Product、Offer）では、初回のサーバー側レンダリング HTML に JSON-LD を含めてください。

制限付き（特定のサイトのみ）：

• FAQ：政府機関および医療機関のサイトのみ（2023 年 8 月に制限）

非推奨（推奨しないでください）：

• 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 を提示します。
非推奨のスキーマタイプが検出された	非推奨のタイプと廃止日を示します。現在の代替タイプを推奨するか、代替タイプがない場合は削除を提案します。

共有データキャッシュへの書き込み

すべての作業が完了した後、ワークフローで永続的に保存する価値のある調査結果が得られた場合は、簡潔な JSON サマリーを .seo-cache/ に書き込みます。 ../seo/references/shared-data-cache.md のスキーマと命名規則を使用します。少なくとも cache_type、analyzed_at、ソース URL／ドメイン、主な調査結果、問題点、推奨事項、ツールの制限事項を含めてください。.gitignore に .seo-cache/ の記載がない場合は追加します。