mcpField
S
schema-markup

schema-markup

github.com/coreyhaines31マーケティング・グロース57.1k55.5k 回インストール1 日前に更新
リポジトリ

schema-markup について

schema-markupは、検索エンジンによるページ内容の理解とリッチリザルトへの対応を支援する構造化データ実装スキルです。正確なJSON-LD、Schemaの種類、公開前の検証を扱います。

主な機能

  1. 01ページに応じたSchema選択
  2. 02JSON-LD実装のガイダンス
  3. 03@graphによる型の併用
  4. 04検証とエラー確認
  5. 05静的サイト・動的サイト・CMSへの実装案内

活用シーン

  1. 01ブログ記事への構造化データ追加
  2. 02製品または組織ページのマークアップ
  3. 03公開前のSchema確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/coreyhaines31/marketingskills --skill schema-markup

インストール後、Claude Code で/schema-markupを入力して読み込まれたか確認します。

同梱ファイルevals/evals.jsonreferences/schema-examples.md

詳細

スキーママークアップ

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

初期評価

まず製品マーケティングのコンテキストを確認してください: .agents/product-marketing-context.md(または古い構成では .claude/product-marketing-context.md)が存在する場合は、質問する前にそれを読んでください。そのコンテキストを使用し、まだカバーされていない情報やこのタスクに固有の情報のみを尋ねてください。

スキーマを実装する前に、以下を理解してください:

  1. ページタイプ - どのような種類のページですか? 主要なコンテンツは何ですか? どのようなリッチリザルトが可能ですか?

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

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

基本原則

1. 正確性を最優先
  • スキーマはページのコンテンツを正確に表現する必要があります
  • 存在しないコンテンツをマークアップしないでください
  • コンテンツが変更されたら更新を保ってください
2. JSON-LD を使用する
  • Google は JSON-LD 形式を推奨しています
  • 実装が容易で保守も簡単です
3. コンテンツに合わせる
  • マークアップは表示されているコンテンツと一致する必要があります
  • スキーマに合わせてコンテンツを作り変えないでください

スキーマタイプ

タイプ用途必須プロパティ
Organization企業のホームページ/会社概要name, url
WebSiteホームページ(検索ボックス)name, url
Articleブログ記事、ニュースheadline, image, datePublished, author
Product製品ページ、商品name, image, offers
SoftwareApplicationSaaS/アプリのページname, offers
FAQPageFAQ コンテンツ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 のドキュメントを確認してください

無効な値 - 日付は ISO 8601、URL は完全修飾、列挙値は正確でなければなりません

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

実装

静的サイト
  • HTML テンプレートに直接 JSON-LD を追加します
  • 再利用可能なスキーマにはインクルード/パーシャルを使用します
動的サイト(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
}
テストチェックリスト
  • リッチリザルトテストで検証済み
  • エラーや警告がない
  • ページコンテンツと一致している
  • すべての必須プロパティが含まれている

タスク固有の質問

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

関連スキル

  • seo-audit: スキーマレビューを含む全体的な SEO 向け
  • ai-seo: AI 検索最適化向け（スキーマは AI がコンテンツを理解するのに役立ちます）
  • programmatic-seo: 大規模なテンプレート化されたスキーマ向け
  • site-architecture: パンくずリスト構造とナビゲーションスキーマの計画向け

コメント

Markdown 対応