WSB Analyst MCP Server

WSB Analyst MCP サーバー

Claude やその他の LLM クライアントでの分析のために、リアルタイムの WallStreetBets データを提供する Model Context Protocol (MCP) サーバーです。

機能

• WallStreetBets 投稿の取得: スコア、コメント数、コンテンツタイプで投稿をフィルタリングできます
• 詳細な投稿分析: 投稿からコメント、リンク、メタデータを抽出します
• 外部リンクの収集: WSB のディスカッションで共有されているリンクを収集します
• 分析テンプレート: 市場分析にすぐ使えるプロンプトテンプレート
• 進捗レポート: データ収集中のリアルタイム進捗更新
• MCP 統合: Claude Desktop やその他の MCP クライアントとのシームレスな統合

必要条件

• Python 3.12 以上
• Reddit API の認証情報
• Claude Desktop またはその他の MCP クライアント

インストール

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の WSB Analyst を自動的にインストールするには:

npx -y @smithery/cli install @ferdousbhai/wsb-analyst-mcp --client claude

このリポジトリをクローンするか、ソースファイルをダウンロードします:

git clone https://github.com/ferdousbhai/wsb-analyst-mcp
cd wsb-analyst-mcp

仮想環境を作成し、依存関係をインストールします:

# Using uv (recommended)
uv sync

Reddit API 認証情報の設定

このサーバーを使用するには、Reddit アプリケーションを作成して API 認証情報を取得する必要があります:

1. Reddit アカウントにログインします
2. https://www.reddit.com/prefs/apps にアクセスします
3. 下にスクロールして「create another app...」または「create an app...」をクリックします
4. 以下の詳細を入力します:
   • name: WSB Analyst MCP (または任意の名前)
   • app type: 「script」を選択
   • description: アプリケーションの説明 (任意)
   • about url: 空欄のままで構いません
   • redirect uri: http://localhost:8000 を使用します (OAuth を使用しないため、任意の有効な URL で動作します)
5. 「create app」をクリックします
6. 作成後、以下を控えておきます:
   • client_id: アプリ名の下にある文字列 (「personal use script」のすぐ下に表示されます)
   • client_secret: 「secret」とラベル付けされた文字列

Claude Desktop の設定

Claude Desktop の設定ファイルを開きます:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します (パスは必要に応じて調整してください):

{
  "mcpServers": {
    "wsb-analyst": {
      "command": "uvx",
      "args": [
        "run",
        "wsb-analyst"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id_here",
        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Claude Desktop を再起動します

Claude Desktop での使用

設定が完了すると、Claude を通じて WSB Analyst サーバーとやり取りできるようになります:

1. Claude Desktop を開きます
2. メッセージ入力ボックスの右下にハンマーアイコンが表示されます
3. ハンマーをクリックすると、利用可能なツールが表示されます
4. スラッシュコマンド (例: /analyze_wsb_market) でプロンプトテンプレートにアクセスできます

クエリの例:

• 「今日の WallStreetBets でトレンドになっている株は何ですか?」
• 「最近の WallStreetBets の投稿を分析して、潜在的な市場機会について教えてください」
• 「WSB ユーザーが AMD 株について共有している外部リソースは何ですか?」

利用可能なツール

find_top_posts

条件に基づいて WSB の投稿を取得し、フィルタリングします。

パラメーター:

• min_score (デフォルト: 100): 必要な最小スコア (アップボート数)
• min_comments (デフォルト: 10): 必要な最小コメント数
• limit (デフォルト: 10): 返す投稿の最大数
• excluded_flairs (デフォルト: ["Meme", "Shitpost", "Gain", "Loss"]): 除外する投稿フレアのリスト

fetch_post_details

特定の WSB 投稿の詳細情報を、トップコメントを含めて取得します。

パラメータ:

• post_id: Reddit 投稿 ID

fetch_batch_post_details

複数の投稿の詳細を効率的に取得します。

fetch_detailed_wsb_posts

WSB 投稿を取得してフィルタリングし、各投稿のトップコメントやリンクを含む詳細情報を取得します。

get_external_links

トップ投稿からすべての外部リンクを収集します。

get_trending_tickers

最近のトップ WSB 投稿で頻繁に言及または議論されている株式ティッカーのリストを特定して返します。

プロンプトテンプレート

/analyze_wsb_market

利用可能なツール（fetch_detailed_wsb_posts、get_external_links）を使用して包括的な市場分析を実行するよう LLM を導くためのテンプレートプロンプトを提供します。分析の構成と焦点について LLM に指示します。

/find_market_movers

特定の銘柄や市場全体を動かしている要因に焦点を当てたプロンプトを作成します。このプロンプトは、find_top_posts や fetch_post_details または fetch_batch_post_details などのツールを使用するよう LLM を導きます。

Firecrawl MCP サーバーとの統合

分析機能を強化するために、特に WSB 投稿で見つかった外部リンクを扱う場合、このサーバーを Firecrawl MCP サーバーと統合できます。これにより、LLM エージェントは WSB で共有されたリンクを特定するだけでなく、それらのリンク先ページの内容をスクレイピングして分析することもできます。

ライセンス

MIT