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 автоматизирует всё это. Он извлекает данные из официальных источников (ФРС, SEC, FRED, ЕЦБ), провайдеров рыночных данных (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 (ИИ-технологии) получают ретроспективный обзор за 7 дней (против 36 часов для новостей).

Стиль анализа AI (`config/prompts/`)

Промпты для Claude полностью редактируемы. Вы можете:

Изменить язык вывода (английский, китайский или смешанный)
Настроить количество аналитических тем (по умолчанию: 4)
Изменить голос аналитика (напористый sell-side или нейтральный)
Добавить собственные аналитические фреймворки
Изменить варианты позиционирования

Варианты использования и идеи

MarketBrief — это отправная точка. Вот что вы можете на нем построить:

Вариант использования	Как
Личный ежедневный брифинг	Настройте портфель + Telegram, установите cron в GitHub Actions
Крипто-трекер	Удалите акции, добавьте 20 крипто-лент, отслеживайте DeFi-протоколы
Помощник по макроисследованиям	Упор на ленты FRED + ФРС + Казначейство, фокус на ставках/валютах
Утренняя летучка команды	Отправляйте в общий Telegram-канал или группу Feishu
Источник данных для ИИ-агента	Используйте MCP Server, чтобы дать любому ИИ-ассистенту рыночные данные в реальном времени
Конвейер торговых сигналов	Добавьте свою логику оценки к сборщикам новостей/календаря
Многоязычный брифинг	Измените `OUTPUT_LANGUAGE` в промпте на китайский/японский
Трекер сезона отчетности	Добавьте RSS-ленты по отчетности, настройте фильтрацию календаря

MCP Server

MarketBrief может работать как сервер MCP, позволяя любому ИИ-ассистенту (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`	Ежедневные потоки и AUM спотовых BTC/ETH ETF	Нет

Большинство инструментов работают без какого-либо 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).
Сделайте push — отчеты будут генерироваться и доставляться автоматически.

Источники данных

Источник	Данные	Стоимость
Yahoo Finance	Акции, сырьевые товары, валюты, ставки, сектора	Бесплатно
Frankfurter API	Официальные курсы валют ЕЦБ	Бесплатно
CoinGecko	Криптовалютные цены + рыночная капитализация	Бесплатно
FRED	Официальные экономические данные США (CPI, GDP, NFP, доходность)	Бесплатно (API-ключ)
SoSoValue	Ежедневные потоки и AUM спотовых BTC/ETH ETF	Бесплатно (API-ключ)
Forex Factory	Экономический календарь со временем + влиянием	Бесплатно
MyFXBook	Календарь с фактическими/прогнозными/предыдущими данными	Бесплатно
40+ RSS-лент	Новости от ФРС, 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

Вклад в проект

PR приветствуются! Области, где вклад был бы особенно ценен:

Новые сборщики данных: Добавление источников (например, Binance, TradingView, Alpha Vantage)
Рендереры: Улучшение вывода HTML/PDF, добавление новых форматов (Slack, Discord, email)
Торговые навыки: Портирование детектора режима и анализатора широты рынка
Локализация: Промпты для других языков (японский, корейский, испанский)
Тесты: Модульные тесты для сборщиков данных и аналитического конвейера

Лицензия

MIT — используйте как хотите.

Market Brief

MarketBrief

Какую проблему это решает?

Как это работает

Быстрый старт

1. Клонирование и установка

2. Настройка

3. Запуск

Что можно настроить

Активы и портфель (`config/portfolio.json`)

Дашборд (`config/dashboard.json`)

Источники новостей (`config/feeds.json`)

Стиль анализа AI (`config/prompts/`)

Варианты использования и идеи

MCP Server

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 Server

7 доступных инструментов

Автоматическая доставка (GitHub Actions)

Источники данных

Структура проекта

Вклад в проект

Лицензия

Resources

Latest Blog Posts

MCP directory API

Активы и портфель (`config/portfolio.json`)

Дашборд (`config/dashboard.json`)

Источники новостей (`config/feeds.json`)

Стиль анализа AI (`config/prompts/`)