Skip to main content
Glama

MarketBrief

MarketBrief MCP server License: MIT Python 3.11+

40以上のデータソースをWall Streetスタイルの日次マーケットブリーフィングに変換し、Telegramに自動配信します。

MarketBriefは、リアルタイムの市場データを取得し、40以上のRSSフィードからニュースを集約し、Claude AIを使用して構造化されたアナリストグレードのレポートを生成するオープンソースフレームワークです。あなた専用のBloomberg端末を日次ブリーフィングに凝縮したものと考えてください。

Every morning at 7:00 AM, you wake up to this in Telegram:

  "Rates rise, equities capsize"

  TODAY'S FOCUS:
  - CPI 08:30 ET — beat eases Fed, miss reprices June cut
  - Gold $3,100 support — break below = safe-haven bid fading
  - Trump tariff speech 14:00 ET — new China tariffs trigger risk-off

  4 analyst-grade issues with source citations...
  Positioning table (OW/UW/MW)...
  Categorized news digest with 30+ items...
  Economic calendar with 10+ events...

このツールが解決する課題

個人投資家、仮想通貨トレーダー、または市場愛好家であれば、おそらく以下のような状況にあるでしょう:

  • 毎朝5〜10のウェブサイトをチェックして市場の最新情報を確認している

  • 重要な経済指標の発表を見逃している

  • アセットクラスを横断して情報を関連付ける体系的な方法がない

  • アナリストが書いた日次ブリーフィングが欲しいと思っている

MarketBriefは、これらすべてを自動化します。 公式ソース(FRB、SEC、FRED、ECB)、市場データプロバイダー(Yahoo Finance、CoinGecko)、および40以上のニュースフィードからデータを取得し、Claude AIを使用して、特定の価格水準、ソースの引用、実用的なポジショニングを含む構造化されたブリーフィングに統合します。


Related MCP server: TickerAPI

仕組み

                 YOU CONFIGURE                          IT FETCHES
           ┌─────────────────────┐            ┌──────────────────────┐
           │  portfolio.json     │            │  Yahoo Finance       │
           │  - your holdings    │            │  FRED (official)     │
           │  - interest areas   │            │  CoinGecko           │
           │                     │            │  SoSoValue (ETF)     │
           │  dashboard.json     │            │  Frankfurter (ECB)   │
           │  - assets to track  │            │  40+ RSS feeds       │
           │                     │            │  Forex Factory       │
           │  feeds.json         │            │  MyFXBook            │
           │  - news sources     │            └──────────┬───────────┘
           └─────────┬───────────┘                       │
                     │                                   │
                     ▼                                   ▼
           ┌─────────────────────────────────────────────────────────┐
           │              Claude AI (2-stage pipeline)               │
           │                                                         │
           │  Stage 1: Pre-flight Editorial Analysis                 │
           │  → Identifies market regime (risk-on/off/rotation)      │
           │  → Groups news into narrative threads                   │
           │  → Kills 30-50% of noise items                          │
           │                                                         │
           │  Stage 2: Structured Report Generation                  │
           │  → 4-issue analysis (what/reaction/contradiction/view)  │
           │  → Source-cited positioning table                        │
           │  → Categorized news digest                              │
           │  → Economic calendar with impact scoring                │
           └─────────────────────┬───────────────────────────────────┘
                                 │
                    ┌────────────┼────────────┐
                    ▼            ▼            ▼
              ┌──────────┐ ┌──────────┐ ┌──────────┐
              │ Telegram  │ │  Feishu  │ │ Terminal │
              │ (HTML+PDF)│ │  (Card)  │ │  (JSON)  │
              └──────────┘ └──────────┘ └──────────┘

AIキーがなくても問題ありません。 ANTHROPIC_API_KEY がない場合でも、MarketBriefは市場スナップショット、ニュースフィード、経済カレンダーといった完全なデータのみのレポートを出力します(AIによる解説は含まれません)。


クイックスタート

1. クローンとインストール

git clone https://github.com/yukipanpan/marketbrief.git
cd marketbrief
pip install -e .

2. 設定

cp config/portfolio.example.json config/portfolio.json
cp config/dashboard.example.json config/dashboard.json
cp config/feeds.example.json config/feeds.json
cp .env.example .env

.env を編集してAPIキーを設定します:

# Required for AI analysis (skip for data-only mode)
ANTHROPIC_API_KEY="sk-ant-your-key-here"

# Optional — enhances data coverage
FRED_API_KEY="your-fred-key"              # Free at https://fred.stlouisfed.org/docs/api/api_key.html
SOSOVALUE_API_KEY="your-sosovalue-key"    # ETF flow data

# Optional — delivery channels
TELEGRAM_BOT_TOKEN="your-bot-token"       # Create at https://t.me/BotFather
TELEGRAM_CHAT_ID="your-chat-id"

3. 実行

# Data-only mode (no AI key needed, free)
marketbrief generate --no-ai

# Full AI-powered report
marketbrief generate --output json

# Fetch specific data
marketbrief fetch market      # Live prices: equities, FX, commodities, crypto
marketbrief fetch news        # Aggregated news from 40+ feeds
marketbrief fetch calendar    # Economic calendar (Forex Factory + FRED)
marketbrief fetch crypto      # BTC, ETH, SOL prices from CoinGecko
marketbrief fetch etf         # BTC/ETH spot ETF flows from SoSoValue
marketbrief fetch fred        # Official US economic data (CPI, GDP, NFP...)

カスタマイズ可能な点

これはテンプレートフレームワークであり、完成品ではありません。すべてが変更できるように設計されています:

アセットとポートフォリオ (config/portfolio.json)

関心のあるものを追跡します。デフォルトは米国中心ですが、以下のように変更可能です:

{
  "holdings": [
    {"name": "Nikkei 225 ETF", "ticker": "EWJ", "category": "Japan Equities"},
    {"name": "Copper Futures", "ticker": "HG=F", "category": "Industrial Metals"},
    {"name": "Bitcoin", "ticker": "BTC-USD", "category": "Crypto"}
  ],
  "interest_areas": ["Semiconductors", "Uranium", "Japan"],
  "focus_regions": ["Japan", "US", "EU"]
}

ダッシュボード (config/dashboard.json)

Yahoo Financeがサポートするあらゆるアセットを追加または削除できます:

{
  "equities": [
    {"label": "Nikkei 225", "yf": "^N225"},
    {"label": "FTSE 100",  "yf": "^FTSE"},
    {"label": "DAX",       "yf": "^GDAXI"}
  ],
  "crypto_ids": ["bitcoin", "ethereum", "solana", "dogecoin"]
}

ニュースソース (config/feeds.json)

RSSフィードを追加します。スマートフィルタリングのためにカテゴリ別に整理してください:

{
  "feeds": [
    {"name": "my_niche_blog", "category": "research", "url": "https://example.com/feed.xml"},
    {"name": "industry_news", "category": "markets",  "url": "https://industry.com/rss"}
  ]
}

カテゴリは重要です: government(政府)および geopolitics(地政学)フィードは切り捨てられません。macro(マクロ)および ai_tech(AI技術)フィードは7日間の遡及期間(ニュースは36時間)が適用されます。

AI分析スタイル (config/prompts/)

Claudeのプロンプトは完全に編集可能です。以下のような変更が可能です:

  • 出力言語の変更(英語、中国語、または混合)

  • 分析課題の数の調整(デフォルト:4)

  • アナリストのトーンの変更(断定的なセルサイド対中立)

  • カスタム分析フレームワークの追加

  • ポジショニングスタンスのオプション変更


ユースケースとアイデア

MarketBriefは出発点に過ぎません。これを使って構築できるものの例です:

ユースケース

方法

個人の日次ブリーフィング

ポートフォリオ + Telegramを設定し、GitHub Actionsのcronを設定

仮想通貨特化型トラッカー

株式を削除し、20の仮想通貨フィードを追加、DeFiプロトコルを追跡

マクロリサーチアシスタント

FRED + FRB + 財務省フィードを強化し、金利/為替に焦点を当てる

チームの朝会用

共有のTelegramチャンネルや飛書(Feishu)グループにプッシュ

AIエージェントのデータソース

MCPサーバーを使用して、あらゆるAIアシスタントにライブ市場データを提供する

取引シグナルパイプライン

ニュース/カレンダー取得ツールに独自のスコアリングロジックを追加

多言語ブリーフィング

プロンプト内の OUTPUT_LANGUAGE を中国語/日本語に変更

決算シーズン追跡

決算重視のRSSフィードを追加し、カレンダーフィルタリングをカスタマイズ


MCPサーバー

MarketBriefは MCP サーバーとして実行でき、あらゆるAIアシスタント(Claude Desktop、Claude Codeなど)から直接市場データツールを呼び出すことができます。

pip install marketbrief[mcp]
python -m marketbrief.mcp_server

Claude Desktopの設定 (claude_desktop_config.json) に追加します:

{
  "mcpServers": {
    "marketbrief": {
      "command": "python",
      "args": ["-m", "marketbrief.mcp_server"],
      "env": {"FRED_API_KEY": "your-key"}
    }
  }
}

7つの利用可能なツール

ツール

機能

AIキーが必要

generate_report

AIを活用した完全なブリーフィングパイプライン

はい

fetch_market_data

株式、コモディティ、為替、金利、仮想通貨のスナップショット

いいえ

fetch_news

重複排除機能付きの40以上のRSSフィード集約

いいえ

fetch_calendar

経済カレンダー (Forex Factory + MyFXBook)

いいえ

analyze_regime

マクロレジーム検知 (イールドカーブ、クレジット、ローテーション)

いいえ

analyze_breadth

市場の幅シグナル (騰落数、移動平均クロスオーバー)

いいえ

fetch_etf_flows

BTC/ETH現物ETFの毎日のフローとAUM

いいえ

ほとんどのツールは APIキーなし で動作します。generate_report のみAnthropicのキーが必要です。


自動配信 (GitHub Actions)

サーバー不要で、スケジュールに従ってMarketBriefを実行します:

  1. ワークフローテンプレートをコピーします:

    mkdir -p .github/workflows
    cp workflows/morning_report.yml.template .github/workflows/morning_report.yml
  2. GitHubリポジトリにシークレットを追加します (Settings → Secrets → Actions):

    • ANTHROPIC_API_KEY

    • TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID

    • FRED_API_KEY (オプション)

  3. タイムゾーンに合わせてcronスケジュールを調整します (workflows/README.md を参照)。

  4. プッシュすると、レポートが自動的に生成・配信されます。


データソース

ソース

データ

コスト

Yahoo Finance

株式、コモディティ、為替、金利、セクター

無料

Frankfurter API

ECB公式為替レート

無料

CoinGecko

仮想通貨価格 + 時価総額

無料

FRED

米国公式経済データ (CPI, GDP, NFP, 利回り)

無料 (APIキー)

SoSoValue

BTC/ETH現物ETFの毎日のフロー + AUM

無料 (APIキー)

Forex Factory

時間と影響度付きの経済カレンダー

無料

MyFXBook

実績/予想/前回値付きカレンダー

無料

40+ RSSフィード

FRB、SEC、CNBC、Bloomberg、CoinDesk等のニュース

無料


プロジェクト構造

marketbrief/
├── src/marketbrief/
│   ├── core/
│   │   ├── config.py       # Unified config: JSON + env vars
│   │   ├── types.py        # Pydantic models for all data
│   │   ├── analysis.py     # Claude AI 2-stage pipeline
│   │   └── pipeline.py     # Main orchestrator
│   ├── fetchers/            # 6 data source modules
│   ├── renderers/           # HTML, Telegram, PDF, Markdown
│   ├── delivery/            # Telegram, Feishu, stdout
│   └── skills/              # Trading analysis modules
├── config/                  # Customizable JSON configs + prompts
├── mcp_server/              # MCP Server (7 tools)
├── claude_skill/            # Claude Code Skill definition
└── workflows/               # GitHub Actions templates

貢献

プルリクエストを歓迎します!特に以下の分野での貢献を募集しています:

  • 新しい取得ツール: データソースの追加 (例: Binance, TradingView, Alpha Vantage)

  • レンダラー: HTML/PDF出力の改善、新しいフォーマットの追加 (Slack, Discord, メール)

  • 取引スキル: レジーム検知器と幅分析器の移植

  • ローカライズ: 他言語用のプロンプト (日本語、韓国語、スペイン語)

  • テスト: 取得ツールと分析パイプラインのユニットテスト


ライセンス

MIT — 自由にご利用ください。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Researches any company in ~10 seconds using 10 data sources. Returns structured reports with bull/bear verdict for stocks, crypto, and private companies.
    2
    12
    AGPL 3.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    Real-time curated knowledge API for AI agents. Updated Mon/Wed/Fri from 31 sources covering AI/tech, startups, alternative markets, and emerging markets — no scraping or storage required.
    1
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yukipanpan/marketbrief'

If you have feedback or need assistance with the MCP directory API, please join our Discord server