MarketBrief

Verwandeln Sie über 40 Datenquellen automatisch in ein tägliches Markt-Briefing im Wall-Street-Stil — direkt an Ihr Telegram geliefert.

MarketBrief ist ein Open-Source-Framework, das Echtzeit-Marktdaten abruft, Nachrichten aus über 40 RSS-Feeds aggregiert und Claude AI nutzt, um strukturierte Berichte auf Analystenniveau zu erstellen. Betrachten Sie es als Ihr persönliches Bloomberg-Terminal, destilliert in ein tägliches Briefing.

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...

Welches Problem wird hier gelöst?

Wenn Sie Privatanleger, Krypto-Trader oder Markt-Enthusiast sind, tun Sie wahrscheinlich Folgendes:

Sie prüfen jeden Morgen 5-10 Websites auf Markt-Updates
Sie verpassen wichtige Veröffentlichungen von Wirtschaftsdaten
Ihnen fehlt eine systematische Methode, um Zusammenhänge zwischen Anlageklassen zu erkennen
Sie wünschten, ein Analyst würde Ihnen ein tägliches Briefing schreiben

MarketBrief automatisiert all dies. Es zieht Daten von offiziellen Quellen (Fed, SEC, FRED, ECB), Marktdatenanbietern (Yahoo Finance, CoinGecko) und über 40 Nachrichten-Feeds — und nutzt dann Claude AI, um alles in ein strukturiertes Briefing mit spezifischen Preisniveaus, Quellenangaben und umsetzbaren Positionierungsvorschlägen zusammenzufassen.

Funktionsweise

                 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)  │
              └──────────┘ └──────────┘ └──────────┘

Kein KI-Schlüssel? Kein Problem. Ohne ANTHROPIC_API_KEY gibt MarketBrief weiterhin einen vollständigen, rein datenbasierten Bericht aus: Markt-Snapshot, News-Feed, Wirtschaftskalender — nur ohne den KI-Kommentar.

Schnellstart

1. Klonen und installieren

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

2. Konfigurieren

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

Bearbeiten Sie .env mit Ihren API-Schlüsseln:

# 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. Ausführen

# 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...)

Was Sie anpassen können

Dies ist ein Template-Framework, kein fertiges Produkt. Alles ist darauf ausgelegt, modifiziert zu werden:

Assets & Portfolio (`config/portfolio.json`)

Verfolgen Sie, was Ihnen wichtig ist. Der Standard ist US-fokussiert, aber Sie können:

{
  "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"]
}

Dashboard (`config/dashboard.json`)

Fügen Sie jedes Asset hinzu oder entfernen Sie es, das Yahoo Finance unterstützt:

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

Nachrichtenquellen (`config/feeds.json`)

Fügen Sie jeden beliebigen RSS-Feed hinzu. Organisieren Sie diese nach Kategorien für intelligentes Filtern:

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

Kategorien sind wichtig: government und geopolitics Feeds werden niemals gekürzt. macro und ai_tech Feeds erhalten einen 7-Tage-Rückblick (im Vergleich zu 36 Stunden bei Nachrichten).

KI-Analysestil (`config/prompts/`)

Die Claude-Prompts sind vollständig editierbar. Sie können:

Die Ausgabesprache ändern (Englisch, Chinesisch oder gemischt)
Die Anzahl der Analyse-Themen anpassen (Standard: 4)
Die Stimme des Analysten modifizieren (bestimmt/Sell-Side vs. neutral)
Eigene Analyse-Frameworks hinzufügen
Die Optionen für die Positionierung ändern

Anwendungsfälle & Ideen

MarketBrief ist ein Ausgangspunkt. Hier ist, was Sie damit bauen könnten:

Anwendungsfall	Wie
Persönliches tägliches Briefing	Portfolio + Telegram konfigurieren, GitHub Actions Cron einrichten
Krypto-fokussierter Tracker	Aktien entfernen, 20 Krypto-Feeds hinzufügen, DeFi-Protokolle verfolgen
Makro-Forschungsassistent	Fokus auf FRED + Fed + Treasury Feeds, Schwerpunkt auf Zinsen/FX
Tägliches Team-Standup	Push an einen geteilten Telegram-Kanal oder eine Feishu-Gruppe
KI-Agent-Datenquelle	Nutzen Sie den MCP-Server, um jedem KI-Assistenten Live-Marktdaten zu geben
Trading-Signal-Pipeline	Fügen Sie Ihre eigene Scoring-Logik zu den Nachrichten-/Kalender-Fetchern hinzu
Mehrsprachiges Briefing	Ändern Sie `OUTPUT_LANGUAGE` im Prompt auf Chinesisch/Japanisch
Earnings-Saison-Tracker	Fügen Sie Earnings-fokussierte RSS-Feeds hinzu, passen Sie die Kalenderfilterung an

MCP-Server

MarketBrief kann als MCP-Server ausgeführt werden, wodurch jeder KI-Assistent (Claude Desktop, Claude Code, etc.) Marktdaten-Tools direkt aufrufen kann.

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

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration (claude_desktop_config.json) hinzu:

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

7 verfügbare Tools

Tool	Was es tut	Benötigt KI-Schlüssel
`generate_report`	Vollständige KI-gestützte Briefing-Pipeline	Ja
`fetch_market_data`	Aktien, Rohstoffe, FX, Zinsen, Krypto-Snapshot	Nein
`fetch_news`	Aggregation von 40+ RSS-Feeds mit Deduplizierung	Nein
`fetch_calendar`	Wirtschaftskalender (Forex Factory + MyFXBook)	Nein
`analyze_regime`	Makro-Regime-Erkennung (Zinskurve, Kredit, Rotation)	Nein
`analyze_breadth`	Marktbreiten-Signale (Advance/Decline, MA-Crossovers)	Nein
`fetch_etf_flows`	BTC/ETH Spot-ETF tägliche Flows und AUM	Nein

Die meisten Tools funktionieren ohne API-Schlüssel — nur generate_report benötigt Anthropic.

Automatisierte Zustellung (GitHub Actions)

Führen Sie MarketBrief nach einem Zeitplan aus — kein Server erforderlich:

Kopieren Sie das Workflow-Template:

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

Fügen Sie Secrets in Ihrem GitHub-Repo hinzu (Settings → Secrets → Actions):
- ANTHROPIC_API_KEY
- TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID
- FRED_API_KEY (optional)
Passen Sie den Cron-Zeitplan für Ihre Zeitzone an (siehe workflows/README.md).
Pushen — Berichte werden automatisch generiert und zugestellt.

Datenquellen

Quelle	Daten	Kosten
Yahoo Finance	Aktien, Rohstoffe, FX, Zinsen, Sektoren	Kostenlos
Frankfurter API	Offizielle EZB-Wechselkurse	Kostenlos
CoinGecko	Krypto-Preise + Marktkapitalisierung	Kostenlos
FRED	Offizielle US-Wirtschaftsdaten (CPI, BIP, NFP, Renditen)	Kostenlos (API-Schlüssel)
SoSoValue	BTC/ETH Spot-ETF tägliche Flows + AUM	Kostenlos (API-Schlüssel)
Forex Factory	Wirtschaftskalender mit Zeiten + Auswirkungen	Kostenlos
MyFXBook	Kalender mit Ist/Prognose/Vorherigen Werten	Kostenlos
40+ RSS-Feeds	Nachrichten von Fed, SEC, CNBC, Bloomberg, CoinDesk, etc.	Kostenlos

Projektstruktur

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

Mitwirken

PRs sind willkommen! Bereiche, in denen Beiträge besonders wertvoll wären:

Neue Fetcher: Datenquellen hinzufügen (z. B. Binance, TradingView, Alpha Vantage)
Renderer: HTML/PDF-Ausgabe verbessern, neue Formate hinzufügen (Slack, Discord, E-Mail)
Trading-Skills: Regime-Detektor und Breiten-Analysator portieren
Lokalisierung: Prompts für andere Sprachen (Japanisch, Koreanisch, Spanisch)
Tests: Unit-Tests für Fetcher und die Analyse-Pipeline

Lizenz

MIT — nutzen Sie es, wie Sie möchten.

Market Brief

MarketBrief

Welches Problem wird hier gelöst?

Funktionsweise

Schnellstart

1. Klonen und installieren

2. Konfigurieren

3. Ausführen

Was Sie anpassen können

Assets & Portfolio (`config/portfolio.json`)

Dashboard (`config/dashboard.json`)

Nachrichtenquellen (`config/feeds.json`)

KI-Analysestil (`config/prompts/`)

Anwendungsfälle & Ideen

MCP-Server

7 verfügbare Tools

Automatisierte Zustellung (GitHub Actions)

Datenquellen

Projektstruktur

Mitwirken

Lizenz

Resources

Latest Blog Posts

MCP directory API

MarketBrief

Welches Problem wird hier gelöst?

Funktionsweise

Schnellstart

1. Klonen und installieren

2. Konfigurieren

3. Ausführen

Was Sie anpassen können

Assets & Portfolio (config/portfolio.json)

Dashboard (config/dashboard.json)

Nachrichtenquellen (config/feeds.json)

KI-Analysestil (config/prompts/)

Anwendungsfälle & Ideen

MCP-Server

7 verfügbare Tools

Automatisierte Zustellung (GitHub Actions)

Datenquellen

Projektstruktur

Mitwirken

Lizenz

Resources

Latest Blog Posts

MCP directory API

Assets & Portfolio (`config/portfolio.json`)

Dashboard (`config/dashboard.json`)

Nachrichtenquellen (`config/feeds.json`)

KI-Analysestil (`config/prompts/`)