Practical log guide

Codexでcanonicalのズレを調査して最小修正した実践ログ

canonicalは正規URLを検索エンジンへ伝える重要なタグです。この実践ログ型ガイドでは、内部リンクとcanonicalの向きがズレている状態をすぐ修正せず、表示差分・内部リンク・sitemap・出力箇所を調査してから最小修正する流れを整理します。

当サイトはOpenAI公式サイトではありません。Codexの使い方を実体験ベースで整理する非公式ガイドです。最新の仕様・料金・対応プランはOpenAI公式情報をご確認ください。

この記事は2026年5月時点の情報をもとに整理しています。Codex、ChatGPT、GitHub、Google関連サービスの仕様は変更される可能性があります。

今回やった作業

公開中サイトで、canonicalの向きと内部リンクの向きがズレていないかを調査し、必要な場合だけ最小修正した作業を一般化します。内部リンクはパラメータなしURLに集まっているのに、canonicalがパラメータ付きURLへ向いている状態が見つかることがあります。

この状態では、ユーザーや内部リンクが向いているURLと、検索エンジンへ伝える正規URLがズレる可能性があります。

作業前の状態

作業前は、内部リンクはパラメータなしURLへ集まっていました。一方で、canonicalはパラメータ付きURLへ向いていました。

表示内容が同じであれば、どちらを正規URLとして扱うかを整理する必要があります。ただし、理由があってパラメータ付きURLを正規化している場合もあるため、すぐ修正しないことが大切です。

作業前に問題だったこと

canonicalは検索エンジンへ正規URLを伝える重要なタグです。内部リンクが向いているURLとcanonicalが向いているURLがズレると、どのURLを評価してほしいのか伝わりにくくなります。

ただし、canonicalは理由があってその向きになっている場合もあります。表示差分や内部リンク、sitemap、出力箇所を確認せずに直すと、逆に意図したURL設計を壊す可能性があります。

Codexに任せたこと

Codexには、2つのURLのHTTP状態、表示差分、title、description、H1、robots、canonical、canonical出力箇所を確認させます。

さらに、内部リンクがどちらへ向いているか、sitemapにどちらが載っているか、パラメータ付きURLを正規にしている意図があるかを調査させます。

人間が判断したこと

人間が判断したのは、表示が同一かどうか、内部リンクがどちらへ集まっているか、sitemapに載せているURLはどちらか、パラメータ付きURLを正規化する明確な理由があるかです。

修正する場合でも、title、H1、robots、表示内容は触らず、canonicalのみ最小修正する方針にします。

実際に使った指示文の考え方

指示文では、まず調査のみ行い、修正しないことを明記します。HTTP状態、表示差分、内部リンク、sitemap掲載状況、出力箇所を整理してから、必要な場合だけ最小修正を提案させます。

canonicalは小さなタグに見えますが、URL評価の向きに関わるため、理由を確認してから進めるのが安全です。

うまくいった点

うまくいった点は、いきなり修正せず、内部リンクとsitemapの向きを確認してから判断できたことです。正規URLの判断材料をそろえると、canonicalだけを最小修正する理由が明確になります。

詰まった点・危なかった点

危なかった点は、canonicalのズレを見つけた瞬間に反射的に直してしまうことです。パラメータ付きURLに意味がある場合や、表示差分がある場合は、単純にパラメータなしへ寄せるだけでは危険です。

作業後に確認したこと

作業後は、両方のURLが200 OKか、表示差分、title、description、H1、robots、canonicalを確認します。内部リンクの向き、sitemap掲載状況、canonical出力箇所も見ます。

修正する場合はcanonicalのみを対象にし、title、H1、robots、表示内容を変えていないことを確認します。

次から使える指示文テンプレート

以下の2つのURLについて、canonicalの向きが適切か確認してください。

確認することは、
HTTP状態、title、description、H1、robots、canonical、表示差分、内部リンクの向き、sitemap掲載状況、canonical出力箇所です。

今回は調査のみ行い、修正しないでください。

表示内容が同一で、内部リンクがパラメータなしURLに集まっており、パラメータ付きURLを正規化する理由がない場合だけ、次の実装フェーズでcanonicalの最小修正を提案してください。

確認チェックリスト

  • 両方のURLが200 OK
  • 表示差分を確認した
  • title / description / H1を確認した
  • robotsを確認した
  • canonicalを確認した
  • 内部リンクの向きを確認した
  • sitemap掲載状況を確認した
  • canonical出力箇所を確認した
  • 修正する場合はcanonicalのみ
  • title / H1 / robots / 表示内容を変えていない

まとめ

canonicalのズレは、見つけた瞬間に直すのではなく、まず理由を確認するのが安全です。内部リンク、sitemap、表示差分、出力箇所を見て、正規URLとして自然な向きを判断します。

修正が必要な場合も、title、H1、robots、表示内容を触らず、canonicalだけを最小修正することで、影響範囲を小さくできます。

注意書き

この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。作業対象サイトの条件や利用しているサービスの仕様は変わるため、実際に作業する前には現在の環境と公式情報を確認してください。