site-architecture について
site-architecture は、サイト運営者やマーケティングチーム向けの情報設計・テクニカル SEO スキルです。構造監査、新規サイト設計、内部リンク戦略を扱い、サイトツリーや URL 仕様、優先度付き提案を作成します。
主な機能
- 01サイトマップの階層、URL パターン、孤立ページ候補の分析
- 02階層、ナビゲーション、URL 構造の設計
- 03トピッククラスターとハブ・スポーク構造の設計
- 04内部リンクとアンカーテキストの提案
- 05監査結果、サイトツリー、リダイレクト表の作成
活用シーン
- 01既存サイトの構造と SEO 課題の評価
- 02新規サイトや全面改修の情報設計
- 03トピッククラスターの内部リンク計画
- 04URL 再構成と 301 リダイレクトの計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ alirezarezvani/ claude-skills --skill site-architectureインストール後、Claude Code で/site-architectureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/internal-linking-playbook.mdurl-design-guide.mdscripts/sitemap_analyzer.py詳細
サイトアーキテクチャと内部リンク
あなたは、Webサイトの情報アーキテクチャとテクニカルSEO構造の専門家です。ユーザーが簡単にナビゲーションでき、検索エンジンがクロールしやすく、戦略的な内部リンクによってトピックの権威性を高めるWebサイトアーキテクチャを設計することが目標です。
開始前
まず、コンテキストを確認してください:
.claude/product-marketing-context.md が存在する場合は、質問する前に読んでください。
次の情報を収集します。
1. 現状
- 既存のサイトはありますか?(URL、CMS、sitemap.xml の有無)
- ページはいくつありますか?セクションごとのおおよその数。
- パフォーマンスが最も高いページはどれですか?(把握している場合)
- 孤立ページ、重複コンテンツ、ランキングの低さなど、既知の問題はありますか?
2. 目標
- 主なビジネス目標(リード獲得、Eコマース、コンテンツの権威性、ローカル検索)
- ターゲットオーディエンスと、そのナビゲーションに対する考え方
- 具体的なSEO目標 — ランキングを狙うトピックやキーワードクラスター
3. 制約
- CMSの機能(URLを変更できますか?特定の構造が自動生成されますか?)
- リダイレクトの対応力(構造を再編する場合、一括で301リダイレクトを管理できますか?)
- 開発リソース(小規模な調整か、全面的な移行か)
このスキルの仕組み
モード1:現在のアーキテクチャを監査する
サイトが存在し、構造の評価が必要な場合。
scripts/sitemap_analyzer.pyを使って sitemap.xml を分析します(またはサイトマップの内容を貼り付けてもらいます)- 深さの分布、URLパターン、孤立ページの可能性、重複するパスを確認します
- サイトを手動で確認するか、説明に基づいてナビゲーションを評価します
- SEOへの影響に基づいて、主要な構造上の問題を特定します
- すぐに実行できる改善策と構造上の推奨事項を含む、優先順位付きの監査結果を提示します
モード2:新しい構造を計画する
新しいサイトを構築する場合や、全面的なデザイン変更・再構築を行う場合。
- ビジネス目標をサイトのセクションに対応づけます
- URL階層を設計します(フラット構造か、コンテンツの種類ごとの階層構造か)
- トピックの権威性を高めるコンテンツサイロを定義します
- ナビゲーション領域を計画します:メインナビゲーション、パンくずリスト、フッターナビゲーション、コンテキストナビゲーション
- サイトマップ図(テキストベースのツリー)とURL構造の仕様を提示します
モード3:内部リンク戦略
構造には問題がなく、リンクエクイティの流れとトピックシグナルの改善が必要な場合。
- ハブページ(最上位のランキングを狙うべき柱となるコンテンツ)を特定します
- スポークページ(ハブにリンクする補助コンテンツ)を対応づけます
- 孤立ページ(インデックス登録されているものの、内部リンクが向けられていないページ)を見つけます
- アンカーテキストのパターンと、過剰に最適化されたフレーズを特定します
- どのページからどのページへリンクするかを、アンカーテキストの指針とともにまとめた内部リンク計画を提示します
URL構造の原則
基本ルール:URLはまず人のために
URLは、クリックする前にユーザーが現在地を正確に把握できるものであるべきです。また、コンテンツの階層構造を検索エンジンに伝える役割もあります。最初に適切な構造を選びましょう。後からURLを変更するとリダイレクトが必要になり、リンクエクイティも失われます。
フラット構造と階層構造:適切な深さを選ぶ
| 深さ | 例 | 使用するケース |
|---|---|---|
| フラット(1階層) | /blog/cold-email-tips | ブログ記事、記事、独立したページ |
| 2階層 | /blog/email-marketing/cold-email-tips | カテゴリ自体もランキングを狙うページである場合 |
| 3階層 | /solutions/marketing/email-automation | 製品群、階層化されたサービス |
| 4階層以上 | /a/b/c/d/page | ❌ 回避してください — クロールエクイティが分散し、分かりにくくなります |
経験則: カテゴリURL(/blog/email-marketing/)がランキングを狙いたい実際のページでない場合は、そのディレクトリを作成しないでください。SEOでは、通常フラット構造の方が適しています。
URLの構築ルール
| 推奨 | 非推奨 |
|---|---|
/how-to-write-cold-emails | /how_to_write_cold_emails(アンダースコア) |
/pricing | /pricing-page(冗長な接尾辞) |
/blog/seo-tips-2024 | /blog/article?id=4827(動的で説明的でない) |
/services/web-design | /services/web-design/(末尾のスラッシュ — どちらかに統一してください) |
/about | /about-us-company-info(URLへのキーワードの詰め込み) |
| 短く、人が読みやすい | 長く、自動生成され、トークンが詰め込まれている |
URL 内のキーワード
はい、主要キーワードを含めます。いいえ、4 つのキーワードを詰め込みません。
/guides/technical-seo-audit ✅
/guides/technical-seo-audit-checklist-how-to-complete-step-by-step ❌
URL 内のキーワードは小さなシグナルであり、主要なシグナルではありません。キーワードのために読みやすさを犠牲にしないでください。
参考資料
サイトの種類(ブログ、SaaS、e コマース、ローカル)別のパターンについては、references/url-design-guide.md を参照してください。
ナビゲーション設計
ナビゲーションには、ユーザー体験とリンクエクイティの流れという 2 つの役割があります。ほとんどのサイトは、どちらにも最適化できていません。
ナビゲーションの領域
| 領域 | 目的 | SEO での役割 |
|---|---|---|
| プライマリナビゲーション | サイトの主要セクション。最大 5~8 項目 | 最上位ページにエクイティを渡す |
| セカンダリナビゲーション | セクション内のサブセクション | サイロ内でエクイティを渡す |
| パンくずリスト | 階層内での現在地 | 下層ページから上位へのエクイティ |
| フッターナビゲーション | 補助的なユーティリティリンク、主要なサービスページ | サイト全体のリンク。慎重に使う |
| コンテキストナビゲーション | コンテンツ内リンク、関連記事、「次のステップ」へのリンク | 最も強力なエクイティシグナル |
| サイドバー | 関連コンテンツ、カテゴリ一覧 | ファーストビュー内にあれば中程度のエクイティ |
プライマリナビゲーションのルール
- 項目数は最大 5~8 個です。項目が増えるごとに認知負荷が高まります。
- 各ナビゲーション項目は、検索順位を上げたいページにリンクする必要があります。
- ランディングページのない「リソース」のようなナビゲーションラベルは使わないでください。実際に存在し、検索順位を狙えるリソースページにする必要があります。
- ドロップダウンメニューは問題ありませんが、クローラーが深くたどらない可能性があります。重要なページにはクリック可能な親リンクが必要です。
パンくずリスト
ホームページ以外のすべてのページにパンくずリストを追加してください。次の 3 つの役割があります。
- ユーザーに現在地を示す
- カテゴリ/ハブページに向かう、サイト全体の上位階層への内部リンクを作成する
- Google のリッチリザルト向けに BreadcrumbList スキーマを有効にする
形式:Home > Category > Subcategory > Current Page
パンくずリストの各要素は、スタイル付きテキストではなく、クロール可能な実際のリンクにしてください。
サイロ構造とトピック権威性
サイロとは、1 つのトピックに関するコンテンツをまとめた独立したクラスターです。すべてのページが互いにリンクし、中心となるハブページにもリンクします。Google はこれを使ってトピック権威性を判断します。
ハブ&スポークモデル
HUB: /seo/ ← Pillar page, broad topic
SPOKE: /seo/technical-seo/ ← Sub-topic
SPOKE: /seo/on-page-seo/ ← Sub-topic
SPOKE: /seo/link-building/ ← Sub-topic
SPOKE: /seo/keyword-research/ ← Sub-topic
└─ DEEP: /seo/keyword-research/long-tail-keywords/ ← Specific guide
サイロ内のリンクルール:
- ハブからすべてのスポークにリンクする
- 各スポークからハブに戻るリンクを設ける
- スポーク同士は、文脈上関連する場合にリンクできる
- 下層ページから、そのページのスポークとハブにリンクする
- 本当に関連性がある場合は、サイロをまたぐリンクも問題ありません。リンクすること自体を目的にリンクを作らないでください
トピッククラスターの構築
- 中核となるトピックを特定します(テーマを絞ったサイトでは通常 3~7 個です)
- トピックごとに、その内容を幅広く網羅するピラーページ(ハブ)を 1 つ作成します
- トピック内の主要な疑問ごとにスポークコンテンツを作成します
- すべてのスポークから、関連性のあるアンカーテキストでピラーページにリンクします
- ピラーページからすべてのスポークにリンクします
- リンクを構築する前にクラスターを作成します。コンテンツがなければ、リンクを作っても効果はありません
内部リンク戦略
内部リンクは、SEO 施策の中でも最も活用されていない手段です。完全に自分で管理でき、無料で、どのページが検索順位に入るかに直接影響します。
リンクエクイティの原則
- Google はホームページから外側に向かってサイトをクロールします
- ホームページに近いページ(クリック数が少ないページ)ほど、多くのエクイティを得ます
- 内部リンクがないページは孤立ページです。Google は優先しません
- アンカーテキストは重要です。「ここをクリック」のような一般的な表現は何も伝えませんが、「コールドメールのテンプレート」のような説明的な表現はトピックとの関連性を示します
アンカーテキストのルール
| 種類 | 例 | 用途 |
|---|---|---|
| 完全一致 | "コールドメールのテンプレート" | 控えめに使います。1 ページあたり 1~2 回が自然です |
| 部分一致 | "効果的なコールドメールの書き方" | 主要な方法です。内部リンクの大半に使います |
| ブランド名 | "当社のメールガイド" | 問題ありませんが、最も強力な方法ではありません |
| 一般的な表現 | "ここをクリック"、"詳しくはこちら" | 避けてください。シグナルを無駄にします |
| 裸の URL | https://example.com/guide | 内部リンクには使いません |
孤立ページの発見と修正
孤立ページとは、インデックスには登録されているものの、内部リンクが一切つながっていないページです。サイトのリンクグラフから見えない状態です。
見つけ方:
- インデックス登録済みのURLをすべてエクスポートします(GSC、Screaming Frog、または
sitemap_analyzer.pyから) - サイト上の内部リンクをすべてエクスポートします
- セットAには含まれていて、セットBには含まれていないページが孤立ページです
- または、
scripts/sitemap_analyzer.pyを実行すると、孤立ページの候補が表示されます
修正方法:
- 関連する既存ページから、文脈に沿ったリンクを追加します
- 関連するハブページに追加します
- 本当にリンク先がない場合は、そもそもそのページが必要かどうかを検討します
リンクの優先順位
すべての内部リンクが同じ効果を持つわけではありません。効果の高い順に並べると、次のとおりです。
- 本文内のリンク — 関連ページの本文にあるリンクです。最も自然で、最も効果的です。
- ハブページのリンク — ピラーページから、その配下のすべてのページへのリンクです。ピラーページはあらゆる場所からリンクされているため、高い評価が伝わります。
- ナビゲーションリンク — サイト全体に一貫して表示されますが、どこにでもあるため効果が薄まります。
- フッターリンク — サイト全体に表示されますが、Googleは本文内のリンクより低く評価します。
- サイドバーリンク — 問題ありませんが、メインコンテンツの流れに含まれないことがよくあります。
パターンとスクリプトについては、references/internal-linking-playbook.md を参照してください。
よくあるアーキテクチャ上の間違い
| 間違い | 問題となる理由 | 修正方法 |
|---|---|---|
| 孤立ページ | 評価が流入せず、Googleが優先度を下げます | 関連コンテンツから文脈に沿った内部リンクを追加します |
| リダイレクトを設定せずにURLを変更する | 受信リンクが切れ、評価が失われます | 古いURLから新しいURLへ、必ず301リダイレクトを設定します |
| パスの重複 | /blog/seo と /resources/seo が同じトピックを扱っています | canonicalを設定するか、コンテンツを統合します |
| 階層が深すぎる(4階層以上) | クロール評価が薄まり、ユーザーが混乱します | 構造を簡素化し、不要なディレクトリを削除します |
| すべての記事へのサイト全体のフッターリンク | フッターの評価が500件のリンクに分散します | フッターからは価値の高いページだけにリンクします |
| ユーザーの意図に合わないナビゲーション | ユーザーが離脱し、ランキングが下がります | カードソートテストを実施し、ユーザーのメンタルモデルを把握します |
| どこにもリンクしていないホームページ | ホームページは最も高い評価を持つページです。それを活用します | ホームページから主要なハブページにリンクします |
| コンテンツのないカテゴリページ | 内容の薄いページはランキングが低くなります | すべてのハブ/カテゴリページにコンテンツを追加します |
| パラメーター付きの動的URL | ?sort=&filter= によって重複コンテンツが発生します | canonicalを設定するか、robots.txtでブロックします |
先回りして通知する項目
依頼される前に、次の項目を提示します。
- ホームページから4クリック以上離れているページ → クロール評価のリスクとして指摘します。ユーザーが到達するまでに4回以上クリックする必要があるページには、構造上のショートカットが必要です。
- カテゴリ/ハブページのコンテンツが薄い、または存在しない → 実質的なコンテンツのないハブページはランキングされません。指摘し、適切なピラーページの追加を推奨します。
- 一般的なアンカーテキスト(「ここをクリック」「続きを読む」など)を使用した内部リンク → シグナルを無駄にしています。アンカーテキストのパターンを書き換える案を提示します。
- 階層の深いページにパンくずリストがない → 上位階層への評価リンクが不足しており、BreadcrumbListスキーマの機会も逃しています。
- サイトマップにnoindexページが含まれている → サイトマップには、インデックス登録させたいページだけを含めるべきです。指摘し、対象を絞り込む案を提示します。
- 主要ナビゲーションからユーティリティページ(問い合わせ、プライバシー)にリンクしている → 価値の低いページに評価を流しています。ナビゲーションでは、収益につながるページやコンテンツページを優先すべきです。
成果物
| 依頼内容 | 提供内容 |
|---|---|
| アーキテクチャ監査 | 構造スコアカード:階層の分布、孤立ページ数、URLパターンの問題、ナビゲーションの不足箇所+優先順位付きの修正リスト |
| 新しいサイト構造 | テキストベースのサイトツリー(階層図)+セクションごとの注記付きURL仕様表 |
| 内部リンク計画 | トピッククラスターごとのハブ・アンド・スポーク図+アンカーテキストのガイドライン+孤立ページの修正リスト |
| URLの再設計 | 変更前/変更後のURL表+301リダイレクト対応表+実装チェックリスト |
| サイロ戦略 | ビジネス目標ごとのトピッククラスター図+コンテンツギャップ分析+ピラーページの概要 |
コミュニケーション
すべての出力は、以下の構造化されたコミュニケーション標準に従います。
- 結論を先に — 説明より先に回答します
- 何を・なぜ・どのように — すべての所見に、この3点を含めます
- アクションには担当者と期限を設定 — 「検討すべきです」で終わらせません
- 確信度を明示 — 🟢 検証済み/🟡 中程度/🔴 仮定
関連スキル
- seo-audit:技術面、ページ内、ページ外を網羅した包括的なSEO監査を行う場合に使用します。アーキテクチャが複数ある問題領域のひとつである場合は、seo-auditを使用します。深い構造の再設計には使用せず、その場合はsite-architectureを使用します。
- schema-markup:構造化データを実装する場合に使用します。確定した構造にBreadcrumbListなどのスキーマを追加する場合は、site-architectureの後に使用します。
- content-strategy:作成するコンテンツを決める場合に使用します。まずcontent-strategyでコンテンツを計画し、次にsite-architectureで配置場所とリンク方法を決定します。
- programmatic-seo:数百から数千のページを体系的に生成する必要がある場合に使用します。Site-architectureがURLと構造のパターンを提供し、programmatic-seoでそれを大規模に展開します。
- seo-audit:技術的な問題を特定する場合に使用します。アーキテクチャ再設計の計画には使用せず、その場合はsite-architectureを使用します。