schema-markup-generator

スキーママークアップジェネレーター

リッチリザルト、AI による引用、検索での視認性向上のための JSON-LD 構造化データを生成します。

インストール

git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/schema-markup-generator ~/.claude/skills/

使用する場面

• 新規または既存のページに構造化データを追加する
• 特定のスキーマタイプの JSON-LD を生成する
• 既存のスキーマにエラーや不足フィールドがないか監査する
• AI 検索での視認性を高める（aeo-geo-optimizer と併用）
• リッチリザルトを有効にする（FAQ のドロップダウン、星評価、ハウツーの手順）

ワークフロー

ステップ 1：コンテンツタイプを特定する

コンテンツ	主なスキーマ	リッチリザルト
ブログ記事	Article	著者と日付を含む拡張リスティング
FAQ セクション	FAQPage	SERP 上の展開可能な Q&A
チュートリアル	HowTo	画像と所要時間付きの手順
商品ページ	Product	価格、在庫状況、評価
レビュー	Review + Rating	SERP 上の星評価
レシピ	Recipe	調理時間、材料、評価
イベント	Event	日付、場所、チケット情報
地域のビジネス	LocalBusiness	地図、営業時間、連絡先
人物／著者	Person	ナレッジパネル
パンくずリスト	BreadcrumbList	SERP 上のパンくずリスト
動画	VideoObject	動画カルーセル、サムネイル
ソフトウェア	SoftwareApplication	SERP 上のアプリ情報
コース	Course	SERP 上のコース情報
データセット	Dataset	データセットの検索結果

ステップ 2：JSON-LD を生成する

スキーマタイプに必要なすべてのフィールドと推奨フィールドを含む <script type="application/ld+json"> ブロックを生成します。必ず JSON-LD 形式を使用してください（Microdata や RDFa ではなく）。

ステップ 3：検証する

• Google リッチリザルトテスト：https://search.google.com/test/rich-results
• Schema.org バリデーター：https://validator.schema.org/
• Google Search Console で構造化データのエラーを確認する

スキーマテンプレート

Article

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Article Title (max 110 chars)",
  "description": "Brief description of the article",
  "author": {
    "@type": "Person",
    "name": "Author Name",
    "url": "https://example.com/author/name",
    "jobTitle": "Author Title",
    "sameAs": ["https://linkedin.com/in/author", "https://twitter.com/author"]
  },
  "publisher": {
    "@type": "Organization",
    "name": "Publisher Name",
    "logo": {"@type": "ImageObject", "url": "https://example.com/logo.png"}
  },
  "datePublished": "2026-03-18T00:00:00Z",
  "dateModified": "2026-03-18T00:00:00Z",
  "image": "https://example.com/article-image.jpg",
  "mainEntityOfPage": {"@type": "WebPage", "@id": "https://example.com/article-url"}
}

FAQPage

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is the question?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The complete answer text. Can include <a href=url>HTML links</a>."
      }
    }
  ]
}

HowTo

{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "How to Do Something",
  "description": "Brief description",
  "totalTime": "PT30M",
  "estimatedCost": {"@type": "MonetaryAmount", "currency": "USD", "value": "0"},
  "step": [
    {
      "@type": "HowToStep",
      "name": "Step 1 Title",
      "text": "Detailed step instructions",
      "image": "https://example.com/step1.jpg"
    }
  ]
}

Product

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Product Name",
  "description": "Product description",
  "image": "https://example.com/product.jpg",
  "brand": {"@type": "Brand", "name": "Brand Name"},
  "sku": "SKU-12345",
  "offers": {
    "@type": "Offer",
    "price": "29.99",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/product"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.5",
    "reviewCount": "127"
  }
}

BreadcrumbList

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com"},
    {"@type": "ListItem", "position": 2, "name": "Category", "item": "https://example.com/category"},
    {"@type": "ListItem", "position": 3, "name": "Current Page"}
  ]
}

必須フィールドと推奨フィールド

スキーマタイプ	必須フィールド	推奨フィールド
Article	headline, author, datePublished, image	dateModified, publisher, description
FAQPage	mainEntity (Question + Answer)	—
HowTo	name, step	totalTime, estimatedCost, image
Product	name, offers (price + currency + availability)	brand, sku, aggregateRating, image
LocalBusiness	name, address	phone, hours, geo, image, priceRange
Event	name, startDate, location	endDate, offers, image, performer
Person	name	jobTitle, url, sameAs, image

よくある間違い

1. 必須フィールドが不足している — タイプごとの要件を必ず確認する
2. 日付形式が正しくない — ISO 8601（YYYY-MM-DDTHH:MM:SSZ）を使用する
3. マークアップが表示コンテンツと一致していない — スキーマにはユーザーに見える内容を反映する必要があります
4. JSON-LD ではなく Microdata を使用している — Google は JSON-LD を推奨しています
5. 入れ子構造のエラー — デプロイ前に JSON 構文を検証する
6. スキーマの重複 — ページごとにタイプごとのスキーマブロックを 1 つにする
7. Organization の自己参照 — publisher はページではなく組織にする

他のスキルとの連携

• aeo-geo-optimizer — スキーマは AEO の重要なシグナルです。AEO 監査で推奨されたタイプを実装します
• technical-seo-audit — 監査で不足または破損しているスキーマを特定し、このスキルで修正内容を生成します
• seo-content-writer — コンテンツ構造をスキーマ構造に合わせる必要があります