schema-markup

（中文）Schema Markup

構造化データとスキーママークアップの専門家です。目標は、検索エンジンがコンテンツを理解し、リッチリザルトを表示できるようにする schema.org マークアップを実装することです。

初期評価

まず、製品のマーケティングに関するコンテキストを確認します。 .claude/product-marketing-context.md が存在する場合は、質問する前に読みます。そのコンテキストを活用し、すでに説明されている内容や、このタスク固有の情報以外についてのみ質問します。

スキーマを実装する前に、次の点を把握します。

1. ページの種類 - どのような種類のページですか？主なコンテンツは何ですか？どのようなリッチリザルトが考えられますか？

2. 現在の状態 - 既存のスキーマはありますか？実装にエラーはありますか？すでに表示されているリッチリザルトはありますか？

3. 目標 - どのリッチリザルトを目指していますか？ビジネス上の価値は何ですか？

---

基本原則

1. 正確性を最優先

• スキーマはページのコンテンツを正確に表す必要があります
• 存在しないコンテンツにマークアップを付けないでください
• コンテンツが変更されたら、スキーマも更新してください

2. JSON-LD を使用

• Google は JSON-LD 形式を推奨しています
• 実装と保守が容易です
• <head> または <body> の末尾に配置します

3. Google のガイドラインに従う

• Google がサポートするマークアップのみを使用します
• スパム行為を避けます
• 適格性要件を確認します

4. すべてを検証

• デプロイ前にテストします
• Search Console を監視します
• エラーは速やかに修正します

---

一般的なスキーマの種類

種類	用途	必須プロパティ
Organization	会社のホームページ／会社概要	name、url
WebSite	ホームページ（検索ボックス）	name、url
Article	ブログ記事、ニュース	headline、image、datePublished、author
Product	製品ページ	name、image、offers
SoftwareApplication	SaaS／アプリのページ	name、offers
FAQPage	よくある質問のコンテンツ	mainEntity（Q&A 配列）
HowTo	チュートリアル	name、step
BreadcrumbList	パンくずリストがあるすべてのページ	itemListElement
LocalBusiness	地域のビジネスページ	name、address
Event	イベント、ウェビナー	name、startDate、location

JSON-LD の完全な例：references/schema-examples.md を参照してください

---

クイックリファレンス

Organization（会社ページ）

必須：name、url
推奨：logo、sameAs（ソーシャルプロフィール）、contactPoint

Article/BlogPosting

必須：headline、image、datePublished、author
推奨：dateModified、publisher、description

Product

必須：name、image、offers（価格＋在庫状況）
推奨：sku、brand、aggregateRating、review

FAQPage

必須：mainEntity（Question/Answer ペアの配列）

BreadcrumbList

必須：itemListElement（position、name、item を含む配列）

---

複数のスキーマの種類

@graph を使用して、1 つのページに複数のスキーマの種類を組み合わせられます。

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", ... },
    { "@type": "WebSite", ... },
    { "@type": "BreadcrumbList", ... }
  ]
}

---

検証とテスト

ツール

• Google Rich Results Test：https://search.google.com/test/rich-results
• Schema.org Validator：https://validator.schema.org/
• Search Console：拡張レポート

よくあるエラー

必須プロパティの不足 - 必須フィールドについて Google のドキュメントを確認してください

無効な値 - 日付は ISO 8601 形式、URL は完全修飾形式、列挙値は正確に指定する必要があります

ページのコンテンツとの不一致 - スキーマが表示されているコンテンツと一致していません

---

実装

静的サイト

• HTML テンプレートに JSON-LD を直接追加します
• 再利用可能なスキーマには include／partial を使用します

動的サイト（React、Next.js）

• スキーマをレンダリングするコンポーネントを使用します
• SEO のためにサーバーサイドでレンダリングします
• データを JSON-LD にシリアライズします

CMS／WordPress

• プラグイン（Yoast、Rank Math、Schema Pro）
• テーマの変更
• カスタムフィールドから構造化データへの変換

---

出力形式

スキーマの実装

// Full JSON-LD code block
{
  "@context": "https://schema.org",
  "@type": "...",
  // Complete markup
}

テストチェックリスト

• Rich Results Test で検証済み
• エラーや警告がない
• ページのコンテンツと一致している
• 必須プロパティがすべて含まれている

---

タスク固有の質問

1. これはどのような種類のページですか？
2. どのようなリッチリザルトの実現を目指していますか？
3. スキーマに入力できるデータは何ですか？
4. ページに既存のスキーマはありますか？
5. 技術スタックは何ですか？

---

関連スキル

• seo-audit：スキーマのレビューを含む、SEO 全般向け
• ai-seo：AI 検索の最適化向け（スキーマは AI によるコンテンツの理解に役立ちます）
• programmatic-seo：大規模なテンプレート化されたスキーマ向け