Trendradar

2種類のデプロイモード：

軽量モードの説明：

• ✅ 利用可能：リアルタイムニュースのクローリング、キーワードフィルタリング、ホットキーワードの重み付けソート、現在のランキングの通知
• ❌ 利用不可：新規ニュースの検出(🆕)、ホット度のトレンド追跡、インクリメンタルモード、毎日の集計蓄積、MCP AI分析

完全モードの説明： リモートクラウドストレージを設定すると、すべての機能が有効になります（以下の 推奨設定：リモートクラウドストレージ を参照）。

🚀 推奨：Docker デプロイ

長期的に安定して運用する場合は、Docker デプロイ をお勧めします。データはローカルに保存され、サインインの必要がない代わりに、追加でクラウドサーバーを有料で購入する必要があります。

• 複数アカウントの設定をサポート：すべての通知チャネル（飛書、钉钉、企業微信、Telegram、ntfy、Bark、Slack）は、複数のアカウントを設定できます。
• 設定方法：英語のセミコロン ; で複数のアカウント値を区切ります。
• 例：FEISHU_WEBHOOK_URL の Secret 値に https://webhook1;https://webhook2 と入力します。
• ペア設定：Telegram と ntfy は、ペアパラメーターの数を一致させる必要があります（例：token と chat_id がどちらも2つ）。
• 数量制限：デフォルトでは、各チャネルのアカウント数は最大3つで、それを超えると切り捨てられます。

複数アカウント設定の例：

⚠️ Cloudflare R2 を例とした設定の前提条件：

Cloudflare プラットフォームのルールにより、R2 を有効にするには支払い方法を設定する必要があります。

• 目的：身分認証のみ（Verify Only）で、料金は発生しません。
• 支払い方法：デュアル通貨クレジットカードまたは中国版 PayPal がサポートされています。
• 使用量：R2 の無料枠（10GB ストレージ/月）は、このプロジェクトの日常的な運用をカバーするのに十分であり、料金がかかる心配はありません。

GitHub Secret の設定：

必須設定（4項目）：

オプション設定：

💡 その他のストレージ設定オプション：ストレージ設定の詳細 を参照してください。

クレデンシャルの取得方法（Cloudflare R2 を例として）：

1. R2 の概要ページにアクセス：

   • Cloudflare Dashboard にログインします。
   • 左側のサイドバーで R2オブジェクトストレージ をクリックします。

2. ストレージバケットの作成：

   • 概要 をクリックします。
   • 右上の バケットを作成 (Create bucket) をクリックします。
   • 名前を入力し（例：trendradar-data）、バケットを作成 をクリックします。

3. API トークンの作成：

   • 「概要」ページに戻ります。
   • 右下の アカウント詳細 (Account Details) をクリックし、管理 (Manage R2 API Tokens) をクリックします。
   • 同時に、S3 API：https://<account-id>.r2.cloudflarestorage.com（これが S3_ENDPOINT_URL です）が表示されます。
   • アカウントAPIトークンを作成 をクリックします。
   • ⚠️ 重要な設定：
     • トークン名：任意の名前を入力します（例：github-action-write）。
     • 権限：管理者の読み取りと書き込み を選択します。
     • 指定するバケット：セキュリティ上の理由から、指定されたバケットにのみ適用 を選択し、あなたのバケット（例：trendradar-data）を選択します。
   • APIトークンを作成 をクリックし、表示された Access Key ID と Secret Access Key をすぐにコピーしてください（一度しか表示されません！）。

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：WEWORK_WEBHOOK_URL（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）
• Secret（値）：あなたの企業微信ロボットの Webhook アドレス

ロボットの設定手順：

モバイル端末での設定：

1. 企業微信アプリを開き、対象の内部チャットに入ります。
2. 右上の「…」ボタンをクリックし、「メッセージプッシュ」を選択します。
3. 「追加」をクリックし、名前に「TrendRadar」を入力します。
4. Webhook アドレスをコピーし、保存して、上記の GitHub Secret にコピーした内容を設定します。

PC 端末での設定手順も同様です。

この方法は企業微信のプラグインメカニズムに基づいているため、通知の形式は純粋なテキスト（Markdown 形式ではありません）ですが、企業微信アプリをインストールすることなく、直接個人微信に通知を送信することができます。

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：WEWORK_WEBHOOK_URL（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：あなたの企業微信アプリの Webhook アドレス

• Name（名前）：WEWORK_MSG_TYPE（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：text

設定手順：

1. 上記の企業微信ロボットの Webhook 設定を完了します。
2. WEWORK_MSG_TYPE Secret を追加し、値を text に設定します。
3. 以下の画像に従って操作し、個人微信を関連付けます。
4. 設定が完了したら、携帯電話の企業微信アプリを削除することができます。

説明：

• 企業微信ロボットと同じ Webhook アドレスを使用します。
• 違いはメッセージ形式です：text は純粋なテキスト、markdown はリッチテキスト（デフォルト）です。
• 純粋なテキスト形式では、すべての Markdown 構文（太字、リンクなど）が自動的に削除されます。

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：FEISHU_WEBHOOK_URL（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）
• Secret（値）：あなたの飛書ロボットの Webhook アドレス（このリンクは https://www.feishu.cn/flow/api/trigger-webhook/******** のような形式です）
  

2つの方法があります。方法1 は設定が簡単で、方法2 は設定が複雑ですが（しかし安定した通知が可能です）。

方法1は、ziventian によって発見され、提案されたものです。ここで感謝の意を表します。デフォルトでは個人通知ですが、グループ通知にも設定できます ＃97。

方法1：

一部の人には追加の操作が必要で、そうしないと「システムエラー」が表示される場合があります。モバイル端末でロボットを検索し、飛書ロボットアプリを有効にする必要があります（この提案はユーザーからのもので、参考にしてください）。

1. コンピュータのブラウザで https://botbuilder.feishu.cn/home/my-command を開きます。

2. 「新しいロボットコマンドを作成」をクリックします。

3. 「トリガーを選択」をクリックし、下にスクロールして「Webhook トリガー」をクリックします。

4. この時点で「Webhook アドレス」が表示されます。このリンクを一時的にローカルのメモ帳にコピーし、次の操作を続けます。

5. 「パラメーター」に以下の内容を入力し、「完了」をクリックします。

{
  "message_type": "text",
  "content": {
    "total_titles": "{{内容}}",
    "timestamp": "{{内容}}",
    "report_type": "{{内容}}",
    "text": "{{内容}}"
  }
}

6. 「操作を選択」> 「公式ロボットでメッセージを送信」をクリックします。

7. メッセージのタイトルに「TrendRadar ホットニュース監視」を入力します。

8. 最も重要な部分です。+ ボタンをクリックし、「Webhook トリガー」を選択し、以下の画像のように配置します。

9. 設定が完了したら、4 ステップでコピーした Webhook アドレスを GitHub Secrets の FEISHU_WEBHOOK_URL に設定します。

方法2：

1. コンピュータのブラウザで https://botbuilder.feishu.cn/home/my-app を開きます。

2. 「新しいロボットアプリを作成」をクリックします。

3. 作成したアプリに入り、「フローの設定」> 「フローを作成」> 「トリガーを選択」をクリックします。

4. 下にスクロールして「Webhook トリガー」をクリックします。

5. この時点で「Webhook アドレス」が表示されます。このリンクを一時的にローカルのメモ帳にコピーし、次の操作を続けます。

6. 「パラメーター」に以下の内容を入力し、「完了」をクリックします。

{
  "message_type": "text",
  "content": {
    "total_titles": "{{内容}}",
    "timestamp": "{{内容}}",
    "report_type": "{{内容}}",
    "text": "{{内容}}"
  }
}

7. 「操作を選択」> 「飛書メッセージを送信」をクリックし、「グループメッセージ」をチェックし、下の入力ボックスをクリックして「私が管理するグループ」を選択します（グループがない場合は、飛書アプリでグループを作成することができます）。

8. メッセージのタイトルに「TrendRadar ホットニュース監視」を入力します。

9. 最も重要な部分です。+ ボタンをクリックし、「Webhook トリガー」を選択し、以下の画像のように配置します。

10. 設定が完了したら、5 ステップでコピーした Webhook アドレスを GitHub Secrets の FEISHU_WEBHOOK_URL に設定します。

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：DINGTALK_WEBHOOK_URL（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）
• Secret（値）：あなたの钉钉ロボットの Webhook アドレス

ロボットの設定手順：

1. ロボットの作成（PC 端末のみサポート）：

   • 钉钉の PC クライアントを開き、対象のグループチャットに入ります。
   • グループ設定アイコン（⚙️）をクリックし、下にスクロールして「ロボット」を開きます。
   • 「ロボットを追加」> 「カスタム」を選択します。

2. ロボットの設定：

   • ロボットの名前を設定します。
   • セキュリティ設定：
     • カスタムキーワード：「ホットニュース」を設定します。

3. 設定の完了：

   • サービス利用規約にチェックを入れ、「完了」をクリックします。
   • 取得した Webhook URL をコピーします。
   • URL を GitHub Secrets の DINGTALK_WEBHOOK_URL に設定します。

注意：モバイル端末ではメッセージを受信することはできますが、新しいロボットを作成することはできません。

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：TELEGRAM_BOT_TOKEN（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：あなたの Telegram Bot Token

• Name（名前）：TELEGRAM_CHAT_ID（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：あなたの Telegram Chat ID

説明：Telegram では、2つの Secret を設定する必要があります。それぞれ2回「New repository secret」ボタンをクリックして追加してください。

ロボットの設定手順：

1. ロボットの作成：

   • Telegram で @BotFather を検索します（大文字と小文字に注意してください。青いバッジのチェックマークがあり、37849827 monthly users のような表示があるものが公式です。一部の模倣アカウントに注意してください）。
   • /newbot コマンドを送信して新しいロボットを作成します。
   • ロボットの名前を設定します（必ず「bot」で終わる必要があり、重複した名前が多いため、異なる名前を考える必要があります）。
   • Bot Token を取得します（形式は 123456789:AAHfiqksKZ8WmR2zSjiQ7_v4TMAKdiHm9T0 のようになります）。

2. Chat ID の取得：

   方法1：公式 API を使用して取得

   • まず、あなたのロボットにメッセージを送信します。
   • https://api.telegram.org/bot<あなたのBot Token>/getUpdates にアクセスします。
   • 返された JSON データの中から "chat":{"id":数字} の数字を見つけます。

   方法2：サードパーティツールを使用

   • @userinfobot を検索し、/start を送信します。
   • あなたのユーザー ID を Chat ID として取得します。

3. GitHub への設定：

   • TELEGRAM_BOT_TOKEN：1 ステップで取得した Bot Token を入力します。
   • TELEGRAM_CHAT_ID：2 ステップで取得した Chat ID を入力します。

• 注意事項：メールの一斉送信機能が悪用されるのを防ぐため、現在の一斉送信ではすべての受信者がお互いのメールアドレスを見ることができます。
• 以下のようなメール送信の設定経験がない場合は、試すことをお勧めしません。

⚠️ 重要な設定依存関係：メール通知には HTML レポートファイルが必要です。config/config.yaml の formats.html を true に設定してください。

formats:
  sqlite: true
  txt: false
  html: true   # 必須で有効にする必要があります。そうしないと、メール通知が失敗します。

false に設定すると、メール通知時に エラー：HTMLファイルが存在しないか、提供されていません: None というエラーが表示されます。

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：EMAIL_FROM（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：送信元のメールアドレス

• Name（名前）：EMAIL_PASSWORD（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：メールのパスワードまたは認証コード

• Name（名前）：EMAIL_TO（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

• Secret（値）：受信者のメールアドレス（複数の受信者は英語のカンマで区切ります。EMAIL_FROM と同じアドレスに自分自身に送信することもできます）

• Name（名前）：EMAIL_SMTP_SERVER（オプション設定。この名称をコピーして貼り付けてください）

• Secret（値）：SMTP サーバーのアドレス（空白にすることができ、システムが自動的に認識します）

• Name（名前）：EMAIL_SMTP_PORT（オプション設定。この名称をコピーして貼り付けてください）

• Secret（値）：SMTP ポート（空白にすることができ、システムが自動的に認識します）

説明：メール通知には、少なくとも3つの必須 Secret（EMAIL_FROM、EMAIL_PASSWORD、EMAIL_TO）を設定する必要があり、後の2つはオプション設定です。

サポートされるメールプロバイダー（SMTP 設定を自動認識）：

自動認識：上記のメールを使用する場合、EMAIL_SMTP_SERVER と EMAIL_SMTP_PORT を手動で設定する必要はありません。システムが自動的に認識します。

フィードバックの説明：

• 他のメール をテストして成功した場合は、Issues を開いて教えてください。サポートリストに追加します。
• 上記のメール設定が誤っているか、使用できない場合は、Issues を開いてフィードバックし、プロジェクトの改善にご協力ください。

特別な感謝：

• @DYZYD が天翼メール（189.cn）の設定を提供し、自動送信と受信のテストを行ってくれました (#291)。
• @longzhenren が阿里云メール（aliyun.com）の設定を提供し、テストを行ってくれました (#344)。
• @ACANX が Yandex メール（yandex.com）の設定を提供し、テストを行ってくれました (#663)。

一般的なメール設定：

QQメール：

1. QQメールのウェブ版にログインし、「設定」> 「アカウント」をクリックします。
2. POP3/SMTP サービスを有効にします。
3. 認証コードを生成します（16 文字の英字）。
4. EMAIL_PASSWORD に認証コードを入力します。QQ パスワードではないことに注意してください。

Gmail：

1. 2段階認証を有効にします。
2. アプリ専用パスワードを生成します。
3. EMAIL_PASSWORD にアプリ専用パスワードを入力します。

163/126メール：

1. ウェブ版にログインし、「設定」> 「POP3/SMTP/IMAP」をクリックします。
2. SMTP サービスを有効にします。
3. クライアント認証コードを設定します。
4. EMAIL_PASSWORD に認証コードを入力します。
   

高度な設定： 自動認識が失敗した場合は、SMTP を手動で設定することができます。

• EMAIL_SMTP_SERVER：例：smtp.gmail.com
• EMAIL_SMTP_PORT：例：587（TLS）または 465（SSL）
  

複数の受信者がいる場合（英語のカンマで区切ることに注意）：

• EMAIL_TO="user1@example.com,user2@example.com,user3@example.com"

2種類の使用方法：

方法1：無料で使用（初心者におすすめ） 🆓

特徴：

• ✅ アカウント登録不要ですぐに使えます。
• ✅ 1日に250 件のメッセージが送信できます（90% のユーザーには十分です）。
• ✅ Topic 名が「パスワード」になります（推測しにくい名前を選択してください）。
• ⚠️ メッセージは暗号化されていないため、機密情報には適していませんが、このプロジェクトの非機密情報には適しています。

クイックスタート：

1. ntfy アプリのダウンロード：

   • Android：Google Play / F-Droid
   • iOS：App Store
   • デスクトップ：ntfy.sh にアクセスします。

2. トピックの購読（推測しにくい名前を選択してください）：

推奨形式：trendradar-{あなたの名前の頭文字}-{ランダムな数字}

日本語は使用できません。

✅ 良い例：trendradar-zs-8492
❌ 悪い例：news、alerts（推測しやすい）

3. GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

   • Name（名前）：NTFY_TOPIC（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）

   • Secret（値）：先ほど購読したトピック名を入力します。

   • Name（名前）：NTFY_SERVER_URL（オプション設定。この名称をコピーして貼り付けてください）

   • Secret（値）：空白にします（デフォルトでは ntfy.sh を使用します）。

   • Name（名前）：NTFY_TOKEN（オプション設定。この名称をコピーして貼り付けてください）

   • Secret（値）：空白にします。

   説明：ntfy では、少なくとも 1 つの必須 Secret (NTFY_TOPIC) を設定する必要があり、後の 2 つはオプション設定です。

4. テスト：

curl -d "テストメッセージ" ntfy.sh/あなたのトピック名

方法2：自前のサーバーで運用（完全なプライバシー管理） 🔒

対象ユーザー：サーバーを持ち、完全なプライバシーを求め、技術力のあるユーザー。

利点：

• ✅ 完全にオープンソース（Apache 2.0 + GPLv2）です。
• ✅ データを完全に自主管理できます。
• ✅ 制限がありません。
• ✅ 無料です。

Docker での一键デプロイ：

docker run -d \
  --name ntfy \
  -p 80:80 \
  -v /var/cache/ntfy:/var/cache/ntfy \
  binwiederhier/ntfy \
  serve --cache-file /var/cache/ntfy/cache.db

TrendRadar の設定：

NTFY_SERVER_URL: https://ntfy.yourdomain.com
NTFY_TOPIC: trendradar-alerts  # 自前のサーバーでは簡単な名前を使用できます。
NTFY_TOKEN: tk_your_token  # オプション：アクセス制御を有効にする場合

アプリでのトピック購読：

• 「別のサーバーを使用」をクリックします。
• あなたのサーバーのアドレスを入力します。
• トピック名を入力します。
• （オプション）ログイン資格情報を入力します。

よくある質問：

推奨選択：

関連リンク：

• ntfy 公式ドキュメント
• 自前のサーバーでの運用方法
• GitHub リポジトリ

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：BARK_URL（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）
• Secret（値）：あなたの Bark 通知 URL

Bark の概要：

Bark は iOS プラットフォーム用の無料のオープンソース通知ツールで、シンプルで高速、広告がないという特徴があります。

使用方法：

方法1：公式サーバーを使用（初心者におすすめ） 🆓

1. Bark App のダウンロード：

   • iOS：App Store

2. 通知 URL の取得：

   • Bark App を開きます。
   • トップページに表示される通知 URL をコピーします（形式は https://api.day.app/your_device_key のようになります）。
   • URL を GitHub Secrets の BARK_URL に設定します。

方法2：自前のサーバーを構築（完全なプライバシー管理） 🔒

対象ユーザー：サーバーを持ち、完全なプライバシーを求め、技術力のあるユーザー。

Docker での一键デプロイ：

docker run -d \
  --name bark-server \
  -p 8080:8080 \
  finab/bark-server

TrendRadar の設定：

BARK_URL: http://your-server-ip:8080/your_device_key

注意事項：

• ✅ Bark は APNs を使用して通知を送信し、1 つのメッセージの最大サイズは 4KB です。
• ✅ 自動的にバッチ送信がサポートされており、メッセージが長い場合も心配する必要はありません。
• ✅ 通知形式は純粋なテキストです（Markdown 構文は自動的に削除されます）。
• ⚠️ iOS プラットフォームのみサポートされています。

関連リンク：

• Bark 公式ウェブサイト
• Bark GitHub リポジトリ
• Bark Server 自前のサーバー構築方法

GitHub Secret の設定（⚠️ Name の名称は厳密に一致する必要があります）：

• Name（名前）：SLACK_WEBHOOK_URL（この名称をコピーして貼り付けてください。手打ちすると間違いやすいです）
• Secret（値）：あなたの Slack Incoming Webhook URL

Slack の概要：

Slack はチームコラボレーションツールで、Incoming Webhooks を使用すると、メッセージを Slack チャンネルに送信することができます。

設定手順：

ステップ1：Slack App の作成

1. Slack API ページにアクセス：

   • https://api.slack.com/apps?new_app=1 を開きます。
   • 未ログインの場合は、Slack ワークスペースにログインします。

2. 作成方法の選択：

   • "From scratch"（最初から作成）をクリックします。

3. App 情報の入力：

   • App Name：アプリの名前を入力します（例：TrendRadar または ホットニュース監視）。
   • Workspace：ドロップダウンリストからあなたのワークスペースを選択します。
   • "Create App" ボタンをクリックします。

ステップ2：Incoming Webhooks の有効化

1. Incoming Webhooks ページに移動：

   • 左側のメニューで "Incoming Webhooks" をクリックします。

2. 機能の有効化：

   • "Activate Incoming Webhooks" スイッチを見つけます。
   • スイッチを OFF から ON に切り替えます。
   • ページが自動的に更新され、新しい設定オプションが表示されます。

ステップ3：Webhook URL の生成

1. 新しい Webhook の追加：

   • ページの下部までスクロールします。
   • "Add New Webhook to Workspace" ボタンをクリックします。

2. ターゲットチャンネルの選択：

   • システムが承認ページを表示します。
   • ドロップダウンリストからメッセージを受信するチャンネルを選択します（例：#ホットニュース）。
   • ⚠️ プライベートチャンネルを選択する場合は、まずそのチャンネルに参加している必要があります。

3. アプリの承認：

   • "Allow" ボタンをクリックして承認を完了します。
   • システムが自動的に設定ページに戻ります。

ステップ4：Webhook URL のコピーと保存

1. 生成された URL の確認：

   • "Webhook URLs for Your Workspace" エリアで、先ほど生成された Webhook URL を見つけます。
   • 形式は https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX のようになります。

2. URL のコピー：

   • URL の右側にある "Copy" ボタンをクリックするか、手動で URL を選択してコピーします。

3. TrendRadar への設定：

   • GitHub Actions：URL を GitHub Secrets の SLACK_WEBHOOK_URL に追加します。
   • ローカルテスト：URL を config/config.yaml の slack_webhook_url フィールドに入力します。
   • Docker デプロイ：URL を docker/.env ファイルの SLACK_WEBHOOK_URL 変数に追加します。

注意事項：

• ✅ Markdown 形式がサポートされています（自動的に Slack mrkdwn 形式に変換されます）。
• ✅ 自動的なバッチ送信がサポートされており、1 バッチあたり 4KB です。
• ✅ チームコラボレーションに適しており、メッセージを集中管理できます。
• ⚠️ Webhook URL は秘密鍵を含んでいるため、公開しないでください。

メッセージ形式のプレビュー：

*[第 1/2 バッチ]*

📊 *ホットキーワードの統計*

🔥 *[1/3] AI ChatGPT* : 2 件

  1. [百度ホットニュース] 🆕 ChatGPT-5正式リリース *[1]* - 09時15分 (1回)

  2. [今日头条] AIチップ関連株が急騰 *[3]* - [08時30分 ~ 10時45分] (3回)

関連リンク：

• Slack Incoming Webhooks 公式ドキュメント
• Slack API アプリ管理