Market Brief
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 bezieht Daten aus offiziellen Quellen (Fed, SEC, FRED, ECB), Marktdatenanbietern (Yahoo Finance, CoinGecko) und über 40 Nachrichten-Feeds — und nutzt dann Claude AI, um alles in einem strukturierten Briefing mit spezifischen Preisniveaus, Quellenangaben und umsetzbaren Positionierungsvorschlägen zusammenzufassen.
Related MCP server: TickerDB
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 .envBearbeiten 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 Vorlagen-Framework, kein fertiges Produkt. Alles ist darauf ausgelegt, modifiziert zu werden:
Assets & Portfolio (config/portfolio.json)
Verfolgen Sie, was Ihnen wichtig ist. Die Standardeinstellung ist auf die USA 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 von Yahoo Finance unterstützt wird:
{
"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 nie 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 anpassen (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 |
Morgendliches Team-Standup | An einen geteilten Telegram-Kanal oder eine Feishu-Gruppe senden |
KI-Agent-Datenquelle | Nutzen Sie den MCP-Server, um jedem KI-Assistenten Live-Marktdaten bereitzustellen |
Trading-Signal-Pipeline | Fügen Sie Ihre eigene Scoring-Logik zu den News/Kalender-Fetchern hinzu |
Mehrsprachiges Briefing | Ändern Sie |
Earnings-Saison-Tracker | Earnings-fokussierte RSS-Feeds hinzufügen, Kalenderfilter anpassen |
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_serverFügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (claude_desktop_config.json):
{
"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 |
| Vollständige KI-gestützte Briefing-Pipeline | Ja |
| Aktien, Rohstoffe, FX, Zinsen, Krypto-Snapshot | Nein |
| Aggregation von 40+ RSS-Feeds mit Deduplizierung | Nein |
| Wirtschaftskalender (Forex Factory + MyFXBook) | Nein |
| Makro-Regime-Erkennung (Zinskurve, Kredit, Rotation) | Nein |
| Marktbreiten-Signale (Advance/Decline, MA-Crossovers) | Nein |
| 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 die Workflow-Vorlage:
mkdir -p .github/workflows cp workflows/morning_report.yml.template .github/workflows/morning_report.ymlFügen Sie Secrets in Ihrem GitHub-Repo hinzu (Settings → Secrets → Actions):
ANTHROPIC_API_KEYTELEGRAM_BOT_TOKEN+TELEGRAM_CHAT_IDFRED_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, GDP, 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 templatesMitwirken
PRs sind willkommen! Einige 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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Daily and weekly AI briefings on the stocks you hold, plus per-ticker news with sources.
Market intelligence for investors and AI agents: company briefs, filings and economic data.
21 paid tools: US macro data, SEC EDGAR filings, on-chain EVM reads. Settled in USDC on Base.
Real-time news with bias scoring, live market data, and AI-powered options pricing
Related MCP Servers
- AlicenseAqualityDmaintenanceResearches any company in ~10 seconds using 10 data sources. Returns structured reports with bull/bear verdict for stocks, crypto, and private companies.212AGPL 3.0
- AlicenseAqualityBmaintenancePoint-in-time market data for AI agents: stocks, ETFs and crypto as named bands plus raw values.105MIT
- AlicenseAqualityBmaintenanceReal-time news with bias scoring, live market data, and AI-powered options pricing. 9 tools across news intelligence, media bias analysis, stock/crypto data, and meme search.95 npm11MIT
- AlicenseNot gradedqualityDmaintenanceReal-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.1MIT