スマホから自宅PCに指示を出す「Discord Bot」の仕組みと導入手順

ポート開放不要。チャットアプリを「自宅PCのリモコン兼通知窓口」にする

題材:自宅PCで動かしているバス遅延通知Bot(Python / discord.py 2.7.1)。コード一式は GitHub で公開している。

背景:自宅PCの処理を、外出先から呼び出したい

バスの遅延情報を取得するPythonプログラムは、自宅PCで動かしている。クラウド(GAS)から取得しようとするとアクセスを拒否されたため、家庭用回線から取得する構成にした。

残る課題は「外出先からどう呼び出し、結果をどう受け取るか」である。自宅PCで小さなWebサーバーを立てる方法は、ルーターのポート開放や固定IPが必要になり、外部に入口を開けることにもなる。

外部から操作する方法としては、Discord Bot、GitHub Actions のセルフホストランナー、GAS+スプレッドシートのフラグ、Tailscale+Webフレームワーク、スマホ単体(iOSショートカット等)が候補に挙がった。このうち採用したのが Discord Bot である。

Discord と Discord Bot とは

Discord は、無料で使えるチャットアプリである。「サーバー」と呼ばれるグループを誰でも作れ、その中に話題ごとの「チャンネル」を置ける。自分ひとりだけのサーバーを作り、個人用の通知置き場として使うこともできる。

Discord Bot は、プログラムが操作する Discord のアカウントである。人がチャンネルで「/bus」のようなコマンドを打つと、Bot がそれを受け取って処理し、結果をメッセージとして返す。Bot の側から、任意のタイミングでメッセージを送ることもできる。

Webhook ではなく Bot を選んだ理由

Discord には、決められたURLに送るだけでチャンネルに投稿できる Webhook という仕組みもある。設定は Bot より簡単だが、送ることしかできない。今回は「コマンドを打ったら、遅延の有無にかかわらず今の一覧を返す」「定期監視中は、遅延が10分以上のときだけ通知する」という2つの動きが必要だったため、コマンドを受け取れる Bot を選んだ。

仕組み:なぜポート開放が要らないのか

Bot のプログラムは、自宅PCから Discord のサーバーへ自分から接続しに行き、その接続を保ち続ける。スマホで打ったコマンドは Discord のサーバーを経由し、この接続を通って自宅PCに届く。

通信は常に「自宅PC → Discord」の外向きで始まるため、家庭用ルーターの設定を変える必要がない。外部から自宅PCに直接つながる入口も作らない。

スマホ(Discordアプリ)
   │ /bus と入力
   ▼
Discord のサーバー
   ▲ 自宅PCから張った接続を通じてコマンドが届く
   │
自宅PC(Python の Bot)── 接近情報ページを取得・解析
   │
   └─ 結果を Discord へ送信 → スマホに表示・通知

Bot のコマンドで実行されるのは「決められたページを取得して解析する」ことと「監視のON/OFFを切り替える」ことだけである。任意の命令を受け付けて実行する経路は、コード上に持たせていない。

導入手順

  • 1
    自分用のサーバーを作る
    Discord アプリでサーバーを新規作成し、通知を受け取るチャンネルを用意する。自分しかいないサーバーでよい。
  • 2
    Developer Portal で Bot を作り、トークンを控える
    Discord Developer Portal で新しいアプリケーションを作成し、Bot の設定画面でトークンを発行する。トークンは Bot としてログインするための合言葉で、知られると Bot を乗っ取られる。画面に表示されたら、すぐに手元の設定ファイルへ移す。
  • 3
    招待URLを発行し、自分のサーバーに Bot を招く
    OAuth2 の URL Generator で、スコープに bot と applications.commands を選ぶ。後者は、スラッシュコマンドを登録するために必要である。権限は View Channels(チャンネルの閲覧)と Send Messages(メッセージの送信)があれば足りる。生成されたURLをブラウザで開き、手順1のサーバーを選んで承認する。
  • 4
    各種IDを控える(任意)
    Discord の「設定 → 詳細設定 → 開発者モード」をONにすると、サーバー・チャンネル・ユーザーを右クリックしてIDをコピーできる。サーバーIDはコマンドの即時反映、チャンネルIDは通知先の固定、ユーザーIDは操作できる人の制限に使う。
  • 5
    Python の専用環境(venv)を作り、ライブラリを入れる
    venv はプロジェクト専用のPython環境である。PC全体の環境を汚さずに、必要なライブラリ(requests / discord.py / python-dotenv)だけを入れられる。Python は 3.9 以上を想定している(動作確認は 3.15 のみ)。
  • 6
    設定ファイル(.env)を書いて起動する
    トークンや各種IDは、コードに直接書かず python/.env に書く。起動後、スマホの Discord で /bus を打ち、一覧が返ってくれば接続は成功である。

環境構築コマンドと設定ファイル

プロジェクトのフォルダで、次を順に実行する(Windows の PowerShell の例)。

# 専用環境を作って有効化
python -m venv .venv
.venv\Scripts\Activate.ps1

# ライブラリを導入(requests / discord.py / python-dotenv)
pip install -r python\requirements.txt

# 設定ファイルの雛形をコピー(コピー後の .env に値を書く)
Copy-Item python\.env.example python\.env

# Bot を起動(止めるまで常駐する)
python python\discord_bot.py

python/.env の書き方は次のとおり。[ ] の部分を自分の値に置き換える。

# 必須:Developer Portal で発行したトークン
DISCORD_BOT_TOKEN=[Botのトークン]

# 必須:監視対象の接近情報ページ(既定のURLはない)
BUS_URL=https://.../approachings?departure-busstop=[出発ID]&arrival-busstop=[到着ID]

# 任意:指定するとスラッシュコマンドがそのサーバーに即時反映される
DISCORD_GUILD_ID=[サーバーID]

# 任意:通知先チャンネル。未設定なら /watch を実行したチャンネルに通知
ALERT_CHANNEL_ID=[チャンネルID]

# 任意:/watch・/stop を実行できるユーザー(カンマ区切り)。未設定なら誰でも可
ALLOWED_USER_IDS=[自分のユーザーID]

# 任意:通知する遅延の分数と、監視の間隔(分)
THRESHOLD_MIN=10
MONITOR_INTERVAL_MIN=5

.env は .gitignore に登録し、GitHub 等に公開しない。トークンを誤って公開・共有した場合は、Developer Portal でトークンを再発行(Reset Token)すれば、古いトークンは使えなくなる。

Bot 本体の骨格(discord.py)

実際の Bot から、Discord とやり取りする部分だけを抜き出して簡略化したものである。取得・解析と通知文の整形は別のモジュールに分けている。

import asyncio
import os

import discord
from discord import app_commands
from discord.ext import tasks
from dotenv import load_dotenv

import alerts, fetch_bus  # 自作モジュール(通知文の整形 / ページの取得・解析)

load_dotenv(os.path.join(os.path.dirname(__file__), ".env"))  # python/.env を読む
TOKEN = os.environ.get("DISCORD_BOT_TOKEN", "").strip()
GUILD_ID = int(os.environ.get("DISCORD_GUILD_ID") or 0)
BUS_URL = os.environ.get("BUS_URL", "").strip()


class BusBot(discord.Client):
    def __init__(self):
        super().__init__(intents=discord.Intents.default())  # 特権インテントは不要
        self.tree = app_commands.CommandTree(self)

    async def setup_hook(self):
        if GUILD_ID:
            guild = discord.Object(id=GUILD_ID)
            self.tree.copy_global_to(guild=guild)
            await self.tree.sync(guild=guild)  # 指定サーバーに即時反映
        else:
            await self.tree.sync()  # グローバル反映は最大1時間ほどかかる
        monitor.start()


bot = BusBot()


@bot.tree.command(name="bus", description="今の接近バスと遅延を表示します")
async def bus_command(interaction: discord.Interaction):
    await interaction.response.defer(thinking=True)  # 「考え中」を先に返す
    result = await asyncio.to_thread(fetch_bus.fetch_result, BUS_URL)  # 取得は別スレッド
    await interaction.followup.send(alerts.format_result(result))


@tasks.loop(minutes=5)
async def monitor():
    ...  # 監視ONのときだけ取得し、閾値以上の遅延があればチャンネルへ送信


bot.run(TOKEN)

技術的効果とメカニズム

  • スラッシュコマンドなら特権インテントが要らない:
    「!bus」のようにメッセージ本文を読んで反応する方式では、Developer Portal で Message Content Intent(メッセージ本文を読む特権)をONにする必要がある。スラッシュコマンドは Discord 側がコマンドとして Bot に届けるため、Intents.default() のままで動く。Bot に渡す権限を最小限にできる。
  • コマンド登録は起動時に同期する:
    setup_hook で、コードに定義したコマンドを Discord に登録する。サーバーIDを指定するとそのサーバーにだけ即時に反映され、指定しないと全体への反映に最大1時間ほどかかる。個人用の Bot なら、サーバーIDを指定しておくほうが確認しやすい。
  • 時間のかかる処理は「先に受付・後で回答」:
    スラッシュコマンドには短時間で応答する必要がある。ページの取得には時間がかかることがあるため、defer で先に「考え中」の表示を返し、結果は followup で後から送る。
  • 取得処理を別スレッドで動かす:
    requests による取得は、終わるまでプログラムを止めてしまう。asyncio.to_thread で別スレッドに逃がすことで、取得中も Discord との接続や他のコマンド受付が止まらない。
  • 定期監視はタスクループで回す:
    tasks.loop で一定間隔(既定5分)の処理を Bot の中に持てる。外部のスケジューラは不要である。監視のON/OFFと通知先はファイル(state.json)に保存しており、Bot を再起動しても状態が残る。一時的な取得失敗はログに残すだけで、ループは止めない。

導入時のつまずきと対処

  • 1
    起動すると「DISCORD_BOT_TOKEN が未設定」と出る
    Bot が読み込むのは python/.env である。雛形の .env.example に値を書いても読まれない。雛形をコピーして .env を作り、そこに値を書く。
  • 2
    AIによって手順が違う
    Gemini は「!bus」形式のコマンドと Message Content Intent のONを案内したが、実装はスラッシュコマンドで、特権インテントは不要だった。手順を聞いたAIと、コードを書いたAIが別の場合は、実際に動かすコードの側に合わせる。
  • 3
    コマンドが Discord に出てこない
    サーバーIDを指定しない場合、コマンドの反映に最大1時間ほどかかることがある。DISCORD_GUILD_ID を指定して再起動すると、そのサーバーに即時に反映される。
  • 4
    トークンをAIとの会話やメモに貼ってしまう
    設定内容を相談するときに、トークンやIDを伏せずに貼り付けると、会話ログやメモアプリに平文で残る。貼り付ける前に伏せ字にし、残ってしまった場合はトークンを再発行する。

運用上の注意

Bot は自宅PCで動いているあいだだけ応答する。PCのスリープや再起動、プログラムの停止中は、コマンドにも応答せず、通知も届かない。

ALLOWED_USER_IDS を設定すると、監視の開始・停止(/watch・/stop)を指定したユーザーだけに制限できる。一覧の表示(/bus)は制限の対象外である。

※本ページは、Webページの仕組みを個人で検証した記録である。対象サイトのURLや識別番号は伏せている。相手のサーバーの負担にならないよう、取得は5分間隔を基本とし、監視は必要なときだけ動かしている。試す場合も個人の検証の範囲にとどめること。サービス側の仕様変更により動かなくなる可能性がある。