MarketBrief

40以上のデータソースを、ウォール街スタイルの日次マーケットブリーフィングに変換し、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を使用して、特定の価格水準、ソースの引用、実行可能なポジショニングを含む構造化されたブリーフィングに統合します。

仕組み

                 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を実行します：

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

mkdir -p .github/workflows
cp workflows/morning_report.yml.template .github/workflows/morning_report.yml

GitHubリポジトリにシークレットを追加します (Settings → Secrets → Actions)：
- ANTHROPIC_API_KEY
- TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID
- FRED_API_KEY (オプション)
タイムゾーンに合わせてcronスケジュールを調整します (workflows/README.md を参照)。
プッシュすると、レポートが自動的に生成・配信されます。

データソース

ソース	データ	コスト
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 — 自由にご利用ください。

Market Brief

MarketBrief

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

仕組み

クイックスタート

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

2. 設定

3. 実行

カスタマイズ可能な点

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

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

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

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

ユースケースとアイデア

MCPサーバー

7つの利用可能なツール

自動配信 (GitHub Actions)

データソース

プロジェクト構造

貢献

ライセンス

Resources

Latest Blog Posts

MCP directory API

MarketBrief

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

仕組み

クイックスタート

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

2. 設定

3. 実行

カスタマイズ可能な点

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

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

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

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

ユースケースとアイデア

MCPサーバー

7つの利用可能なツール

自動配信 (GitHub Actions)

データソース

プロジェクト構造

貢献

ライセンス

Resources

Latest Blog Posts

MCP directory API

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

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

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

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