MarketBrief

40개 이상의 데이터 소스를 매일 월스트리트 스타일의 시장 브리핑으로 변환하여 텔레그램으로 자동 전송합니다.

MarketBrief는 실시간 시장 데이터를 가져오고, 40개 이상의 RSS 피드에서 뉴스를 집계하며, Claude AI를 사용하여 구조화된 분석가 수준의 보고서를 생성하는 오픈 소스 프레임워크입니다. 개인용 블룸버그 터미널을 매일 브리핑으로 요약한 것이라고 생각하면 됩니다.

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, 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 피드는 7일 전까지의 데이터를 조회합니다(뉴스는 36시간).

AI 분석 스타일 (`config/prompts/`)

Claude 프롬프트는 완전히 편집 가능합니다. 다음과 같이 할 수 있습니다:

출력 언어 변경(영어, 중국어 또는 혼합)
분석 이슈 개수 조정(기본값: 4)
분석가 어조 수정(단호한 매도 측 vs 중립적)
사용자 정의 분석 프레임워크 추가
포지셔닝 입장 옵션 변경

사용 사례 및 아이디어

MarketBrief는 시작점입니다. 이 도구로 다음과 같은 것을 구축할 수 있습니다:

사용 사례	방법
개인 일일 브리핑	포트폴리오 + 텔레그램 구성, GitHub Actions 크론 설정
암호화폐 추적기	주식 제거, 20개 암호화폐 피드 추가, DeFi 프로토콜 추적
매크로 연구 보조	FRED + 연준 + 재무부 피드 강화, 금리/환율에 집중
팀 아침 회의	공유 텔레그램 채널이나 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`	주식, 원자재, FX, 금리, 암호화폐 스냅샷	아니요
`fetch_news`	중복 제거된 40개 이상의 RSS 피드 집계	아니요
`fetch_calendar`	경제 캘린더 (Forex Factory + MyFXBook)	아니요
`analyze_regime`	매크로 체제 감지 (수익률 곡선, 신용, 순환)	아니요
`analyze_breadth`	시장 폭 신호 (상승/하락 종목, MA 교차)	아니요
`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 (선택 사항)
시간대에 맞게 크론 일정을 조정하세요 (workflows/README.md 참조).
푸시하면 보고서가 자동으로 생성되어 전송됩니다.

데이터 소스

소스	데이터	비용
Yahoo Finance	주식, 원자재, FX, 금리, 섹터	무료
Frankfurter API	ECB 공식 환율	무료
CoinGecko	암호화폐 가격 + 시가총액	무료
FRED	공식 미국 경제 데이터 (CPI, GDP, NFP, 수익률)	무료 (API 키)
SoSoValue	BTC/ETH 현물 ETF 일일 유입액 + AUM	무료 (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, 이메일)
트레이딩 기술: 체제 감지기 및 폭 분석기 포팅
현지화: 다른 언어용 프롬프트 (일본어, 한국어, 스페인어)
테스트: 수집기 및 분석 파이프라인에 대한 단위 테스트

라이선스

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/`)