サイト運営・SEO用途
GitHubでsitemap.xmlを管理する時の注意点
GitHubでsitemap.xmlを管理する時に、追加URL、未作成URL、Search Console送信前確認を整理します。
このページでわかること
- GitHubでsitemap.xmlを管理する時の注意点で最初に確認すること
- 初心者がつまずきやすいポイント
- CodexやChatGPTと組み合わせる時の注意
- 秘密情報をGitHubへ入れないための考え方
最初に結論
sitemap.xmlには、公開済みで検索に見せたいURLだけを入れます。未作成URLや404になるURLは入れないことが大切です。
初心者向け説明
sitemap.xmlは検索エンジンへページ一覧を伝えるファイルです。ページ追加時は、HTML作成、内部リンク、公開確認、sitemap追加をひとつの流れで確認します。
向いている使い方
- 新規ページを検索に見つけてもらいたい
- Search Consoleへ送信する
- サイト全体のURL一覧を管理する
注意が必要な使い方
- 未完成ページを入れない
- URL末尾のスラッシュを揃える
- canonicalと違うURLを載せない
CodexやChatGPTと組み合わせる場合
Codexでページを増やす時は、追加URL一覧とsitemap更新を同時に出させ、deploy後に全URLの200確認を行います。
秘密情報・APIキー・パスワード・個人情報の注意
sitemapに管理画面、テストファイル、秘密ファイル、認証が必要なURLを入れないでください。
URLの書式・ファイル容量・更新日の扱い
2026年11月18日時点の公式ヘルプでは、Google向けサイトマップはUTF-8で作成し、URLはhttpsから始まる完全な絶対URLで指定する説明です。1ファイルの上限は圧縮前50MBまたは50,000URLで、超える場合は複数へ分割し、サイトマップインデックスへまとめられます。Search Consoleを通じて送信しない場合の対象範囲は、配置先の親ディレクトリより下の階層です。
Googleはpriorityとchangefreqの値を使わず、lastmodは一貫して正確だと検証できる場合に利用する説明です。lastmodが表すのは、本文・構造化データ・リンクなどを最後に大きく更新した日時です。著作権表示の年を変えただけの更新は、その例に含まれません。GitHub側でファイルを保存した日付と、掲載ページの主要な内容を変えた日付は、項目の意味として区別されます。
出典:Google『サイトマップの作成と送信』(2026年11月18日確認)https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap?hl=ja
XMLの必須要素と文字のエスケープ
2026年11月18日時点の公式ヘルプでは、XMLサイトマップはurlsetで全体を囲み、各URLをurl要素、その所在地をloc要素で表す仕様です。lastmod、changefreq、priorityは任意要素です。locにはURLのプロトコルを含める必要があり、サイトが末尾スラッシュを必要とするなら、その形式まで含めたURLを置く規定です。
XMLで特別な意味を持つ文字はエスケープが必要です。たとえばURLに含まれるアンパサンドは、XMLのソース内では&と表す規定です。URL自体のエンコードと、XML文書としてのエスケープは別の処理です。仕様にはサンプルとXML Schemaも用意されており、文字列としてURLが並んでいるだけでなく、文書の構造が仕様に沿っているかも点検対象になります。
出典:sitemaps.org『Sitemaps XML format』(2026年11月18日確認)https://www.sitemaps.org/protocol.html
Search Consoleの成功表示とページ登録の違い
2026年11月18日時点の公式ヘルプでは、サイトマップレポートの成功は、サイトマップを取得してエラーなく読み取れた状態です。取得できなかった状態や、一部を読み取れたものの解析エラーがある状態とは分けて表示されます。検出されたページ数はサイトマップから解析できたページURLの数であり、それらのページがクロール済みか、インデックス登録済みかを示す数ではありません。
このレポートに並ぶのは、レポート画面またはAPIで送信したサイトマップです。robots.txtなど別の方法で発見されたファイルが、自動で同じ一覧へ加わるわけではありません。また、表示対象は選択中のプロパティに属するものです。httpとhttps、wwwの有無などが異なるプロパティを開いている場合は、期待した送信記録がそこに出ない理由になります。
出典:Google『サイトマップ レポートを使用してサイトマップを管理する』(2026年11月18日確認)https://support.google.com/webmasters/answer/7451001?hl=ja
内部リンクでの発見とサイトマップの役割
2026年11月18日時点の公式ヘルプでは、Googleは、サイトの重要なページへメニューやページ内リンクで到達できれば、通常は多くのページを発見できると説明しています。サイトマップは、大規模でリンクの抜けが生じやすいサイトや、外部からのリンクが少ない新しいサイトで、URLの発見を補う手段です。
画像・動画・ニュースなどの情報をサイトマップへ加える用途も示されています。一方、サイトマップへ列挙した全項目がクロールや登録に至るとは限らないとされています。リポジトリにファイルがある状態、サイトマップを検索エンジンが読んだ状態、個々のページを取得した状態は、それぞれ別です。サイト内で読者が移動するためのリンクと、検索エンジンへURLを伝えるファイルは、役割を分けて管理する対象になります。
出典:Google『サイトマップについて』(2026年11月18日確認)https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview?hl=ja
Jekyllで配信対象から外れるファイル
2026年11月18日時点の公式ヘルプでは、JekyllはMarkdownやHTMLから静的なサイトを作る仕組みで、設定の多くを_config.ymlで管理すると説明されています。既定ではnode_modulesとvendorの中のファイル、名前がアンダースコア・ピリオド・シャープで始まるもの、末尾がチルダのもの、excludeで除外したものはビルド対象から外れます。必要な対象はinclude設定で処理へ加えられます。
そのため、GitHub PagesでJekyllを使う構成では、リポジトリ内のパス一覧と、生成されたサイトのURL一覧は同じ概念ではありません。サイトマップへ追加するURLを調べる際にも、ソースの配置とビルド後の配置を区別する根拠になります。公式は、対応していないプラグインを使う場合には、サイトを手元で生成してから静的ファイルを置く方法も案内しています。
出典:GitHub『About GitHub Pages and Jekyll』(2026年11月18日確認)https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll
関連ページ
FAQ
GitHubでsitemap.xmlを管理する時の注意点は初心者でも確認できますか?
はい。専門用語を覚える前に、何を確認すればよいかを優先して整理しています。
CodexやChatGPTを使う場合も同じ考え方ですか?
基本は同じです。自動化できる部分が増えても、差分確認、秘密情報確認、公開前確認は人間側で見ます。
秘密情報が混ざったかもしれない時はどうしますか?
commitやpushを急がず、対象ファイル、公開範囲、履歴への混入有無を確認します。必要に応じてキーやパスワードを無効化します。
GitHubの機能や画面は変わりますか?
変わる可能性があります。重要な判断や最新仕様はGitHub側の情報も確認してください。
このカテゴリの親ハブ
関連ページをまとめて確認する場合は、サイト運営ハブ から読み進められます。