Overnight Market Report Plugin
간밤 미국 증시와 국제정세를 자동으로 수집·분석해 한국장 개장 전 브리핑용 한국어 마크다운 보고서를 만드는 Claude Code 스킬 플러그인입니다. 전문가용 원본 리포트와 주식 입문자용 쉬운버전을 한 번에 생성합니다.
"미국주식", "야간시황", "밤사이 증시", "미장 마감", "어제 미장 어땠어" 등으로 호출하면 자동 트리거됩니다.
✨ 주요 특징
- 하이브리드 오케스트레이션 — 메인 세션이
finnhub get_quote로 30+ 종목·섹터·글로벌 ETF 시세를 병렬 수집하고, 별도 news-harvester 서브에이전트가 Tavily search/extract + WebSearch로 뉴스·매크로 이벤트를 격리 수집합니다. 메인 컨텍스트가 대용량 뉴스 원문으로 오염되지 않음
- 인과 분석 — 단순 숫자 나열이 아니라 "왜 그렇게 움직였는지"를 섹터 로테이션·원자재·매크로 이벤트와 연결해 설명
- 두 버전 자동 생성 —
- 원본 리포트 (전문가용, 디버전스·섹터 로테이션·FedWatch 같은 전문용어 사용)
- 쉬운버전 (입문자용, 상단 미니 용어집 + 본문에 괄호 해설 + 표 아래 "쉬운 해석" 삽입)
- 데이터 충돌 자동 해소 — 서브에이전트가 인용한 뉴스 수치와 MCP 실시간 값이 다르면 MCP를 진실로 채택하고 해소 내역을 리포트 말미에 기록
- 저장 경로:
~/workspace/overnight-market-report/YYYY-MM-DD.md + YYYY-MM-DD-쉬운버전.md (같은 날짜 파일이 이미 있으면 YYYY-MM-DD-HHMM.md 형태로 시간 suffix)
🚀 설치 (README 읽을 필요 없음)
이 섹션은 플러그인이 어떻게 동작하는지 궁금할 때만 보세요. 실제 설치는 아래 두 명령만 실행하면 끝납니다 — 키 발급·환경변수 설정 같은 사전작업이 전혀 필요 없습니다.
⚡ 한 번만 하면 되는 설치 + 첫 실행
1. 플러그인 설치 (Claude Code 세션에서):
/plugin marketplace add today8934/wooksang-marketplace
/plugin install overnight-market-report-plugin@wooksang-marketplace
2. 바로 호출:
미국주식 야간 보고서 뽑아줘
3. 자동 설정 마법사(Setup Wizard)가 뜨고 다음과 같이 진행됩니다:
- 플러그인이 내부적으로
preflight-check 서브에이전트를 돌려 finnhub·alphavantage·tavily 3개 MCP 상태를 확인
- 미설정 상태면 Claude가 누락된 키를 한 개씩 순차로 요청합니다 (각 키마다 무료 발급 링크도 함께 안내)
- 사용자는 링크 타고 가서 무료 가입 → 키 복사 → 대화창에 붙여넣기
- 플러그인이
claude mcp add CLI로 자동 등록
- "Claude Code를 재시작해주세요" 안내 → 재시작 → 다시
미국주식 야간 보고서 호출 → 이번엔 바로 리포트 생성
두 번째 호출부터는 이미 키가 등록돼 있으므로 preflight이 바로 통과하고 리포트가 즉시 생성됩니다. 마법사는 다시 뜨지 않습니다.
🔑 사용되는 3개 API (모두 무료 플랜)
마법사가 직접 안내하지만 참고용:
🧑💻 개발/테스트용 로컬 설치 (기여자 전용)
플러그인 자체를 수정하거나 테스트하려면:
git clone https://github.com/today8934/overnight-market-report-plugin.git
cd overnight-market-report-plugin
claude --plugin-dir .
일반 사용자는 위의 /plugin marketplace add 방식을 사용하세요.
🎯 사용법
Claude Code 세션에서 아래와 같은 자연어 문구 중 아무거나 입력하면 자동 트리거됩니다:
- "미국주식 야간 보고서 뽑아줘"
- "밤사이 증시 어땠어?"
- "간밤 미국 시황 정리해줘"
- "어제 미장 어땠어"
- "밤사이 무슨 일 있었어"
- "미국 증시 브리핑"
Claude는 다음 단계를 순차/병렬로 수행합니다:
- 한국 시각 확인 → 저장 경로 결정
finnhub get_quote ×30+ (지수/섹터/Mag7/원자재/글로벌 ETF), alphavantage forex ×2, WebSearch ×2~3, news-harvester 서브에이전트 ×1 — 한 메시지에서 병렬 실행- 시세·뉴스 종합 분석 → 원본 리포트 작성·저장
readability-pass 서브에이전트 실행 → 같은 디렉토리에 -쉬운버전.md 생성- 사용자에게 두 경로와 TL;DR만 짧게 보고
대략 2~3분 내에 두 파일이 완성됩니다.
📄 산출물 예시 구조
원본 리포트 (YYYY-MM-DD.md)
- 핵심 요약 (TL;DR)
- 미국 3대 지수 (SPY/QQQ/DIA/IWM + VIX)
- 섹터 동향 (XL* ETF 11종 일간 변동률 정렬)
- 주요 종목 (Mag7)
- 원자재 · 금리 · 환율
- 글로벌 증시 (ETF 프록시)
- 국제정세 & 매크로 이벤트 (연준·인플레·지정학·실적)
- 오늘 한국장 관전 포인트
- 데이터 품질 & 소스 (말미)
쉬운버전 (YYYY-MM-DD-쉬운버전.md)
- 최상단: 📘 미니 용어집 (디버전스·섹터 로테이션·CPI·FOMC·VIX·ETF·Mag7 등)
- 본문: 원본과 동일 구조, 단 전문용어 첫 등장 시 괄호 해설 자동 삽입
- 표 아래: "쉬운 해석" 한두 줄 추가
- 말미: 데이터 품질 & 소스
🧠 데이터 소스 역할 분담
| 소스 | 역할 | 주의사항 |
|---|
finnhub get_quote | 주력 시세 (US ETF·주식 전수) | 지수 심볼(^VIX, ^GSPC)은 CFD 구독 제한 → ETF 프록시(SPY/QQQ/VIXY)로 우회 |
alphavantage forex_rate | 환율 (USD/KRW, USD/JPY) | 무료 25/day 제한 — 환율 전용으로만 사용 권장 |
tavily_search + tavily_extract | 뉴스·매크로 원문 리서치 | 서브에이전트 격리 호출 (메인 context 오염 방지) |
WebSearch (Claude 내장) | 뉴스 교차검증, VIX/10Y 금리 백업 | 쿼리에 항상 현재 연/월 명시 |
사용 금지 도구 — 플러그인 내부에서 호출하지 않음:
yfinance MCP: 이 저자 환경에서 모든 티커를 ¥0으로 반환하는 버그 확인finnhub news_sentiment 메인 직접 호출: 응답 75KB+로 컨텍스트 오염 → 필요 시 서브에이전트 경유
🏗 오케스트레이션 구조
yennanliu
genli-ai
OctagonAI
ameya85
hoangsonww
jeremylongshore