seo-schema について
seo-schemaは、ウェブページの構造化データを検出・検証・生成するスキルです。SEO担当者がSchemaの問題を特定し、ページ内容に応じたJSON-LDを作成できるよう、対応済み・非推奨のタイプも案内します。
主な機能
- 01JSON-LD・Microdata・RDFaの検出
- 02Schemaのプロパティと構文の検証
- 03ページ種別に応じたJSON-LD生成
- 04非推奨Schemaタイプの警告
- 05レポートと実装用コードの出力
活用シーン
- 01ウェブページの構造化データ監査
- 02無効または不完全なSchemaの修正
- 03ページ内容に基づくJSON-LD生成
- 04Schemaタイプの対応状況の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/seo-schemaを入力して読み込まれたか確認します。
同梱ファイルreferences/deprecated-types-2024-2026.md
詳細
スキーママークアップの分析と生成
検出
- ページソースをスキャンして、JSON-LD の
<script type="application/ld+json">を探します - Microdata（
itemscope、itemprop）を確認します - RDFa（
typeof、property）を確認します - 主要な形式として、常に 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
動画・専門分野（自由に推奨）：
BroadcastEvent、Clip、SeekToAction、SoftwareSourceCode
これらのタイプですぐに使える JSON-LD テンプレートは schema/templates.json を参照してください。
JSON-LD と JavaScript によるレンダリング： Google の2025年12月の JavaScript 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月現在も利用可能（経緯に関する注記）
生成
ページのスキーマを生成する場合：
- コンテンツ分析からページのタイプを特定します
- 適切なスキーマタイプを選択します
- 必須プロパティと推奨プロパティをすべて含む、有効な JSON-LD を生成します
- 真実で検証可能なデータのみを含めます。ユーザーが入力するプレースホルダーは明確に示します
- 提示する前に出力を検証します
よく使われるスキーマテンプレート
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 を提示します。 |
| 非推奨のスキーマタイプが検出された | 非推奨のタイプと廃止日を示します。現在の代替タイプを推奨するか、代替がない場合は削除を提案します。 |