Codexでcanonicalを
いきなり直さず
方針確認した
実践ログ

今回やった作業

canonicalに違和感があるURLについて、いきなり修正せず、まず調査だけを行った作業を一般化して整理します。canonicalは検索エンジンに正規URLを伝える重要な要素なので、見た目の違和感だけで修正すると、意図的なURL設計を壊す可能性があります。

この作業では、対象URLとcanonical先URLの両方を確認し、表示内容、title、H1、robots、内部リンク、sitemap掲載、出力箇所を比較しました。調査Codexと実装Codexを分け、今回は修正に進まず、方針確認と最小修正案の整理で止める判断にしました。

作業前の状態

対象URLのcanonicalに違和感がありました。ただし、それが意図的な設計なのか、偶発的なズレなのかは分かりませんでした。カテゴリURL、一覧URL、query付きURL、ページネーション、別名URLでは、canonicalを別URLへ寄せる設計があり得ます。

対象URLとcanonical先の表示内容を比較し、内部リンクやsitemapがどちらのURLを指しているか確認する必要がありました。canonicalの出力箇所も確認し、共通テンプレートなのかページ固有の設定なのかを切り分ける必要がありました。

作業前に問題だったこと

canonicalのズレに見えるものが、必ずしもバグとは限りません。正規URLを別URLへ寄せることで、重複ページや条件違いページを整理している場合があります。そこを確認せずに自己URLへ変えると、既存の設計と矛盾する可能性があります。

逆に、偶発的なズレを放置すると、内部リンクやsitemapが示すURLとcanonicalの意図が合わなくなります。だからこそ、修正するか維持するかを決める前に、表示差分と周辺構造を確認することが大切です。

Codexに任せたこと

Codexには、対象URLのHTTP確認、canonical先URLのHTTP確認、2URLの表示内容比較、title、H1、robots、内部リンク先、sitemap掲載、canonical出力箇所の確認を任せます。あわせて、意図的な設計か偶発的なズレかの推定も出させます。

大切なのは、調査と実装を分けることです。Codexにいきなり修正させるのではなく、今回は調査だけ、修正する場合は次フェーズと指定します。修正が必要な場合も、canonicalだけに限定するのか、内部リンクやsitemapも合わせるのかを人間が判断します。

人間が判断したこと

人間が判断したのは、canonicalを即修正しないことです。まず調査Codexとして分け、意図的な設計なら維持し、偶発的なズレなら正規URLへ寄せる方針にします。titleやH1まで一緒に触ると影響範囲が広がるため、修正する場合も対象を絞ります。

canonicalだけ見て判断せず、内部リンクやsitemapとの整合性を見ることも人間側の判断です。Codexの報告は便利ですが、正規URLの方針はサイト全体の構造に関わるため、最終判断は人間が持ちます。

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

指示文では「canonicalに違和感があるので直してください」とは書きません。まず調査のみ、対象URLとcanonical先のHTTP、表示内容、title、H1、robots、内部リンク、sitemap、出力箇所を確認してください、と具体化します。

また、今回は修正せず、調査結果と最小修正案だけを出すことを明記します。これにより、Codexが親切心でcanonicalを書き換えたり、周辺テンプレートまで変更したりする事故を避けやすくなります。

うまくいった点

canonicalを推測で変えず、設計かズレかを確認する流れにできました。対象URLとcanonical先URLの両方を見たことで、URLの役割や表示差分を判断しやすくなりました。

内部リンクやsitemapまで確認することで、canonicalだけを孤立したタグとして扱わず、サイト構造の中で判断できます。修正フェーズを分けたことも、事故防止に役立ちました。

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

canonicalは画面上に見えにくいため、違和感があっても気づきにくい一方で、見つけた時にすぐ直したくなります。そこが危険です。別名URLやquery付きURLでは、意図的にcanonicalを寄せている場合があります。

また、canonical出力箇所が共通部品にある場合、1ページだけのつもりが複数ページへ影響する可能性があります。調査なしに編集すると、正規URL方針を広範囲で変えてしまうことがあります。

作業後に確認したこと

作業後には、canonical先が200 OKであること、対象URLが200 OKであること、表示差分、title、H1、robots、内部リンク先、sitemap掲載、canonical出力箇所を確認します。意図的か偶発的かの判断も報告に残します。

今回は実装を別フェーズにしたことも確認項目です。修正していないこと、DB、cron、設定ファイル、広告タグに触れていないことも報告に入れます。

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

次回同じ作業をCodexに頼む時は、作業範囲と停止条件を明確にして依頼します。

canonicalに違和感があるURLについて、まず調査のみ行ってください。
対象URLとcanonical先のHTTP、表示内容、title、H1、robots、内部リンク、sitemap、canonicalの出力箇所を確認してください。
意図的な設計か偶発的なズレか判断してください。
今回は修正せず、調査結果と最小修正案だけを出してください。
修正が必要な場合も、実装は次フェーズに分けてください。
DB、cron、.htaccess、robots.txt、ads.txt、広告タグ、Search Console確認タグは触らないでください。

確認チェックリスト

作業後は、以下の項目を確認します。確認した内容を報告書に残すことで、次の作業へ安全につなげられます。

• canonical先が200 OK
• 対象URLが200 OK
• 表示差分を確認した
• title / H1を確認した
• robotsを確認した
• 内部リンク先を確認した
• sitemap掲載を確認した
• canonical出力箇所を確認した
• 意図的か偶発的か判断した
• 実装は別フェーズにした

関連する使い方ガイド

この作業は、公開前チェック、canonical、sitemap、robots、公開HTML確認、作業報告とつながります。関連ページも合わせて確認すると、Codexへの指示がより具体的になります。

注意書き

この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、秘密情報は掲載していません。特定サイトの公式手順ではなく、公開中サイトでSEO構造やguide表示条件を安全に確認するための実務上の考え方として整理しています。