あしたの転機観測所

https://ashitano-tenki.github.io/

キャリアの転機に役立つ民間のサービスや情報を、転機の種類と時期から探せるサイトです。スプレッドシート「あしたの転機観測所 データベース」の 公開用 タブ（ウェブに公開したCSV）を毎日読み込み、サイトを作り直しています。

自動更新

• 毎日、日本時間の朝5時ごろに自動で更新します（GitHub Actions の「サイトを更新」）。
• 手動で更新するときは、リポジトリの「Actions」タブ →「サイトを更新」→「Run workflow」を押します。
• CSVを取得できないとき、掲載中が0件のとき、前回の半分未満に減ったときは公開を止め、前回のサイトをそのまま残します。データを意図して大きく減らしたときは、手動実行の画面で「件数が前回の半分未満に減っても公開する」に印を付けて実行します。

リンク切れの点検

• 毎週月曜の朝6時、掲載中（状態が「確認済み」「要更新」）のURLを自動で開いて確かめます（GitHub Actions の「リンク切れの点検」。手動でも実行できます）。
• 結果は 正常／移転／拒否／要確認 の4つに分け、https://ashitano-tenki.github.io/linkcheck.json に公開します（正常以外の行だけを載せます）。データ側の定期実行がこれを読んで、壊れたリンクを直します。
• 要確認があったときは、リポジトリの「Issues」にも報告を作ります。Issue ができると、GitHub アカウントのメールに通知が届きます。
• サイトの掲載は自動では変えません。

掲載先の画像

• 毎朝の「サイトを更新」で、サイトを作る前に tools/fetch_images.py が、掲載先の公式ページに設定されているシェア用の画像（OGP画像）を取得します。縮小して images/items/ に保存し、紹介ページ（タイトルの上）とカード（上の横長の枠）に出します。
• 取得するのは、まだ確かめていない掲載・取得から30日たったもの・取れなかったもので7日たったものだけです（1回60件まで、同じサイトには間をあけます）。結果は data/images.json に残ります。
• 本（URLにISBNがあるもの）は、どの書店のページでも紀伊國屋書店の表紙画像を使います（書店のページの画像は店のロゴのことが多いため）。
• URLにISBNがない本（電子書籍のページなど）は、書名から国立国会図書館サーチの公開検索でISBNを引き、表紙を取ります。書名の本題・副題が掲載の書名と合うものだけを使います。
• 本の表紙がISBNで取れないとき（紀伊國屋にない本）は、ふつうにページを読みます。楽天市場の本（item.rakuten.co.jp/book/番号）は自動の取得を断るので、同じ番号の楽天ブックスのページ（books.rakuten.co.jp/rb/番号）から表紙を取ります。
• ちがう掲載なのに同じ画像になったものは「サイト共通の画像」として使わず、作業ページで画像を頼みます。トップ以外のページなのにサイト共通らしい画像（ogp・logo・default などの名前）は「確認したいもの」として作業ページに出し、合っていれば config/site.json の image_keep に入ります。
• 紀伊國屋書店の本（ISBNから表紙の場所が決まる）、Spotify の番組（公式の oEmbed）、YouTube の動画（サムネイル）は、ページを読まずに画像を取ります。
• 画像がないものは、タイプの絵文字を同じ枠に出します。
• 短い辺が200px未満の小さな画像は「small」として、画像あつめで大きな画像をお願いします。
• 紹介ページごとの共有画像（SNSでシェアしたときの画像）は、毎朝 tools/make_item_og.py がタイトル・タイプ・転機から作ります（og-items/、リポジトリには入れない）。
• 自動で取れないものは、作業ページ「観測所の画像あつめ」（https://claude.ai/artifact/JjtpaqzyTvauJNwfQvZdXx ）で画像のURLを入れ、Claude Code に渡します。渡したURLは config/image_overrides.json（{"ID": "画像のURL"}）に入り、公式ページを読まずにその画像を使います。作業ページでアップロードした画像（キャプチャなど）は images/manual/ に置き、{"ID": "file:images/manual/ID.png"} の形で同じように使います。
• おすすめ順は、画像があるものを先に、そのなかで観測スコアの高い順です（「観測所について」の並び順の考え方にも書いています）。
• 掲載先から申し出があったときなど、画像を使いたくない掲載は config/site.json の image_exclude にIDを書きます（例：["R0007"]）。次の更新で画像が消えます。

ファイルの役割

ファイル	中身
config/site.json	サイト名、説明文、CSVのURL、誤り報告フォームのURL、noteとFacebookグループのURL、新着の日数、掛け合わせページを作る最低件数、種類（タイプ）の一覧（表示順・説明文・絵文字・リンクの文言）など。ここにない種類のデータは表示しない
config/tenki.json	転機の種類と段階の名前・URL・ページの文面
config/tenki_notes.json	転機別ページと、転機×段階のページに載せる解説文
config/synonyms.json	検索の言い換え表（毎朝の更新で、言葉と掲載に漢字の読みを足すので、ひらがなでも探せる）
build.py	サイトを作るスクリプト（ページの文面の多くもここにあります）
check/index.html	転機の段階セルフチェック（/check/）。質問・判定・結果の文章はこのファイルにあります。結果画面のおすすめは、サイトを作るたびに書き出す check/picks.json から選びます
assets/	見た目（style.css）、検索の動き（search.js）、アイコン、SNS共有用の画像
assets/og/	転機別ページと掛け合わせページのSNS共有用画像。config/tenki.json の名前や見出しを変えたら、Macで python3 tools/make_og_images.py を実行して作り直す
data/meta.json	前回公開したときの件数（件数チェックに使います）
data/linkcheck.json	毎週のリンク点検の結果（サイトでは /linkcheck.json として公開）
data/images.json・images/items/	掲載先の画像の取得結果と、縮小した画像（{ID}.webp は紹介ページ用、{ID}-s.webp はカードの上の画像用（軽い WebP 形式））
data/latest.csv	毎日読み込んだデータの写し（観測スコアの列は除く）。履歴から、何がいつ変わったかを確かめられます

手元で試す

python3 build.py
python3 -m http.server 8765 --directory _site

画像の出典

ロゴ・ファビコン・SNS共有用画像の📡は、Google の Noto Emoji（Apache License 2.0）の画像を使っています。