url-structure について
url-structureは、マーケターやサイト運営チーム向けのSEOスキルです。URLの階層、多言語パス、パラメーター、リダイレクトの設計や確認を支援します。
主な機能
- 01URL階層の設計
- 02読みやすいURLの指針
- 03静的・動的URLの指針
- 04多言語パスのパターン
- 05パラメーターとリダイレクトの処理
活用シーン
- 01新しいサイトのURL設計
- 02SEO監査でのURLパターン確認
- 03サイト移行時のURL対応
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ kostja94/ marketing-skills --skill url-structureインストール後、Claude Code で/url-structureを入力して読み込まれたか確認します。
詳細
SEO オンページ:URL 構造
SEO における URL 構造の最適化について、読みやすさ、階層、ベストプラクティスを解説します。
呼び出し時:初回利用時は、役立つ場合、まずこのスキルの対象範囲と重要性を1~2文で説明してから、主な出力を提示します。2回目以降の利用時、またはユーザーから省略の指示があった場合は、主な出力に直接進みます。
対象範囲(オンページ SEO)
- URL の階層:パス構造、カテゴリ、深さ
- URL の形式:静的 URL と動的 URL。ファイル拡張子は省略
- URL スラッグ:スラッグの作成については url-slug-generator を参照(3~5語、60文字未満)
- 重複するバリエーション:HTTPS、www、末尾のスラッシュについては canonical-tag を参照
初期評価
プロジェクトのコンテキスト: contextus.md がルートにある場合は読み込み、このタスクに関連するモジュールのみを読み込みます。Contextus がない場合は、利用可能なプロジェクト資料またはユーザーから提供された情報を使用し、不足している情報を確認します。並行して別のコンテキストシステムを作成しないでください。
以下を特定します。
- サイト構造:カテゴリ、サブカテゴリ、コンテンツタイプ
- 現在の URL:既存のパターンと問題点
- 多言語対応:zh/en の URL 構造(例:/zh/、/en/ またはサブドメイン)
ベストプラクティス
URL のガイドライン
| 原則 | ガイドライン |
|---|---|
| 読みやすさ | ID ではなく単語を使用します。/p/12345 ではなく /blog/seo-guide |
| 短さ | 一般に短いほど適切です。不要な階層は避けます |
| キーワード | 自然な場合は、ターゲットキーワードを含めます |
| 小文字 | 小文字を使用し、大文字と小文字の混在は避けます |
| ハイフン | 単語の区切りにはハイフンを使用します:seo-guide |
| 避けるもの | 特殊文字、主要コンテンツのクエリパラメーター、セッション ID |
階層
| パターン | 例 | 用途 |
|---|---|---|
| フラット | /page-name | シンプルなサイト |
| カテゴリ | /blog/post-name、/tools/tool-name | コンテンツサイト |
| ネスト | /category/subcategory/page | 深い階層(浅く保ちます) |
多言語対応
| パターン | 例 |
|---|---|
| パスプレフィックス | /zh/page、/en/page |
| サブドメイン | zh.example.com、en.example.com |
| ccTLD | example.cn、example.com |
静的 URL、動的 URL、擬似静的 URL
| 種類 | 例 | 用途 |
|---|---|---|
| 静的 | /blog/seo-guide | 直接ファイルを指定します。SEO に最適で、コンテンツが安定しています |
| 動的 | /product?id=123 | プログラムで生成します。インデックス登録可能なコンテンツでは避けます |
| 擬似静的 | /blog/seo-guide(.php から書き換え) | 両方の特性を兼ね備えています。CMS で一般的です |
| ルール | 静的 URL または擬似静的 URL を優先します。動的 URL の場合は、パラメーターを2個以下にし、canonical-tag と robots-txt(Clean-param)を使用します |
ファイル拡張子
- 省略するもの:
.html、.php、.aspx— URL を特定の技術に依存させず、短くし、リファクタリングしやすくします - 例:
/seo-guide.htmlではなく/seo-guide
URL パラメーターの処理
| シナリオ | 対応方法 |
|---|---|
| UTM/トラッキング | ベース URL を canonical に指定します。パラメーターはクエリ文字列のみで使用します |
| 検索結果 | 検索ページを canonical に指定します。検索結果 URL のインデックス登録は避けます |
| フィルター/並べ替え | ベース URL を canonical に指定するか、robots-txt の Clean-param を使用します |
| セッション ID | Cookie を使用します。インデックス登録可能な URL に含めてはいけません |
ユースケース
| シナリオ | 重点項目 |
|---|---|
| 新規サイト | 階層を事前に計画し、後の再構成を避けます |
| 移行 | 301 マッピング、canonical。canonical-tag を参照してください |
| 大規模サイト | 動的 URL、パラメーター、多言語対応 — canonical と robots |
| SEO 監査 | 構造、パラメーター、canonical の一貫性を確認します |
よくある問題
| 問題 | 修正方法 |
|---|---|
| URL が長い | 短くし、冗長な単語を削除します |
| 動的パラメーター | canonical を使用し、robots でパラメーターを整理します(Yandex Clean-param) |
| 大文字と小文字の混在 | 小文字の URL にリダイレクトします |
| URL の変更 | 古い URL から新しい URL へ 301 リダイレクトします |
出力形式
- URL 構造に関する推奨事項
- スラッグの規則
- 主要なコンテンツタイプの階層
- URL を変更する場合のリダイレクト計画
- 参考資料:Alignify の URL 最適化;Google の URL ガイドライン
関連スキル
-
website-structure:構造と URL パスを計画します。構造の定義後に url-structure のルールを適用します
-
canonical-tag:HTTPS、www、末尾のスラッシュを扱い、重複する URL のバリエーションに対応します
-
url-slug-generator:コンテンツページのスラッグを作成します。長さ、キーワード、形式を扱います
-
category-page-generator:E コマースのカテゴリ URL 階層とファセット URL を扱います
-
products-page-generator:製品 URL 階層を扱います
-
services-page-generator:サービス URL 階層を扱います
-
robots-txt:クエリパラメーター向けの Clean-param を扱います
-
internal-links:URL 構造がリンクのパターンに影響します