discord について
discord-cliでDiscordを調査する読み取り専用スキルです。メッセージをローカルに同期して検索・分析でき、サーバーやチャンネルの確認、活動の追跡、メッセージのエクスポートにも対応します。認証にはローカルのDiscordセッショントークンを使います。
主な機能
- 01サーバーとチャンネルの一覧
- 02メッセージの同期と検索
- 03最近のメッセージと履歴の閲覧
- 04活動状況と上位投稿者の分析
- 05テキスト・JSON形式でのエクスポート
活用シーン
- 01トレードサーバーの議論を検索
- 02市場コミュニティのセンチメントを追跡
- 03チャンネルの活動推移を確認
- 04分析用にメッセージをエクスポート
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ himself65/ finance-skills --skill discordインストール後、Claude Code で/discordを入力して読み込まれたか確認します。
同梱ファイルREADME.mdreferences/commands.md
詳細
Discord スキル(読み取り専用)
discord-cli を使用して金融調査のために Discord を読み取ります。discord-cli は Discord のメッセージをローカルに同期し、検索、分析、エクスポート機能を提供するコマンドラインツールです。
このスキルは読み取り専用です。 金融調査向けに設計されており、トレードサーバーでの議論の検索、暗号資産/市場グループの監視、金融コミュニティのセンチメントの追跡、分析用のメッセージのエクスポートに利用できます。メッセージの送信、リアクション、編集、削除などの書き込み操作には対応していません。
重要:このツールは、ローカルの Discord クライアントまたはブラウザーセッションから抽出した Discord トークンを使用します。ボットアカウントは必要ありません。
ステップ 1:discord-cli がインストールされ、認証されていることを確認する
現在の環境の状態:
!`(command -v discord && discord status 2>&1 | head -5 && echo "AUTH_OK" || echo "AUTH_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`
上記の状態が AUTH_OK の場合は、ステップ 2 に進んでください。NOT_INSTALLED の場合は、まずインストールしてください。
# Install (requires Python 3.10+)
uv tool install kabi-discord-cli
AUTH_NEEDED の場合は、ユーザーを案内してください。
認証
方法 A:ローカルの Discord クライアントから自動抽出(推奨)
discord auth --save
ローカルで実行中の Discord デスクトップアプリまたはブラウザーセッションからトークンを抽出し、次回以降の使用に備えて保存します。
方法 B:環境変数
export DISCORD_TOKEN="<token from browser DevTools>"
discord status
よくある認証の問題
| 症状 | 対処方法 |
|---|---|
Token not found | Discord デスクトップアプリを開くか、ブラウザーでログインしてから、discord auth --save を実行します |
Token expired / invalid | Discord に再ログインしてから、もう一度 discord auth --save を実行します |
Unauthorized (401) | トークンが無効です。discord auth --save で再抽出します |
ステップ 2:ユーザーのニーズを特定する
ユーザーの依頼に該当する読み取りコマンドを以下から選び、references/commands.md に記載されている対応するコマンドを使用します。
| ユーザーの依頼 | コマンド | 主なフラグ |
|---|---|---|
| 認証状態の確認 | discord status | — |
| 自分の情報 | discord whoami | --json |
| サーバー/ギルドの一覧 | discord dc guilds | --json |
| サーバー内のチャンネル一覧 | discord dc channels GUILD_ID | --json |
| サーバー情報 | discord dc info GUILD_ID | --json |
| サーバーメンバー | discord dc members GUILD_ID | --max N、--json |
| メッセージ履歴の取得 | discord dc history CHANNEL_ID | -n N |
| メッセージをローカルに同期 | discord dc sync CHANNEL_ID | -n N |
| すべてのチャンネルを同期 | discord dc sync-all | -n N |
| 最新のメッセージ | discord dc tail CHANNEL_ID | --once |
| サーバー内を検索(API) | discord dc search GUILD_ID "QUERY" | -c CHANNEL_ID、--json |
| ローカル検索 | discord search "QUERY" | -c CHANNEL、-n N、--json |
| 最近のメッセージ | discord recent | -c CHANNEL、--hours N、-n N、--json |
| 今日のメッセージ | discord today | -c CHANNEL、--json |
| メッセージ統計 | discord stats | --json |
| 送信者の上位一覧 | discord top | -c CHANNEL、--hours N、--json |
| アクティビティのタイムライン | discord timeline | -c CHANNEL、--hours N、--by day|hour、--json |
| メッセージのエクスポート | discord export CHANNEL | -f text|json、-o FILE、--hours N |
ステップ 3:コマンドを実行する
基本パターン
# Use --json or --yaml for structured output
discord dc guilds --json
discord dc channels GUILD_ID --json
# Sync messages from a channel for local queries
discord dc sync CHANNEL_ID -n 1000
# Search for financial topics
discord dc search GUILD_ID "AAPL earnings" --json
discord search "BTC pump" -n 20 --json
# Recent activity
discord recent --hours 24 -n 50 --json
discord today -c CHANNEL_ID --json
主なルール
- 最初に認証を確認する — 他のコマンドを実行する前に
discord statusを実行します - プログラムでデータを処理する場合は
--jsonまたは--yamlを使用する — 構造化された出力を取得できます - ローカル検索の前に同期する —
discord search、discord recentなどを使用する前に、discord dc sync CHANNEL_IDを実行します - 結果数を制限するには
-n Nを使用する — ユーザーから追加の指定がない限り、50~100 件から始めます - サーバー側の検索には
discord dc searchを使用する(同期は不要)。ローカル検索にはdiscord searchを使用する(事前の同期が必要) recent、top、timeline、exportで期間を絞るには--hours Nを使用する- 書き込み操作は絶対に実行しない — このスキルは読み取り専用です。メッセージの送信、リアクション、編集、削除、サーバー設定の管理は行わないでください
discord purgeは絶対に実行しない — ローカルデータが削除され、調査には関係ありません
出力フラグ
| フラグ | 用途 |
|---|---|
--json | JSON 出力 |
--yaml | YAML 出力(非 TTY 時のデフォルト) |
-n N | 結果の数を制限 |
-o FILE | 出力をファイルに保存 |
-c CHANNEL | チャンネルでフィルタリング |
新しいサーバーでの一般的なワークフロー
# 1. List guilds to find the server
discord dc guilds --json
# 2. List channels in the target guild
discord dc channels GUILD_ID --json
# 3. Sync messages from channels of interest
discord dc sync CHANNEL_ID -n 2000
# 4. Search or analyze
discord search "price target" -n 20 --json
discord recent -c CHANNEL_ID --hours 24 --json
discord top -c CHANNEL_ID --hours 168 --json
ステップ 4:結果を提示する
データを取得したら、金融調査に役立つよう明確に提示します。
- 主な内容を要約する — ユーザーの金融調査に最も関連性の高いメッセージを強調します
- 出典を明記する — ユーザー名、メッセージ内容、タイムスタンプを示します
- 検索結果の場合は、関連度ごとにまとめ、主なテーマ、センチメント、市場シグナルを強調します
- サーバー/チャンネルの一覧の場合は、名前と ID を記載した見やすい表で提示します
- センチメントを示す — 強気/弱気のセンチメント、コンセンサスと逆張りの見解を記します
- 分析機能(
stats、top、timeline)の場合は、活動パターンと注目すべき貢献者を提示します - トークンを秘密情報として扱う — Discord トークンを stdout に出力してはいけません
ステップ 5:診断
認証に失敗した場合は、次を再実行します。
discord auth --save
discord status
Discord デスクトップアプリが起動していること、またはブラウザーで Discord にログインしていることを確認してください。
エラーリファレンス
| エラー | 原因 | 対処方法 |
|---|---|---|
Token not found | 認証されていない | Discord を開いた状態で discord auth --save を実行します |
| HTTP 401 | トークンの有効期限切れ/無効 | Discord に再ログインし、トークンを再抽出します |
| HTTP 403 | リソースへのアクセス権がない | サーバー/チャンネルへのアクセス権があることを確認します |
| HTTP 429 | レート制限 | 数分待ってから再試行します |
リファレンスファイル
references/commands.md— すべてのフラグと使用例を含む、読み取りコマンドの完全なリファレンス
コマンドの正確な構文やフラグの詳細な説明が必要な場合は、リファレンスファイルを参照してください。