MarketBrief

Convierte más de 40 fuentes de datos en un resumen de mercado diario al estilo de Wall Street, entregado automáticamente en tu Telegram.

MarketBrief es un framework de código abierto que obtiene datos de mercado en tiempo real, agrega noticias de más de 40 fuentes RSS y utiliza Claude AI para generar informes estructurados con calidad de analista. Piénsalo como tu terminal Bloomberg personal destilada en un resumen diario.

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

¿Qué problema resuelve esto?

Si eres un inversor minorista, trader de criptomonedas o entusiasta del mercado, probablemente:

Consultes 5-10 sitios web cada mañana para ver actualizaciones del mercado
Te pierdas publicaciones importantes de datos económicos
Carezcas de una forma sistemática de conectar los puntos entre clases de activos
Desees tener un analista escribiéndote un resumen diario

MarketBrief automatiza todo esto. Extrae datos de fuentes oficiales (Fed, SEC, FRED, BCE), proveedores de datos de mercado (Yahoo Finance, CoinGecko) y más de 40 fuentes de noticias; luego utiliza Claude AI para sintetizar todo en un resumen estructurado con niveles de precios específicos, citas de fuentes y posicionamiento accionable.

Cómo funciona

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

¿No tienes clave de IA? No hay problema. Sin ANTHROPIC_API_KEY, MarketBrief sigue generando un informe completo solo con datos: instantánea del mercado, feed de noticias, calendario económico; simplemente sin el comentario de la IA.

Inicio rápido

1. Clonar e instalar

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

2. Configurar

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

Edita .env con tus claves de 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. Ejecutar

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

Qué puedes personalizar

Este es un framework de plantilla, no un producto terminado. Todo está diseñado para ser modificado:

Activos y cartera (`config/portfolio.json`)

Realiza un seguimiento de lo que te interese. El valor predeterminado está enfocado en EE. UU., pero puedes:

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

Panel de control (`config/dashboard.json`)

Agrega o elimina cualquier activo que Yahoo Finance admita:

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

Fuentes de noticias (`config/feeds.json`)

Agrega cualquier feed RSS. Organízalo por categoría para un filtrado inteligente:

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

Las categorías importan: los feeds de government y geopolitics nunca se truncan. Los feeds de macro y ai_tech obtienen una retrospectiva de 7 días (frente a las 36 horas para las noticias).

Estilo de análisis de IA (`config/prompts/`)

Los prompts de Claude son totalmente editables. Puedes:

Cambiar el idioma de salida (inglés, chino o mixto)
Ajustar el número de problemas de análisis (predeterminado: 4)
Modificar la voz del analista (sell-side asertivo frente a neutral)
Agregar frameworks de análisis personalizados
Cambiar las opciones de postura de posicionamiento

Casos de uso e ideas

MarketBrief es un punto de partida. Esto es lo que podrías construir con él:

Caso de uso	Cómo
Resumen diario personal	Configura tu cartera + Telegram, configura cron de GitHub Actions
Rastreador enfocado en cripto	Elimina acciones, agrega 20 feeds de cripto, rastrea protocolos DeFi
Asistente de investigación macro	Mucho peso en feeds de FRED + Fed + Tesoro, enfoque en tasas/FX
Standup matutino de equipo	Envía a un canal de Telegram compartido o grupo de Feishu
Fuente de datos para agente de IA	Usa el servidor MCP para dar a cualquier asistente de IA datos de mercado en vivo
Pipeline de señales de trading	Agrega tu propia lógica de puntuación a los extractores de noticias/calendario
Resumen multilingüe	Cambia `OUTPUT_LANGUAGE` en el prompt a chino/japonés
Rastreador de temporada de resultados	Agrega feeds RSS enfocados en resultados, personaliza el filtrado del calendario

Servidor MCP

MarketBrief puede ejecutarse como un servidor MCP, permitiendo que cualquier asistente de IA (Claude Desktop, Claude Code, etc.) llame a herramientas de datos de mercado directamente.

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

Agrégalo a tu configuración de Claude Desktop (claude_desktop_config.json):

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

7 herramientas disponibles

Herramienta	Qué hace	Necesita clave de IA
`generate_report`	Pipeline de resumen completo impulsado por IA	Sí
`fetch_market_data`	Instantánea de acciones, materias primas, FX, tasas, cripto	No
`fetch_news`	Agrega más de 40 feeds RSS con deduplicación	No
`fetch_calendar`	Calendario económico (Forex Factory + MyFXBook)	No
`analyze_regime`	Detección de régimen macro (curva de rendimiento, crédito, rotación)	No
`analyze_breadth`	Señales de amplitud de mercado (avance/descenso, cruces de MA)	No
`fetch_etf_flows`	Flujos diarios y AUM de ETF al contado de BTC/ETH	No

La mayoría de las herramientas funcionan sin ninguna clave de API; solo generate_report necesita Anthropic.

Entrega automatizada (GitHub Actions)

Ejecuta MarketBrief en un horario; no se necesita servidor:

Copia la plantilla de flujo de trabajo:

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

Agrega secretos en tu repositorio de GitHub (Settings → Secrets → Actions):
- ANTHROPIC_API_KEY
- TELEGRAM_BOT_TOKEN + TELEGRAM_CHAT_ID
- FRED_API_KEY (opcional)
Ajusta el horario cron para tu zona horaria (consulta workflows/README.md).
Haz push; los informes se generarán y entregarán automáticamente.

Fuentes de datos

Fuente	Datos	Costo
Yahoo Finance	Acciones, materias primas, FX, tasas, sectores	Gratis
Frankfurter API	Tipos de cambio oficiales del BCE	Gratis
CoinGecko	Precios de cripto + capitalización de mercado	Gratis
FRED	Datos económicos oficiales de EE. UU. (IPC, PIB, NFP, rendimientos)	Gratis (clave API)
SoSoValue	Flujos diarios y AUM de ETF al contado de BTC/ETH	Gratis (clave API)
Forex Factory	Calendario económico con horarios + impacto	Gratis
MyFXBook	Calendario con real/pronóstico/anterior	Gratis
40+ feeds RSS	Noticias de Fed, SEC, CNBC, Bloomberg, CoinDesk, etc.	Gratis

Estructura del proyecto

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

Contribuyendo

¡Las PR son bienvenidas! Algunas áreas donde las contribuciones serían especialmente valiosas:

Nuevos extractores: Agregar fuentes de datos (ej. Binance, TradingView, Alpha Vantage)
Renderizadores: Mejorar la salida HTML/PDF, agregar nuevos formatos (Slack, Discord, correo electrónico)
Habilidades de trading: Portar el detector de régimen y el analizador de amplitud
Localización: Prompts para otros idiomas (japonés, coreano, español)
Pruebas: Pruebas unitarias para extractores y el pipeline de análisis

Licencia

MIT: úsalo como quieras.

Market Brief

MarketBrief

¿Qué problema resuelve esto?

Cómo funciona

Inicio rápido

1. Clonar e instalar

2. Configurar

3. Ejecutar

Qué puedes personalizar

Activos y cartera (`config/portfolio.json`)

Panel de control (`config/dashboard.json`)

Fuentes de noticias (`config/feeds.json`)

Estilo de análisis de IA (`config/prompts/`)

Casos de uso e ideas

Servidor MCP

7 herramientas disponibles

Entrega automatizada (GitHub Actions)

Fuentes de datos

Estructura del proyecto

Contribuyendo

Licencia

Resources

Latest Blog Posts

MCP directory API

MarketBrief

¿Qué problema resuelve esto?

Cómo funciona

Inicio rápido

1. Clonar e instalar

2. Configurar

3. Ejecutar

Qué puedes personalizar

Activos y cartera (config/portfolio.json)

Panel de control (config/dashboard.json)

Fuentes de noticias (config/feeds.json)

Estilo de análisis de IA (config/prompts/)

Casos de uso e ideas

Servidor MCP

7 herramientas disponibles

Entrega automatizada (GitHub Actions)

Fuentes de datos

Estructura del proyecto

Contribuyendo

Licencia

Resources

Latest Blog Posts

MCP directory API

Activos y cartera (`config/portfolio.json`)

Panel de control (`config/dashboard.json`)

Fuentes de noticias (`config/feeds.json`)

Estilo de análisis de IA (`config/prompts/`)