Telegram ニュース スキル（読み取り専用）

Telegram CLI ツールの tdl を使用して、Telegram チャネルとグループから金融ニュースと市場調査を読み取ります。

このスキルは読み取り専用です。 金融調査向けに設計されています：チャネルメッセージの読み取り、金融ニュースチャネルの監視、メッセージ履歴のエクスポート。メッセージ送信、チャネルの参加/退出、または書き込み操作はサポートしていません。

---

ステップ 1: tdl がインストールされていることを確認

現在の環境ステータス：

!`(command -v tdl && tdl version 2>&1 | head -3 || echo "TDL_NOT_INSTALLED") 2>/dev/null`

上記のステータスにバージョン番号が表示されている場合、tdl はインストール済みです。ステップ 2 に進んでください。

TDL_NOT_INSTALLED が表示される場合は、ユーザーのプラットフォームに基づいて tdl をインストールします：

プラットフォーム	インストールコマンド
macOS / Linux	curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash
macOS (Homebrew)	brew install telegram-downloader
Linux (Termux)	pkg install tdl
Linux (AUR)	yay -S tdl
Linux (Nix)	nix-env -iA nixos.tdl
Go（任意のプラットフォーム）	go install github.com/iyear/tdl@latest

ユーザーに希望するインストール方法を聞いてください。macOS の場合はデフォルトで Homebrew、Linux の場合は curl スクリプトを選びます。

---

ステップ 2: tdl が認証されていることを確認

現在の認証ステータス：

!`(tdl chat ls --limit 1 2>&1 >/dev/null && echo "AUTH_OK" || echo "AUTH_NEEDED") 2>/dev/null`

AUTH_OK の場合は、ステップ 3 をスキップしてください。

AUTH_NEEDED の場合は、ユーザーをログインプロセスに導きます。ログインにはインタラクティブな入力が必要です。ユーザーは電話番号と検証コードを手動で入力する必要があります。

ログイン方法

方法 A: QR コード（推奨 — 最速）

tdl login -T qr

QR コードがターミナルに表示されます。ユーザーは Telegram モバイルアプリで読み込みます（設定 > デバイス > デスクトップ デバイスをリンク）。

方法 B: 電話 + コード

tdl login -T code

ユーザーが電話番号を入力し、Telegram アプリに送信された検証コードを入力します。

方法 C: Telegram Desktop からインポート

ユーザーが Telegram Desktop をインストールしてログイン済みの場合：

tdl login

既存のデスクトップクライアントからセッションをインポートします。デスクトップクライアントは 公式ウェブサイト からのものである必要があります。App Store または Microsoft Store からではありません。

名前空間

デフォルトでは、tdl は default 名前空間を使用します。複数のアカウントを管理するには：

tdl login -n work -T qr      # "work" 名前空間にログイン
tdl chat ls -n work           # コマンドに "work" 名前空間を使用

ログイン時の重要な注意事項

• ログインは 1 回限りの 操作です。ログイン成功後、セッションはディスクに保持されます。
• ログインに失敗した場合は、ユーザーにインターネット接続を確認して再度試すよう依頼してください。
• プログラムで Telegram パスワード/2FA コードを要求または処理しないでください。常にユーザーが対話的に入力するようにしてください。

---

ステップ 3: ユーザーが必要とするものを特定

ユーザーのリクエストを以下の読み取り操作のいずれかに対応させます。

ユーザーリクエスト	コマンド	主要フラグ
すべてのチャット/チャネルをリストアップ	tdl chat ls	-o json, -f "FILTER"
チャネルのみをリストアップ	tdl chat ls -f "Type contains 'channel'"	-o json
最近のメッセージをエクスポート	tdl chat export -c CHAT -T last -i N	--all, --with-content
時間範囲のメッセージをエクスポート	tdl chat export -c CHAT -T time -i START,END	--all, --with-content
ID 範囲のメッセージをエクスポート	tdl chat export -c CHAT -T id -i FROM,TO	--all, --with-content
トピック/スレッドからエクスポート	tdl chat export -c CHAT --topic TOPIC_ID	--all, --with-content
名前でチャネルを検索	tdl chat ls -f "VisibleName contains 'NAME'"	-o json

チャット識別子

-c フラグは複数の形式に対応しています：

形式	例
ユーザー名（@ 付き）	-c @channel_name
ユーザー名（@ なし）	-c channel_name
数値チャット ID	-c 123456789
パブリックリンク	-c https://t.me/channel_name
電話番号	-c "+1 123456789"
保存されたメッセージ	-c "" （空）

---

ステップ 4: コマンドを実行

チャットのリストアップ

# すべてのチャットをリストアップ
tdl chat ls

# 処理用の JSON 出力
tdl chat ls -o json

# チャネルのみをフィルタリング
tdl chat ls -f "Type contains 'channel'"

# 名前で検索
tdl chat ls -f "VisibleName contains 'Bloomberg'"

メッセージのエクスポート

テキストメッセージを取得するために、常に --all --with-content を使用してください（メディアのみではなく）：

# チャネルから最後の 20 メッセージ
tdl chat export -c @channel_name -T last -i 20 --all --with-content -o /tmp/tdl-export.json

# 時間範囲のメッセージ（Unix タイムスタンプ）
tdl chat export -c @channel_name -T time -i 1710288000,1710374400 --all --with-content -o /tmp/tdl-export.json

# ID 範囲のメッセージ
tdl chat export -c @channel_name -T id -i 100,200 --all --with-content -o /tmp/tdl-export.json

主要なルール

1. 認証を最初にチェック — 他のコマンドの前に tdl chat ls --limit 1 を実行してセッションが有効であることを確認します
2. メッセージをエクスポートする場合、常に --all --with-content を使用 — これらのフラグなしでは、tdl はメディアメッセージのみをエクスポートします
3. -o FILE を使用して ファイルにエクスポートを保存し、JSON を読み込みます。これは stdout の解析よりも信頼性が高いです
4. 小さなエクスポートから始める — ユーザーがより多くを要求しない限り、-T last -i 20 を使用します
5. chat ls にフィルタを使用 して、エクスポート前にユーザーが正しいチャネルを見つけるのを支援します
6. 書き込み操作を実行しない — このスキルは読み取り専用です。メッセージを送信、チャネルに参加、または何かを変更しないでください
7. タイムスタンプを変換 — ユーザーが日付を指定した場合、-T time フィルタ用に Unix タイムスタンプに変換します

エクスポート JSON の使用

エクスポート後、JSON ファイルを読み込んで関連情報を抽出します：

# メッセージをエクスポート
tdl chat export -c @channel_name -T last -i 20 --all --with-content -o /tmp/tdl-export.json

# エクスポートを読み込んで処理
cat /tmp/tdl-export.json

エクスポート JSON には、id、date、message（テキストコンテンツ）、from_id、views、メディアメタデータなどのフィールドを持つメッセージオブジェクトが含まれます。

---

ステップ 5: 結果を提示

データを取得した後、金融調査のために明確に提示します：

1. 主要なメッセージを要約 — 最も関連性のあるニュースまたは市場アップデートをハイライト
2. タイムスタンプを含める — 各メッセージが投稿された時刻を表示
3. トピック別にグループ化 — 複数のチャネルの場合、テーマ別（マクロ、決算、暗号資産など）に整理
4. 実行可能な情報にフラグを付ける — ブレーキングニュース、価格目標、決算サプライズを記載
5. チャネルコンテキストを提供 — 各メッセージがどのチャネル/グループから来たかを記載
6. チャネルリストの場合、チャネル名、メンバー数、タイプを表示

---

ステップ 6: 診断

問題が発生した場合：

エラー	原因	修正
not authorized またはセッションエラー	ログインしていないか、セッションが期限切れ	tdl login -T qr を実行して再認証
FLOOD_WAIT_X	Telegram でレート制限	X 秒待機してから再試行
CHANNEL_PRIVATE	チャネルへのアクセス権がない	ユーザーが最初に Telegram アプリでチャネルに参加する必要があります
tdl: command not found	tdl がインストールされていない	ステップ 1 を使用してインストール

---

参考ファイル

• references/commands.md — チャネルを読み取るメッセージをエクスポートするための完全な tdl コマンドリファレンス

正確なコマンド構文または詳細なフラグドキュメントが必要な場合は、参考ファイルを読んでください。