釣りアプリで潮見表ページをビルド時に量産した話(港 SEO)
端末計算と静的 HTML の役割分担。港を増やし、毎日フルビルドはやめた理由。
Angla には、港ごとの潮見表ページがあります。アプリ内では端末が潮汐を計算し、Web では港名から読める静的 HTML も公開しています。港マスタは初期の数十港から全国239港へ増やしました。
この記事では、アプリ画面と検索・共有向けページを分けた理由、港データを増やすときに守ったこと、静的ページを毎日再生成する運用をやめた経緯を説明します。

例: 東京の潮見表。ビルド時に生成する静的 HTML。

潮見表一覧。都道府県と港名からページを辿れる入口。
アプリの画面と静的ページを分ける
Angla アプリの役割は、その場で釣行条件を確かめることです。位置や選択した港を変え、潮汐や天気の表示を操作できる体験を用意します。一方、検索結果や共有リンクから訪れる人には、港名を含む URL で情報へ直接たどり着ける入口が必要でした。
そこで、潮汐計算はアプリの Dart サービスを利用し、Web にはビルド時に港ごとの HTML を生成します。アプリのインタラクティブな操作性と、クローラやリンク先から読めるページを同じ画面に押し込まず、用途を分ける設計です。
静的ページには潮見表だけでなく、Open-Meteo の情報を使った4段階の釣行コンディション表示も含めています。この評価はルールベースで、SNS用に作る日次の釣行スコアとは別の処理です。日次スコアも現在は数式で算出し、AIは文章や時間帯の提案に使っています。静的ページの4段階評価と日次スコアを同じ値としては扱っていません。
港を増やすと、データ管理が課題になる
港の数を増やすと、画面に項目を足すだけでは済みません。港の座標や表示名、潮汐計算に使う対応関係が正しくなければ、ページが存在しても利用者に誤った情報を見せることになります。港データは手で巨大な配列を増やすのではなく、生成した港マスタを使う方針に寄せています。
v1 の数十港から v2 の全国239港へ切り替えた際は、既存港の座標が維持されているか、干満時刻が許容範囲に収まるかをテストしました。表示名を気象庁に近い表記へ変更した港もありました。識別に使うデータと人が画面で読むラベルは別の関心事なので、名前が変わっただけで別の港として扱われないかも確かめます。
港マスタは生成物を正本として扱い、手編集を避けます。変更時は生成元と検証手順を通して、公開ページにも同じデータが反映されるようにします。ページ数を増やすほど、一つひとつのデータが正しいかを手で目視するのは難しくなります。生成方法と回帰チェックを持つことが、拡張後の保守には欠かせません。
ページはビルド時に作り、日々の再生成はしない
静的 HTML はコードや港データを更新してデプロイするときに生成します。以前は潮汐ページを毎日フルビルドする運用もありましたが、日付が変わるたびにコード全体を作り直す必要はありませんでした。アプリ側は端末で潮汐を計算でき、静的ページの更新が必要なのは主にコードや港データを変えたときです。
毎日の再ビルドは GitHub Actions の利用枠も消費していました。日次スコア生成が Actions の月間利用枠を使い切ったことを受け、潮汐ページの定時フルビルドも廃止し、デプロイ時に更新する形へ変更しました。日次スコアは別の必要な定時処理として VPS cron に移しています。移行の背景はGitHub Actions の日次ジョブを VPS cron に移した話にまとめています。
「毎日情報が動くから毎日サイト全体をビルドする」とは限りません。どのデータがいつ更新され、ユーザー体験のどの部分に再生成が必要かを分けて考えました。
SEO ページを作るときの境界
港名を含むページは、地域や港を指定して情報を探す人にとって便利な入口になります。検索向けだからという理由だけで、内容がほとんど変わらないページを増やしても、利用者の役には立ちません。ページを出すなら、港を選ぶ導線、潮汐情報、関連するコンディションなど、その URL で見る意味を持たせる必要があります。
Angla は技術ブログではなく釣りコンディションアプリです。潮見表ページは港の情報を見つける補助線であり、すべての画面を検索記事のように作る必要はありません。アプリを実際に使う体験と、ページを見つけてもらう入口の両方が必要ですが、一つの方式ですべてを解こうとはしていません。
まとめると、潮汐の体験は端末側、検索や共有の入口はビルド時の静的 HTML に分け、港データの拡張は生成とテストで支えています。Angla の全体像は公開までにやったことを参照してください。
ページを作る流れと確かめ方
港の情報を追加するときは、まず港マスタの値が生成できることを確認し、そのデータを使って潮汐計算とページ生成を行います。生成物は港ごとの URL と一覧ページに反映されるため、代表的な既存港と追加した港の両方を確認します。URL が存在するだけでなく、ページに表示された港名が正しく、潮見表や条件表示が読めることが必要です。
v1 から v2 の切り替えで既存港の座標や干満時刻を比較したのも、変更が既存ページへ与える影響を調べるためでした。表示名は変わっても同じ港なら、内部データの対応関係が保たれている必要があります。生成後に差分を確認し、想定外に大量の URL が消えたり別の港へ置き換わったりしていないかも見ます。
こうしたチェックは、港の一覧を人の目で一つずつ見る代わりに、機械で検査できる性質をテストにしておくためです。座標一致や時刻の許容誤差など、何を守るかを明示すれば、データの更新時に同じ基準を使えます。例外的な表記やデータ欠損がある場合は、生成後の画面だけでなく元データへ戻って理由を確認します。
港名から目的の情報へ迷わず行けるようにする
検索ページだけを作ると、個別 URL を知らない人は港を見つけられません。そのため都道府県や港名から辿れる潮見表ハブも用意しています。港名で直接訪れた人が条件を確認する入口と、地域から港を選ぶ入口を両方置くことで、検索とサイト内移動のどちらからでもページを利用できます。
静的ページからアプリの画面へ移る場合は、ページで見ている港とアプリで開く港が食い違わないことも大切です。単にアプリのトップへ送るのではなく、読者が次に何をできるかが自然につながるようにします。ページの価値はインデックスされた URL の数ではなく、港を探し、条件を理解し、必要ならアプリで続けて確認できる流れにあります。
情報の更新頻度をページごとに考える
潮汐や天気は日付とともに変わりますが、港の名前や位置、ページの構造は毎日変わるものではありません。すべてのページを同じ周期で作り直すのではなく、どの値が動的で、どの情報を静的ページに持たせるかを整理します。アプリ内で端末計算する情報と、ビルド時に HTML へ出す情報の境界も、この更新頻度に合わせて考えます。
ページの再生成頻度を下げるなら、古い日付の情報をいつまで見せるかも確認する必要があります。静的ページだけで最新の予報を保証しようとせず、必要ならアプリへ誘導して利用時点の情報を確認できるようにします。静的ページを持つことは、更新責任をなくすことではありません。何をビルド時に固定し、どの情報を利用時に取得するのかを明確にすることです。
また、生成する URL の数が増えるほど、サイトマップや内部リンクも同じデータから一貫して作る必要があります。港マスタにはあるのにリンクがないページ、リンクがあるのに生成されないページが生じないよう、生成ロジックを分散させず、代表 URL と一覧の両方を確認します。