Bus Delay Bot
バスの接近情報ページに埋め込まれた運行データを読み取り、遅れが大きいときだけDiscordに通知する、自宅PC常駐型のPython製Discord Botです。有料APIもクラウドサーバーも使わず、ルーターのポート開放もせずに外出先から操作できます。

Background
なぜ作ったのか(開発の動機)
駅を降りる前に「今日はバスが詰まっている」と知りたい
開発のきっかけは、Noteの記事に書いた日常の困りごとです。
会社からの帰宅時、駅からバスで帰ろうとすると、普段なら10分ほどで着くところが30分以上かかることがある。
このバスは交通量の多い国道を通る。ひとたび事故があると、収拾がつかなくなる。
駅を降りる前に「今日はバスが詰まっている」と分かれば、別の帰り方を選べる。その情報をスマホで受け取れないか。
歩く、シェアサイクルを使う、もう一つの最寄り駅から帰る。代わりの手段はあるので、判断材料さえ駅を降りる前に届けばよい、というのが出発点です。(Note記事を読む)
個人開発の割り切り:クレカ登録が必要なAPIは使わない
渋滞の度合いを所要時間で取れる地図系のAPIは、登録にクレジットカードが必要だったため見送りました。代わりに、バス会社が公開している接近情報ページを使うことを検討しました。「あと何分で来るか」「何分遅れているか」が表示される、利用者向けのページです。
Features
特徴
HTMLに埋め込まれた運行データを直接解析
バスの接近情報ページは、画面に表示する運行データをページ自体の中に持っています。専用のAPIを探す代わりに、そのデータを読み解いて定刻・到着予測・遅れの分数を取り出します。
取得もBotも自宅PCで完結
クラウド(GAS)からの取得はアクセス拒否(HTTP 403)されたため、取得役は自宅PCに置きました。外出先からの操作は、自宅PCからDiscordへ外向きに接続するBotにすることで、ポート開放や固定IPを不要にしています。
スラッシュコマンドで外出先から操作
/bus で今の接近バス一覧を毎回返信、/watch で定期監視を開始、/stop で停止します。監視のON/OFFはファイルに保存するため、Botを再起動しても状態が残ります。
通知しすぎない判定ロジック
定期監視中は遅れが閾値(既定10分)以上の便だけを通知します。同じ便は1回のみ、前回より5分以上悪化したときだけ再通知し、記録は3時間で破棄します。遅れの大きさは🟢🟡🔴で色分けします。
Architecture & Flow
構成要素と処理の流れ
Botが外から受け付けるのは「決められたページを取得して解析する」ことと「監視のON/OFFを切り替える」ことだけです。任意の命令を実行する経路は持たせていません。
フローA: 取得(自宅PCのPython)
自宅の回線から、requests で接近情報ページのHTMLを取得します。
フローB: 復元と抽出
取得したページの中から運行データの部分を切り出し、読める形に戻します。そのうえで「路線名・遅れ・到着予測がそろっている箇所」を探して取り出します。ページの作りが多少変わっても動くよう、データの置き場所は決め打ちしていません。
フローC: Discord連携
discord.py のスラッシュコマンドとタスクループ(既定5分間隔)で動きます。取得処理は別スレッドで実行し、一時的な取得失敗ではループを止めません。
状態と権限の管理
監視のON/OFFと通知先チャンネルを state.json に保存します。ALLOWED_USER_IDS を設定すると、/watch と /stop を指定ユーザーだけに制限できます。
Requirements
必要なもの
動作に必要な環境です。監視対象は https://.../approachings?departure-busstop=[出発ID]&arrival-busstop=[到着ID] の形式の接近情報ページです。既定のURLはないため、各自の利用区間のURLを設定してください。相手サーバーへの負荷を考え、取得は5分間隔を基本とし、個人検証の範囲でご利用ください。
Python 3.9 以上と venv
requests / discord.py / python-dotenv を使用します(Python 3.9 以上を想定。動作確認は Python 3.15、discord.py 2.7.1 のみ)。venv でプロジェクト専用の環境を作って動かします。
Discord Bot(Developer Portal)
Botを作成し、bot と applications.commands のスコープで自分のサーバーに招待します。スラッシュコマンドのため特権インテントは不要です。トークンは python/.env に置き、公開しないでください。
常時起動の自宅PC(家庭用回線)
クラウドからの取得は拒否されるため、自宅の回線から取得します。Botのプロセスが止まっているとコマンドにも応答しません。
利用上の注意
本作例はWebページの仕組みを個人で検証した記録です。過度なアクセスは避け、サービス側の仕様変更で動かなくなる可能性がある点をご了承ください。
e-Shikumi-labo