mcpField
S
site-architecture

site-architecture

github.com/borgheiマーケティング・グロース1.0k89 回インストール1 週間前に更新
リポジトリ

site-architecture について

新規サイトの設計、既存構造の監査、内部リンクの改善、URL 再編を支援するサイトアーキテクチャのスキルです。ナビゲーション、トピッククラスター、クロール深度、リダイレクト計画を扱います。

主な機能

  1. 01URL 階層の設計
  2. 02ナビゲーション構造の最適化
  3. 03トピッククラスターとサイロの設計
  4. 04内部リンクと孤立ページの監査
  5. 05URL 移行とリダイレクトの計画

活用シーン

  1. 01新規サイトのアーキテクチャ設計
  2. 02既存サイトの孤立ページの発見
  3. 03ハブページとトピックページ間のリンク改善
  4. 04リニューアル時の URL 変更の準備

インストール

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

$npx skills add https://github.com/borghei/claude-skills --skill site-architecture

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

scripts/
link_mapper.py
redirect_checker.py
sitemap_analyzer.py

詳細

サイトアーキテクチャと内部リンク

URL階層の設計、内部リンク戦略、ナビゲーションの最適化、サイロ構造、クロール評価の管理を網羅した、本番環境向けのWebサイトアーキテクチャフレームワークです。アーキテクチャの監査、新規サイトの計画、既存サイトの再構築に対応します。


目次


最初に確認すること

アーキテクチャを作成する前に、以下の情報を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

  • 運用モード — 現状の監査、新規サイトの計画、内部リンクの最適化、URLの再構築のいずれかです。作成する成果物が決まります
  • サイトタイプ — SaaS、eコマース、ブログ/コンテンツ、ローカル、ドキュメント、マーケットプレイスのいずれかです。URLパターンとアーキテクチャテンプレートを選択します
  • 主要トピック/サイロ — サイトが扱う3~7個のトピッククラスターです。ハブ&スポークと内部リンクの計画の基盤になります
  • 現在のURL/クロールデータ — サイトマップまたはURLのエクスポートです。監査とリダイレクトマッピングに必要です

停止ルール:出力に最も大きく影響する2~3項目のみ質問してください。ユーザーから「とにかく下書きを作って」と言われた場合は、作業を進め、成果物の冒頭に前提を列挙してください。

運用モード

モード1:現在のアーキテクチャを監査する

既存サイトの構造を評価します。階層の深さの分布、孤立ページ、リンク評価の流れ、ナビゲーションの有効性を分析します。

モード2:新しいアーキテクチャを計画する

ゼロから構築する場合、または全面的に再設計する場合に使用します。ビジネス目標をサイトセクションに対応づけ、URL階層を設計し、ナビゲーションを計画して、コンテンツのサイロを定義します。

モード3:内部リンクを最適化する

構造に問題はないものの、リンク評価の流れを改善する必要がある場合に使用します。ハブページを特定し、スポークコンテンツを対応づけ、孤立ページを解消して、アンカーテキストを最適化します。

モード4:URLを再構築する

既存サイトのURLを変更する場合に使用します。新しい構造を計画し、リダイレクトマップを作成して、移行を管理します。


URL構造の設計

階層のガイドライン
階層例使用する場合SEOへの影響
1階層(フラット)/cold-email-tipsブログ記事、単独ページページごとのクロール評価が最も高い
2階層/email-marketing/cold-email-tipsカテゴリ自体がランキング対象ページになる場合良好。カテゴリページに権威性が蓄積される
3階層/solutions/marketing/email-automation製品ファミリー、階層化されたサービス各階層にコンテンツがあれば許容可能
4階層以上/a/b/c/d/page使用しない評価の分散、UXの低下、クロールの問題

判断ルール: 中間ディレクトリのURL(/email-marketing/)が、独自のコンテンツとランキング対象を持つ実際のページにならない場合は、そのディレクトリを作成しないでください。空の階層を作るより、フラットな構造のほうが適切です。

URL構築ルール
ルール良い例悪い例理由
ハイフンを使う/seo-audit/seo_auditGoogleではアンダースコアは単語の区切りとして扱われません
内容を説明する/pricing/pricing-page冗長な接尾辞を追加しても意味がありません
短くする/guides/technical-seo/guides/technical-seo-audit-checklist-complete-guide読みやすさが重要です
キーワードを含める/guides/seo-audit/guides/article?id=4827説明的なURLのほうが上位に表示されやすくなります
末尾のスラッシュを統一する/about または /about/ のいずれかを選ぶ両方を混在させる一貫性がないと重複コンテンツが発生します
小文字を使う/about-us/About-Us大文字と小文字の区別はサーバーによって異なります
サイトタイプ別 URL パターン
サイトタイプパターン例
SaaS/features/[feature], /solutions/[use-case], /integrations/[partner]/features/analytics, /solutions/marketing, /integrations/slack
Eコマース/[category]/[subcategory]/[product]/mens/shoes/running-shoes-pro
ブログ/コンテンツ/blog/[slug] or /blog/[category]/[slug]/blog/seo-audit-guide
ローカルビジネス/[service]/[location]/plumbing/austin-tx
ドキュメント/docs/[section]/[page]/docs/api/authentication
マーケットプレイス/[category]/[listing]/designers/john-smith

ナビゲーションアーキテクチャ

ナビゲーションゾーン

すべてのサイトには6つのナビゲーションゾーンがあります。それぞれ異なる目的を持ち、SEO 上の重みも異なります。

ゾーン項目数SEO 上の重みデザインルール
プライマリーナビゲーション最大5~8項目高(サイト全体の評価)上位表示を狙うページのみを配置します。ランディングページのない「リソース」は決して配置しないでください。
セカンダリーナビゲーションセクションごとに3~7項目中セクション/サイロ内のサブナビゲーション
パンくずリスト動的高(上位ページへの評価)ホームページ以外のすべてのページに配置します。各階層は実際のリンクでなければなりません。
フッターナビゲーション最大8~15項目低~中重要なページのみを配置します。すべてのページを詰め込む場所ではありません。
コンテキスト(コンテンツ内)ページごとに3~5項目最高最も強力なシグナルです。本文内に自然な編集リンクを配置します。
サイドバー5~10項目低~中関連コンテンツ、カテゴリ一覧
プライマリーナビゲーションの設計

ルール:

  • 項目数は最大5~8項目です。9項目以上になると認知負荷が高まり始めます。
  • すべてのナビゲーション項目から、積極的に上位表示を狙うページにリンクします。
  • ドロップダウンメニューは問題ありませんが、親項目はクリック可能でクロール可能なリンクにする必要があります(ホバー時のトリガーだけにしないでください)。
  • ユーティリティページ(お問い合わせ、プライバシー、利用規約)をプライマリーナビゲーションに配置しないでください。フッターに配置します。
  • モバイルナビゲーションでも、デスクトップナビゲーションと同じ構造を表示する必要があります(重要なページを隠さないでください)。
パンくずリストの実装

ホームページ以外のすべてのページにパンくずリストを追加します。次の3つの役割があります。

  1. UX:階層内での現在位置をユーザーに示します
  2. SEO:ハブ/カテゴリページへのサイト全体の上位向き内部リンクを作成します
  3. リッチリザルト:SERP のパンくずリスト用に BreadcrumbList スキーマを有効にします

形式: Home > Category > Subcategory > Current Page

ルール:

  • パンくずリストの各階層は、実際のクロール可能なリンクにする必要があります
  • リンクのない装飾テキストをパンくずリストとして使用しないでください
  • 表示されるパンくずリストと合わせて BreadcrumbList スキーママークアップを追加します
  • パンくずリストの階層は URL の階層と一致させます

サイロ構造とトピッククラスター

ハブ&スポークモデル

サイロとは、1つのトピックに関するコンテンツで構成された独立したクラスターです。すべてのページが相互にリンクし、中央のハブページにもリンクします。

                    ┌──────────────────┐
                    │     HUB PAGE     │
                    │   /seo/          │
                    │   (Pillar content)│
                    └────────┬─────────┘
            ┌────────────────┼────────────────┐
       ┌────┴────┐      ┌───┴────┐      ┌────┴────┐
       │ SPOKE 1 │      │ SPOKE 2│      │ SPOKE 3 │
       │technical│      │on-page │      │  link   │
       │  seo    │      │  seo   │      │building │
       └────┬────┘      └───┬────┘      └────┬────┘
            │                │                │
       Cross-links     Cross-links      Cross-links
       between         between          between
       related         related          related
       spokes          spokes           spokes
トピッククラスターの構築

ステップ1: サイトの中核となるトピックを3~7個特定します(これらがサイロになります)

ステップ2: 各トピックについて、幅広く扱うピラーページ(ハブ)を1つ作成します

ステップ3: 主なサブ質問やサブトピックごとにスポークコンテンツを作成します

ステップ4: リンクを実装します。

  • ハブからすべてのスポークへリンクします
  • すべてのスポークからハブへリンクします(キーワードを含むアンカーテキストを使用)
  • 同じサイロ内の関連するスポーク同士をリンクします
  • 文脈上自然であれば、サイロをまたいだリンクも問題ありません

ステップ5: リンクを構築する前にコンテンツを作成します。存在しないコンテンツへのリンクは役に立ちません。

サイロの深さに関するガイドライン
サイロの規模推奨される深さ構造
スポーク3~5個フラットハブ+スポーク、すべて同じ階層
スポーク6~15個浅い階層構造ハブ > サブハブ > スポーク
スポーク16~50個2階層ハブ > カテゴリのサブハブ > 個々のスポーク
スポーク50個以上ページ分割ハブ > カテゴリのサブハブ > ページ分割されたスポーク一覧

内部リンク戦略

リンクエクイティの強さ

すべての内部リンクが同じ重みを持つわけではありません。強い順に並べると、次のとおりです。

順位リンクの種類重み使用する場面
1コンテンツ内の文脈に沿ったリンク最高本文内に自然な編集上のリンクを配置する場合
2ハブページのリンク高ピラーページからすべてのスポークページにリンクする場合
3ナビゲーションリンク中サイト全体で一貫して配置されるが、広く使われるため効果が薄まります
4パンくずリストのリンク中上位ページへのエクイティの流れを作り、一貫性を保つ場合
5フッターリンク低サイト全体に配置されますが、Google は評価を割り引きます
6サイドバーリンク低メインコンテンツの流れに含まれないことがよくあります
アンカーテキスト戦略
種類例用途シグナルの強さ
部分一致「効果的なコールドメール戦略」主なアプローチ(リンクの60~70%)強い
完全一致「コールドメールのテンプレート」控えめに使用(リンクの10~15%)強いが、使いすぎるとリスクがあります
ブランド名「メールに関するガイド」自然なバリエーション(10~15%)中程度
説明的「この包括的なガイド」自然なバリエーション(5~10%)弱いが自然
汎用的「ここをクリック」、「詳しく見る」避ける(5%未満)なし――シグナルを無駄にします
URL のみhttps://example.com/guide内部リンクでは使用しないなし
孤立ページの検出と解消

孤立ページとは、Google にインデックスされているものの、内部リンクからの被リンクがゼロのページです。サイトのリンクグラフから見えない状態です。

検出方法:

  1. インデックス済みの URL をすべてエクスポートします(GSC Coverage または site: クエリ)
  2. 内部リンクのリンク先をすべてエクスポートします(クロールツールまたはリンク抽出)
  3. セット A に含まれ、セット B に含まれないページが孤立ページです

解消方法:

孤立ページの種類対応
価値のあるコンテンツで、サイロに属するもの関連する3ページ以上から、文脈に沿ったリンクを追加します
古いコンテンツだが、今も関連性があるものハブページと1~2個のスポークページからリンクします
古く、価値のないコンテンツ関連ページにリダイレクトするか、noindex を設定します
ユーティリティページ(インデックスさせるべきでないもの)noindex を追加します
内部リンク監査チェックリスト
チェック項目合格基準
すべてのコンテンツページに、外部向けの内部リンクが3~5個ある自分自身やナビゲーションにしかリンクしていないページがない
すべての対象ページに、内部リンクからの被リンクが3つ以上あるインデックス済みページに孤立ページがない
ハブページから、すべてのスポークページにリンクしている網羅性が確保されている
アンカーテキストが説明的で、バリエーションに富んでいるどのキーワードでも完全一致が30%を超えていない
内部リンクにリンク切れがないリンク切れが0件
ホームページからのクリック数が4未満95%以上のページが3クリック以内

クロールエクイティの管理

ホームページのエクイティ配分

ホームページは、最もエクイティの高いページです。賢く活用してください。

ホームページのリンク先優先度
ハブページ/ピラーページ(各サイロの最上位)最高――ホームページのコンテンツ領域からリンクします
主要な製品/サービスページ高――ホームページまたはメインナビゲーションからリンクします
パフォーマンス上位のコンテンツ中――文脈に沿う場合にリンクします
ユーティリティページ(問い合わせ、会社概要)低――フッターからのみリンクします
ブログのインデックス中――メインまたはサブナビゲーションに配置します
クロールバジェットの配分
ページカテゴリクロールバジェットの割合最適化
収益ページ(製品、価格、機能)20~30%ホームページとナビゲーションから内部リンクします
ピラーコンテンツ(ハブページ)20~30%内部リンクを幅広く設定します
スポークコンテンツ(ブログ、ガイド)30~40%ハブページと文脈に沿ったリンクからリンクします
ユーティリティページ(会社概要、問い合わせ、法的情報)5~10%フッターからのみリンクし、クロールを最小限にします
タグ/アーカイブ/ページネーション5%未満内容が薄い場合は noindex を設定し、クロールを制限します

アーキテクチャ監査フレームワーク

監査スコアカード
寸法配点確認項目
クロールの深さ20%95%以上のページがホームページから3クリック以内にある
孤立ページ20%インデックス対象のページに孤立ページがない
URLの分かりやすさ15%分かりやすく、一貫性のあるURL
ナビゲーションの網羅性15%主要なページすべてに、メインまたはサブのナビゲーションからアクセスできる
内部リンクの網羅性15%すべてのページに3つ以上の内部リンクが向けられている
サイロ構造の一貫性10%トピッククラスターが明確に定義され、ハブとスポークの関係が明瞭である
パンくずリストの実装5%ホームページ以外のすべてのページにあり、スキーマも実装されている
警告サイン
シグナル深刻度対応
ホームページから3クリックを超えるページ高ナビゲーションまたはハブページのリンクからショートカットを作成する
ハブページにコンテンツがなく、リンクしかない高すべてのハブページにピラーコンテンツを追加する
汎用的なアンカーテキストが大半を占める(30%超)中アンカーテキストを説明的なものに書き換える
階層の深いページにパンくずリストがない中BreadcrumbList スキーマを使用してパンくずリストを実装する
サイトマップに noindex ページが含まれている中サイトマップをインデックス可能なページだけに絞る
メインナビゲーションからユーティリティページにリンクしている低お問い合わせ/プライバシーのリンクをフッターに移動する
フッターに50以上のリンクがある低重要なページ8~15件に減らす

再構築の手順

再構築するタイミング
シグナル再構築するか代替策
URL全体の見直しが必要はい--
新しいセクションを3つ追加する一部のみ(新しいセクションのみ)--
孤立ページを修正するいいえ内部リンクを追加する。URLの変更は不要
ナビゲーションを改善するいいえナビゲーションを更新し、URLは維持する
新しいCMSに移行するはい(通常)CMSが対応していれば、URL構造を維持する
再構築の手順
  1. 現在のサイトをクロールする -- すべてのURL、内部リンク、ランキングをエクスポートする
  2. 現在のURLを新しいURLに対応付ける -- 1対1のURLリダイレクトマッピングを作成する
  3. リダイレクトルールを作成する -- 変更したURLすべてに301リダイレクトを設定する
  4. 既存のリダイレクトチェーンを更新する -- 古いリダイレクトが最終的な移動先を指すように更新する
  5. 内部リンクを更新する -- 新しいURLを参照する(内部リンクではリダイレクトに頼らない)
  6. サイトマップを更新する -- 新しいURL構造を反映する
  7. 60日間監視する -- クロールエラー、ランキングの変化、トラフィックへの影響を確認する

サイトの種類別アーキテクチャパターン

SaaSウェブサイト
/                           Homepage
├── /features/              Features hub
│   ├── /features/analytics Analytics feature
│   └── /features/reporting Reporting feature
├── /solutions/             Solutions hub (by use case)
│   ├── /solutions/marketing Marketing use case
│   └── /solutions/sales    Sales use case
├── /integrations/          Integrations hub
│   ├── /integrations/slack Slack integration
│   └── /integrations/salesforce Salesforce integration
├── /pricing                Pricing page
├── /blog/                  Blog index
│   ├── /blog/seo-guide     Blog post
│   └── /blog/growth-tips   Blog post
├── /docs/                  Documentation
└── /about                  About page
Eコマースサイト
/                           Homepage
├── /[category]/            Category page (with content)
│   ├── /[category]/[subcategory]/ Subcategory (with content)
│   │   └── /[category]/[subcategory]/[product] Product page
│   └── /[category]/[product]      Product (if no subcategory)
├── /brands/                Brand hub
│   └── /brands/[brand]     Brand page
├── /blog/                  Content hub
└── /sale/                  Promotions hub
コンテンツ/メディアサイト
/                           Homepage
├── /[topic]/               Topic hub (pillar content)
│   ├── /[topic]/[subtopic] Subtopic article
│   └── /[topic]/[guide]    In-depth guide
├── /authors/               Author hub
│   └── /authors/[name]     Author page
├── /tools/                 Free tools hub
│   └── /tools/[tool]       Individual tool
└── /newsletter             Newsletter signup

よくある間違い

間違い悪影響修正方法
孤立ページ評価が流入せず、Googleが優先度を下げる関連コンテンツから文脈に沿った内部リンクを追加する
リダイレクトせずにURLを変更するリンク評価が失われ、被リンクが機能しなくなる古いURLは必ず301リダイレクトする
階層が深すぎる(4階層以上)クロール評価が分散し、UXが分かりにくくなる構造をフラット化する
空のカテゴリページ内容の薄いページはランキングされないすべてのカテゴリページ/ハブページにピラーコンテンツを追加する
ホームページからどこにもリンクしていない最も評価の高いページを無駄にするホームページからすべてのハブページにリンクする
100以上のリンクがあるフッターリンク評価が多くのリンク先に分散するフッターを重要なページ8~15件に制限する
ナビゲーションがユーザーのメンタルモデルと一致しないユーザーが離脱し、エンゲージメントが低下する実際のユーザーを対象にカードソートテストを実施する
動的パラメーター付きURL重複コンテンツが発生する正規化するか、robots.txtでブロックする
サイト全体のサイドバーからすべての投稿にリンクするリンク評価が分散し、ノイズが増える削除するか、「人気」の投稿に限定する

成果物

成果物形式説明
アーキテクチャ監査スコアカード重み付きスコア表ディメンションごとのスコアと重大な問題の指標
サイトツリー図テキストベースの階層注釈付きの URL 構造を視覚化
URL 仕様表表セクションごとの URL パターン、タイトルテンプレート、親ページ、スキーマタイプ
内部リンク計画ハブ&スポークマップトピッククラスターのマップ。アンカーテキストのガイドラインと孤立ページの修正リストを含む
リダイレクトマップ変更前/変更後の URL 表URL 再構成における 1 対 1 の対応付けと 301 の実装
ナビゲーション仕様ゾーンごとの設計プライマリ、セカンダリ、パンくずリスト、フッター、コンテキストナビゲーションの計画

関連スキル

  • seo-audit -- アーキテクチャが複数の問題領域のひとつである、包括的な SEO 監査に使用します。全体像を把握するには seo-audit を、構造を深く検討するには site-architecture を使用します。
  • schema-markup -- アーキテクチャの決定が確定した後に、BreadcrumbList やその他の構造化データを追加するために使用します。
  • programmatic-seo -- テンプレートベースのページを数百件生成する際に、大規模なハブ&スポーク構造を構築するために使用します。
  • content-creator -- ハブページが効果的にランキングされるために必要なピラーコンテンツを作成するために使用します。

トラブルシューティング

問題考えられる原因対処方法
Google インデックスに孤立ページが現れるページがサイトマップに存在するか外部リンクがあるものの、そのページを指す内部リンクがない関連する 3 件以上のページからコンテキストに沿った内部リンクを追加し、ハブページにも追加する
重要なページへのクロール深度が 4 クリックを超える階層の浅いナビゲーションがない、またはハブページからスポークへのリンクがないプライマリナビゲーション、ハブページのコンテンツブロック、注目セクションからショートカットリンクを作成する
カテゴリ/ハブページのランキングが低いハブページに実質的なコンテンツがなく、リンクリストしかないすべてのハブページに 800 語以上のピラーコンテンツを追加する。各ページは独自の価値でランキングされる必要がある
サイト移行後にリダイレクトチェーンが発生する古いリダイレクトの転送先が最終的なページに更新されていない。複数回の移行によってチェーンが蓄積する既存のリダイレクトをすべて監査し、各リダイレクトが最終 URL を直接指すようにチェーンを解消する
内部リンクで一般的なアンカーテキストが使われている「ここをクリック」や「詳細はこちら」が内部リンクのアンカーテキストの大半を占めているアンカーを部分一致キーワードを含む説明的なものに書き換え、部分一致を 60~70% にする
新しいセクションがクロールされない既存の高権威ページから新しいセクションへの内部リンクがないホームページと関連するハブページからコンテキストに沿ったリンクを追加し、新しいセクションのサイトマップを送信する

成功基準

  • クロール深度:インデックス可能なページの 95% 以上に、ホームページから 3 クリック以内で到達できる
  • 孤立ページゼロ:インデックス登録されたページはすべて、3 件以上の内部リンクを受けている
  • URL の整理:すべての URL が確立されたパターンに従っている。小文字、ハイフン区切り、説明的な表記、一貫した末尾スラッシュの方針を採用する
  • ナビゲーションの網羅性:収益に関わるすべての重要ページとピラーページに、プライマリまたはセカンダリナビゲーションからアクセスできる
  • 内部リンク密度:すべてのコンテンツページに、説明的なアンカーテキストを使ったコンテキストに沿う発リンクが 3~5 件ある
  • サイロの一貫性:各トピッククラスターに定義済みのハブページがあり、すべてのスポークと双方向にリンクしている
  • パンくずリストの網羅性:ホームページ以外のページの 100% に BreadcrumbList スキーマがある

対象範囲と制限事項

対象範囲:

  • URL 階層の設計と再構成
  • ナビゲーションアーキテクチャ(プライマリ、セカンダリ、パンくず、フッター、コンテキスト、サイドバー)
  • サイロ構造とトピッククラスターの計画
  • 内部リンク戦略と最適化
  • クロールエクイティの分析と最適化
  • スコア付きレポートによるアーキテクチャ監査
  • リダイレクトマッピングを含む URL 移行計画

対象範囲外:

  • ハブページのコンテンツ作成(Content Production を使用)
  • スキーママークアップの実装(Schema Markup を使用)
  • アーキテクチャ以外のテクニカル SEO(SEO Audit を使用)
  • ナビゲーションのビジュアルデザインや UX デザイン
  • CMS の開発やテンプレートのコーディング
  • 外部リンクの構築

既知の制限事項:

  • クロールエクイティの分配は推定値です。Google は正確な PageRank のフローに関するデータを公開していません
  • 大規模サイト(10K+ ページ)でのアーキテクチャ変更には、トラフィックの損失を避けるため、慎重な段階的移行が必要です
  • ナビゲーションのテスト(カードソート、ツリーテスト)には、ユーザーリサーチ用のツールと参加者が必要です
  • サイロをまたぐリンクに関する推奨事項は定性的なものです。最適な相互リンク密度を決める確定的な公式はありません

スクリプト

# Analyze sitemap for depth and structure issues
python scripts/sitemap_analyzer.py --file sitemap.xml --json

# Check URLs for redirect chains and patterns
python scripts/redirect_checker.py --file urls.txt --json

# Map internal link structure from a sitemap
python scripts/link_mapper.py --sitemap sitemap.xml --json

コメント