【Antigravity】「Discord Bot」と連携させて資料の要約自動化フローを構築

Discordに投稿したYouTube動画URLをBotが検知し、Antigravityで要約とMarkdown保存を自動化する仕組みを解説します。Webhookの仕様制限からBot作成、特権インテントの有効化、定期巡回の常駐化手順までを整理しました。

はじめに

スマートフォンやPCのDiscordチャンネルへYouTubeのURLを投稿するだけで、自動的に文字起こしと内容要約を行い、構造化されたMarkdownファイルとして保存する仕組みを構築できます。ナレッジの蓄積と整理を人手を介さずに行えるため、情報収集の効率が大幅に向上します。

この仕組みを実現するには、送信専用であるWebhookの制約を理解し、メッセージ読み取り権限を持つDiscord Botを作成する必要があります。本記事では、Botの作成手順から必要な権限設定、定期巡回の運用方式までを順を追って解説します。

Discordを情報収集の受信箱として機能させる場合、WebhookとBotの技術仕様の違いを把握することが不可欠です。

Webhookは外部サービスからDiscordへメッセージを投稿する送信専用のインターフェースです。チャンネル内の投稿内容を取得する権限を持たないため、ユーザーが投稿したURLを読み取ることができません。

これに対し、Discord BotはGateway APIを経由してチャンネル内の投稿をリアルタイムまたは定期的に取得できます。メッセージの本文を解析し、外部スクリプトと連携して要約処理やファイル送信を実行できます。

処理パイプラインは、Discordチャンネルの監視、YouTube動画の文字起こしと要約、Markdownファイルへの永続化、Discordへの通知という4つの段階で構成されます。

Discordチャンネル内の投稿を取得するために、Discord Developer Portalから専用のBotを作成します。

Botがメッセージのテキスト本文を読み取るためには、特権インテントの許可が必要です。

Botがメッセージの読み取り、返信、リアクション付与を行えるように権限を設定した招待URLを生成します。

個人運用のサーバーで権限管理を簡素化したい場合は、管理者権限（Administrator）を付与することで上記すべての権限をまとめて適用できます。

Botが取得した動画情報は、自動分類およびフォーマット正規化を経て永続化されます。

自動化スクリプトが実行する処理フローは以下の通りです。

Discordのチャンネルを定期的にチェックして自動処理を実行させる方式には、OS標準のデーモンを利用する方法と、作業セッション内のスケジューラを利用する方法の2種類が存在します。

方式	実行基盤	長所	短所
launchd常駐	macOSバックグラウンド	アプリ終了時やPC再起動後も自動で常駐動作する	設定ファイルの登録作業が必要となる
セッション内タイマー	チャット・実行環境内部	チャット上からの指示のみで開始や停止ができる	実行元の環境が起動している間のみ動作する

常時起動している端末が存在する場合はlaunchdによる自動常駐が適しています。作業中のみ並行して巡回させたい場合は、環境内の定期実行コマンドを活用することで柔軟な運用が可能です。