seo-metadata-audit について
seo-metadata-audit は、Webページの SEO メタデータを点検し、優先順位付きの修正案を作るスキルです。SEO担当者、開発者、創業者、コンテンツチーム向けに、検索スニペット、インデックス、モバイル、構造化データ、SNS表示をまとめて確認します。
主な機能
- 01タイトル、説明文、見出し階層の確認
- 02robotsとcanonicalの点検
- 03altテキスト、viewport、文字コードの確認
- 04schemaとSNSプレビュー用メタデータの評価
- 05影響とリスクに基づく修正の優先付け
活用シーン
- 01WebページのSEOメタデータ監査
- 02タイトルと説明文の改善
- 03インデックスやcanonicalの問題調査
- 04ページ向けschemaとSNSタグの計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ simbajigege/ book2skills --skill seo-metadata-auditインストール後、Claude Code で/seo-metadata-auditを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSE.txtREADME.mdquotes/seo-metadata-quotes.mdseo-technical-quotes.mdreferences/seo_10_meta_tags.mdtag-reference.md詳細
SEO メタデータ監査スキル
知識ソース: 哥飞による「SEOで最も重要な10個のメタデータ」。
概要
このスキルを使用して、Webページの最も重要なSEOメタデータを監査し、優先順位を付けた修正計画を作成します。検索エンジンに対して、ページの内容が明確で、クロール可能であり、正規化され、モバイルフレンドリーで、構造化されたシグナルを伝えているかを診断したいSEO担当者、開発者、創業者、コンテンツチームを支援します。
このスキルを使用する場面
ユーザーがURL、HTML、ページ仕様、またはメタデータ一覧を提示し、次のように尋ねた場合に使用します。
- 「このページのSEOメタデータを監査してください。」
- 「タイトルと説明文は適切ですか?」
- 「canonical、robots、schema、またはOpen Graphタグは必要ですか?」
- 「このページが検索順位に反映されない、または正しく表示されないのはなぜですか?」
- 「このページのメタデータを作成してください。」
基本原則
SEOメタデータは一体となって機能します。それぞれのタグが、ページの内容、検索エンジンがページを処理する方法、検索結果やソーシャルメディアでのユーザーへの表示方法を明確にします。クロール可能性、正規化、モバイル表示、または意味構造を損なうような最適化は避けてください。
ワークフロー一覧
| ワークフロー | ユーザーの質問パターン | 入力 | 手順 | 出力 | 独立したトリガーか? | 個別の参考資料があるか? | トリアージスコア | サブスキルにすべきか? | 理由 |
|---|---|---|---|---|---|---|---|---|---|
| メタデータ全体の監査 | 「このページを監査してください」 | URL/HTML、ターゲットキーワード、ページの目的 | すべてのタグ群を確認し、問題に優先順位を付ける | 優先度付きの問題一覧表 | はい | はい | 3 | いいえ | 中核となるワークフローです。すべてのタグが相互に影響します。 |
| スニペットの最適化 | 「タイトル/説明文を修正してください」 | タイトル、説明文、キーワード、検索意図 | 長さ、独自性、クリック価値を確認する | 書き換え案 | はい | はい | 3 | いいえ | 範囲は狭いものの、同じメタデータ評価を使用します。 |
| クロールとインデックスの制御 | 「このページはインデックス登録すべきですか?」 | ページの役割、重複ページ、robots/canonical | インデックス登録、リンクの追跡、canonicalを判断する | インデックス登録の指示案 | はい | はい | 3 | いいえ | 出力が監査計画に組み込まれるため、単一ファイルにまとめています。 |
| 構造化データ/ソーシャルプレビュー | 「schema/Open Graphを追加してください」 | ページの種類、エンティティデータ、ソーシャルプレビュー | schemaとOG/Twitterタグを選ぶ | マークアップのチェックリスト | はい | はい | 3 | いいえ | 入力と修正レポートが同じです。 |
アーキテクチャの根拠
メタデータタグは個別に確認できますが、問題は相互作用から生じることがよくあります。canonicalはインデックス登録の意図を上書きすることがあり、タイトルはスニペットとの関連性に影響し、見出しとschemaは意味の明確さに影響し、viewportはモバイル表示に影響します。1つの監査スキルにまとめることで、これらの依存関係を把握しやすくなります。
ディメンション1:関連性とスニペットのシグナル
ルール: タイトル、説明文、見出しは、キーワードを詰め込まずに、ページのトピックと検索意図を明確に伝える必要があります。
確認する主な質問:
- タイトルは独自性があり、簡潔で、キーワードとの関連性がありますか?
- 説明文は自然な表現でクリック率の向上に役立ちますか?
- 明確なH1が1つあり、H2〜H6が論理的な階層になっていますか?
判断基準/チェックリスト:
- 可能であれば、タイトルは50~60文字程度にします。
- 可能であれば、説明文は150~160文字程度にします。
- ページの検索意図に合ったH1を1つにします。
- 見出しはテキストを視覚的に装飾するのではなく、ページを構造化するために使用します。
警告シグナル:
- ページ間でタイトルが重複している。
- タイトルまたは説明文にキーワードが詰め込まれている。
- H1がない、または複数のH1があり内容が分かりにくい。
エージェントへの指示:
ユーザーがHTMLまたはメタデータを共有した場合、検索エンジンの理解とユーザーのクリック行動の両方を左右するため、最初にスニペットのシグナルを監査してください。
ディメンション2:クロール、インデックス登録、canonicalの制御
ルール: robotsタグとcanonicalタグは、どのURLをインデックス登録し、評価を集約すべきかを検索エンジンに伝える必要があります。
確認する主な質問:
- このページはインデックス登録すべきですか?
- canonicalは本来優先すべきURLを指していますか?
- 重複ページやパラメーター付きページは正しく集約されていますか?
- 重要なページが誤ってブロックされていませんか?
判断基準/チェックリスト:
- robots メタタグがページのビジネス上の役割に合っています。
- canonical が正しいURL、または優先する同等のURLを指しています。
- nofollow は、信頼できないリンク、有料リンク、ユーザー生成リンクに限定されています。
- インデックス制御が誤って全体に適用されていません。
警告サイン:
- すべてのページの canonical がホームページを指しています。
- 重要なページに noindex が指定されています。
- 内部リンクに nofollow が無差別に使われています。
エージェントへの指示:
インデックス登録に関する質問では、まず望ましい検索エンジンの動作を示し、その動作に合うよう robots と canonical のディレクティブを選択してください。
ディメンション 3:メディア、モバイル、エンコーディングの基盤
原則: 検索エンジンとユーザーには、アクセス可能な画像、モバイルでの表示、正しい文字の解釈が必要です。
確認すべき主な質問:
- 意味のある画像に、内容を説明する alt テキストが付いていますか?
- レスポンシブなモバイル表示のために viewport が設定されていますか?
- charset は正しく宣言されていますか?
判断基準/チェックリスト:
- alt は画像の内容または機能を自然に説明しています。
- viewport にレスポンシブな幅とスケールの設定が含まれています。
- charset は文書の早い段階で宣言され、文書と一致しています。
警告サイン:
- 情報を伝える画像の alt が空です。
- モバイル向けページに viewport がありません。
- エンコーディングの問題により、スニペットやコンテンツの表示が崩れています。
エージェントへの指示:
技術メタデータを監査するときは、ユーザーの当初の関心事でなくても、これらを基盤に関わる問題として指摘してください。
ディメンション 4:構造化データとソーシャルコンテキスト
原則: スキーマとソーシャルメタデータは、機械やプラットフォームがページを理解、分類し、プレビューするのに役立ちます。
確認すべき主な質問:
- このページに適したスキーマタイプは何ですか?
- 必須の構造化データ項目は正確にそろっていますか?
- Open Graph やソーシャルタグは、意図した共有プレビューと一致していますか?
判断基準/チェックリスト:
- スキーマがページの種類と、ページ上に表示されているコンテンツに一致しています。
- 構造化データは正確で、スパム的ではありません。
- ソーシャルタイトル、説明、画像が意図的に設定されています。
警告サイン:
- スキーマが、ページ上に表示されていないコンテンツを主張しています。
- ソーシャル画像がない、またはプレビュー文言が一致していません。
- ページ単位の目的がないまま構造化データが追加されています。
エージェントへの指示:
ページの種類、エンティティ、ユーザーの意図を特定してから、スキーマやソーシャルタグを推奨してください。
クエリ応答フレームワーク
クエリタイプ 1:SEO メタデータ全体の監査
- ページの目的とターゲットとする検索意図を特定します。
- 関連性、クロール/インデックス、技術的な基盤、構造化データ/ソーシャルコンテキストを監査します。
- 検索への影響と実装リスクに基づいて問題に優先順位を付けます。
- 修正したタグの例を提示します。
クエリタイプ 2:メタデータの生成
- 不足している場合は、ページの目的、主要キーワード、ブランド、canonical URL、ページタイプ、ロケールを確認します。
- title、description、canonical、robots、OG、Twitter、viewport、charset、スキーマに関する推奨案を作成します。
- 各タグを含める、または省略する理由を説明します。
クエリタイプ 3:ランキング/インデックスの問題を診断
- まずインデックス登録の適格性と canonical を確認します。
- 次に title、見出し、コンテンツの整合性、スキーマを調べます。
- メタデータの問題と、より広範なコンテンツ、権威性、技術的な SEO の問題を切り分けます。
出力形式
## SEO Metadata Audit
**Page:** ...
**Verdict:** Healthy / Needs fixes / Indexing risk / Snippet weak
| Tag / Signal | Status | Issue | Recommended Fix | Priority |
|---|---|---|---|---|
## Corrected Metadata
```html
...
実装メモ
- ...
参考資料
- ...
## Critical Reminders
1. Title is important, but metadata is a system.
2. Description influences clicks even when it is not a direct ranking factor.
3. Canonical errors can erase good content from search visibility.
4. Do not block important pages accidentally.
5. Schema must describe real visible content.
## CITATION RULES
Every substantive metadata recommendation must include a citation to the source quote files.
**Quote files:**
- `seo-metadata-quotes.md` — strategy, title, description, H1, alt, nofollow, canonical, and canonical mistakes.
- `seo-technical-quotes.md` — technical tag details, robots, viewport, charset, Open Graph, and schema markup.
**Citation format:**
> "Author's exact words here."
>
> — [*影响SEO最重要的10个metadata*, cited excerpt](https://github.com/simbajigege/book2skills/blob/main/skills/seo-metadata-audit/quotes/FILENAME.md#ANCHOR)
**Anchor mapping:**
- `seo-metadata-quotes.md`: `#comprehensive-strategy`, `#title-importance`, `#title-keyword-ranking`, `#semantic-matching`, `#description-click-rate`, `#h1-essential`, `#alt-for-image-search`, `#nofollow-weight`, `#canonical-weight-aggregation`, `#canonical-mistake`
- `seo-technical-quotes.md`: `#comprehensive-seo-strategy`, `#title-length-importance`, `#title-brand-position`, `#description-length`, `#heading-hierarchy`, `#alt-description-best-practice`, `#nofollow-evolution`, `#robots-meta-control`, `#canonical-purpose`, `#viewport-mobile`, `#charset-encoding`, `#open-graph-social`, `#schema-markup`
**Rules:**
- Cite the closest tag-specific anchor for each major recommendation.
- If auditing a real page, distinguish observed defects from general best practice.
- Do not invent quote text; use exact quote files only.