mcpField
S
seo-schema

seo-schema

github.com/sickn33マーケティング・グロース48.9k92 回インストール今日更新
リポジトリ

seo-schema について

Schema.org構造化データ、特にJSON-LDの分析、検証、生成を行うスキルです。Schema中心のSEO作業を対象とし、語彙の有効性とGoogleリッチリザルトの適格性を区別します。

主な機能

  1. 01JSON-LD、Microdata、RDFaを検出
  2. 02プロパティと一般的なエラーを検証
  3. 03事実に基づくJSON-LDを生成
  4. 04リッチリザルト適格性と型の状態を確認
  5. 05Schemaレポートと推奨事項を作成

活用シーン

  1. 01Webページの構造化データを監査
  2. 02実装前にJSON-LDを検証
  3. 03ページ内容に合うSchemaマークアップを追加

インストール

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

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill seo-schema

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

詳細

補足資料の利用可否

このカタログのコピーには、以下のインラインガイダンスが含まれていますが、次の補足パスは含まれていません。これらは外部の前提条件であり、同梱ファイルではありません。

  • <support-root>/references/schema-types.md

必要な資料は、宣言された上流ソースまたはそのソースをユーザーがインストールしたものから取得してください。各パスをそのインストール先からの相対パスとして解決し、内容を確認して、該当するライセンスと実行上の前提条件を検証してください。必要なファイルが存在することを確認するまでは、コマンドを実行したり、参照先の手順に従ったと主張したりしないでください。不足しているスクリプトを捏造したり、同じ名前の無関係なファイルを同等のものとして扱ったりしないでください。ここに完全に記載された独立した手順は、ユーザーが許可した範囲内で実施できます。依存する手順が実施できない場合は、その旨を報告してください。

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

使用するタイミング

  • Schema.org の構造化データを検出、検証、生成する場合に使用します。
  • JSON-LD、リッチリザルト、またはマークアップの機会についてユーザーから質問された場合に使用します。
  • より広範な SEO 監査ではなく、スキーマの検証が主なタスクである場合に使用します。

検出

  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 にする必要があります）
    • 日付形式の誤り
  • 非推奨のタイプにフラグを付けます（下記参照）。

スキーマタイプのステータス（過去の時点でのスナップショット。使用前に確認してください）

Schema.org の語彙として有効であることと、Google のリッチリザルトの対象となることは別です。Google の結果機能が終了しても、Schema.org のタイプが無効になるわけではありません。真実を反映したマークアップを削除する前に、実際の検索結果での表示対象について、最新の公式ドキュメントを確認してください。schema/templates.json は同梱されていません。

全リストは 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）では、JSON-LD を初回のサーバーレンダリング済み HTML に含めてください。

制限付き（特定のサイトのみ）：
  • FAQ：政府機関および医療機関のサイトのみ（2023 年 8 月に制限）
Google リッチリザルトの過去の終了（語彙としての無効化ではありません）：
  • 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 出力を提示します。
非推奨のスキーマタイプが検出された非推奨のタイプと廃止日を示します。現在の代替タイプを推奨するか、代替がない場合は削除を提案します。

制限事項

  • タスクが上記の範囲に明確に該当する場合に限り、このスキルを使用してください。
  • 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中止して確認を求めてください。

コメント

Markdown 対応