Codexで404だった
候補URLを
内部リンクから
除外した実践ログ

今回やった作業

説明guideや関連記事導線を追加する際に、関連リンク候補のURLを確認し、404だったURLをリンク候補から除外した作業を一般化します。

内部リンクを増やすこと自体は大事ですが、未作成URLや404 URLを追加すると、読者に壊れた導線を見せることになります。今回は200 OKのURLだけを採用する方針にしました。

作業前の状態

関連リンク候補が複数ありました。候補の中に未作成URLや404 URLが含まれている可能性があり、内部リンクを増やしたい一方で、404リンクは増やしたくない状態でした。

404だった場合に新規ページ作成まで広げるか、今回は除外するか判断が必要でした。今回の作業では、リンク追加の範囲を守り、未作成ページ作成には広げません。

作業前に問題だったこと

関連リンク候補は、名前だけ見ると存在しそうに見えることがあります。しかし、実際にHTTP確認すると404の場合があります。

そうしたURLをそのまま追加すると、ユーザーはリンク先で404を見ることになります。内部リンクは本数よりも、リンク先が実在していて文脈に合っていることが重要です。

Codexに任せたこと

Codexには、リンク候補の列挙、curl -IによるHTTP確認、404 URLの除外、200 OK URLのみ採用、公開HTML確認を任せます。

さらに、404候補が公開HTMLに残っていないか、必要なら「今回は入れない」と報告することも含めます。404だからといって、その場で新規ページ作成へ広げないようにします。

人間が判断したこと

人間が判断したのは、404 URLは採用しないこと、404だからといってその場で新規ページを作らないこと、今回はリンクから外す判断もあることです。

200 OKのリンクだけを採用し、未作成URLを無理に追加しません。将来必要なら、別オーダーでページ作成や導線設計を行います。

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

指示文では「関連リンク候補はすべてHTTP確認し、404だったURLは採用しないでください」と明記します。さらに「未作成URLを作る作業に広げないでください」と入れることで、作業範囲を守ります。

作業後には、公開HTMLに404候補が残っていないか、リンク文言とリンク先が一致しているかを確認させます。

うまくいった点

404候補をリンクから外したことで、壊れた内部リンクを増やさずに済みました。200 OKだけを採用する方針にしたため、読者がクリックした先で迷うリスクを減らせます。

また、今回は入れないという判断を報告に残すことで、後から必要になった時に別作業として扱いやすくなります。

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

危なかったのは、似たURLへ勝手に差し替えることです。URLが似ていても、リンク文言とリンク先の内容が一致していなければ読者を迷わせます。

また、404だったURLを見つけた勢いで新規ページ作成まで始めると、作業範囲が広がります。リンク追加作業とページ作成作業は分けた方が安全です。

作業後に確認したこと

作業後には、候補URLを確認したこと、404 URLを除外したこと、200 OKだけ採用したこと、公開HTMLに404候補がないことを確認します。

未作成URLを追加していないこと、新規ページ作成に広げていないこと、リンク文言とリンク先が一致していること、canonicalとrobotsが維持されていることも報告します。

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

関連リンク候補はすべてHTTP確認し、404だったURLは採用しないでください。
必要なら「今回は入れない」と報告してください。
未作成URLを作る作業に広げないでください。
200 OKのURLだけを採用し、作業後に公開HTMLに404候補が残っていないか確認してください。

確認チェックリスト

□ 候補URLを確認
□ 404 URLを除外
□ 200 OKだけ採用
□ 公開HTMLに404候補なし
□ 未作成URLを追加していない
□ 新規ページ作成に広げていない
□ リンク文言とリンク先が一致
□ canonical / robots維持

関連する使い方ガイド

今回の確認は、公開HTML確認、対象外ページ確認、内部リンク確認、ランキングページ改善の考え方とつながります。必要に応じて、以下の関連ページも確認してください。

注意書き

この記事は特定の公式手順ではなく、公開中サイトでCodex作業を安全に進めるための実践ログです。実際の案件名、内部情報、サーバー情報、秘密情報は掲載していません。