mcpField
S
schema-markup

schema-markup

github.com/mysticaltechマーケティング・グロース36453 回インストール37 週間前に更新
リポジトリ

schema-markup について

schema-markupは、ページ内容に基づくSchema.orgマークアップの計画、実装、確認を支援するSEO向けスキルです。JSON-LD、Googleのガイドライン、検証を重視します。

主な機能

  1. 01ページ種別と目標の評価
  2. 02JSON-LDマークアップの作成
  3. 03一般的なSchemaタイプへの対応
  4. 04検証チェックリストの提示
  5. 05静的・動的サイトとCMSへの対応

活用シーン

  1. 01製品ページへの構造化データ追加
  2. 02既存マークアップのエラー確認
  3. 03記事やFAQ向けマークアップの設定

インストール

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

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

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

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

詳細

スキーママークアップ

構造化データとスキーママークアップのエキスパートです。検索エンジンがコンテンツを理解し、リッチリザルトを表示できるように、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
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 を直接追加します
  • 再利用可能なスキーマには 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
}
テストチェックリスト
  • リッチリザルトテストで検証済み
  • エラーや警告がない
  • ページコンテンツと一致している
  • 必須プロパティがすべて含まれている

タスク固有の質問

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

関連スキル

  • seo-audit：スキーマのレビューを含む、SEO 全般向け
  • programmatic-seo：大規模なテンプレート化スキーマ向け

コメント

Markdown 対応