mcpField
3
30x-seo-schema

30x-seo-schema

github.com/norahe0304-artマーケティング・グロース5663 回インストール33 週間前に更新
リポジトリ

30x-seo-schema について

30x-seo-schemaは、ウェブページの構造化データを検出、検証、生成するスキルです。対応するスキーマタイプを確認し、レポートと実装用のJSON-LDを出力します。

主な機能

  1. 01JSON-LD、Microdata、RDFaの検出
  2. 02プロパティと値の検証
  3. 03リッチリザルト対応とタイプ状況の確認
  4. 04JSON-LDマークアップの生成
  5. 05結果と修正案のレポート

活用シーン

  1. 01既存ページの構造化データ監査
  2. 02不正または不完全なマークアップの修正
  3. 03ページへの適切な構造化データの追加

インストール

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

$npx skills add https://github.com/norahe0304-art/30x-seo --skill 30x-seo-schema

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

詳細

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

検出

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

スキーマタイプのステータス（2026年2月時点）

全リストは references/schema-types.md をご覧ください。主なルール：

ACTIVE — 制限なく推奨できます：

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

VIDEO & SPECIALIZED — 制限なく推奨できます：

BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode

これらのタイプですぐに使える JSON-LD テンプレートは schema/templates.json をご覧ください。

JSON-LD と JavaScript レンダリング： Google の2025年12月の JS SEO ガイダンスによると、JavaScript 経由で挿入された構造化データは、処理が遅れる可能性があります。時間的制約のあるマークアップ（特に Product、Offer）では、初回のサーバーサイドレンダリング HTML に JSON-LD を含めてください。

RESTRICTED — 特定のサイトでのみ使用できます：
  • FAQ：政府機関および医療機関のサイトのみ（2023年8月に制限）
DEPRECATED — 推奨しないでください：
  • 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 スニペット
検証結果
スキーマタイプステータス問題
......✅/⚠️/❌...
推奨事項
  • スキーマを追加できる箇所
  • 必要な検証修正
  • 実装用の生成コード

[PROTOCOL]: 変更時はこのヘッダーを更新し、その後 CLAUDE.md を確認してください

コメント

Markdown 対応