Discord X Auto Importer

Eagle の Window Plugin です。Discord の指定チャンネルを Bot で監視し、投稿本文に x.com または twitter.com のポスト URL が含まれていた場合、そのポストの画像を Eagle ライブラリへ自動追加します。

できること

• Discord Gateway を使ったリアルタイム監視
• 再接続時に未接続期間のメッセージを補完取り込み
• 指定チャンネル ID のみを対象にフィルタ
• X ポスト URL を抽出し、画像メディアを Eagle に追加
• Eagle フォルダ自動作成
• website を元ポスト URL にして重複取り込みを回避
• 設定と処理済み履歴を Eagle の user data 配下に保存

前提

• Eagle Desktop がインストール済みであること
• 監視用 Discord Bot を作成済みであること
• Bot に以下の権限・Intents を付与していること
  • GUILDS
  • GUILD_MESSAGES
  • MESSAGE_CONTENT
• Bot に対象チャンネルの View Channel と Read Message History 権限があること
• Bot が対象サーバーに参加済みで、対象チャンネルを閲覧できること

セットアップ

1. このフォルダを Eagle のプラグインとして読み込みます。
2. Eagle でプラグインを開き、以下を設定します。
   • Discord Bot Token
   • 監視チャンネル ID
   • Eagle フォルダパス
   • 追加タグ
   • Annotation を追加
3. 接続開始 を押します。

• Eagle フォルダパス を空にすると、特定フォルダを作らず現在のライブラリへ追加します。
• 追加タグ を空にすると、タグは追加しません。
• Annotation を追加 を無効にすると、item の annotation は空のまま取り込みます。

実装メモ

• X メディア取得は公式 X API ではなく、fxtwitter.com / fixupx.com に変換したページの Open Graph 画像メタデータを使います。
• そのため、外部側の仕様変更で動作しなくなる可能性があります。
• 現状は画像ポストを対象にしており、動画本体の保存は行いません。

保存先

設定ファイルと履歴は Eagle の userData/plugins/discord-x-auto-importer/ 以下に保存されます。