notion-finance-digest

매달 1일·15일·말일 자동으로 시장 데이터·뉴스를 수집해 Notion에 저장하는 투자 리서치 자동화 시스템.
MCP 서버(server.py)와 GitHub Actions 배치 스크립트(daily_action.py)로 구성됩니다.

⚠️ Notion 관련 작업은 이 폴더를 VS Code에서 열고 사용해야 합니다.
CLAUDE.md가 이 폴더에 위치해 있어, 여기서 열어야 Claude가 Notion 규칙을 적용합니다.

📁 파일 구조

notion-finance-digest/
├── .github/
│   └── workflows/
│       └── daily.yml       # GitHub Actions 워크플로우 (매달 1일·15일·말일 09:00 KST 자동 실행)
├── CLAUDE.md               # Claude Code 작업 규칙
├── daily_action.py         # 일일 자동화 스크립트 (GitHub Actions 전용)
├── server.py               # MCP 서버 (Notion 저장 도구)
├── .env                    # 환경변수 (직접 생성, git 제외)
├── .env.example            # 환경변수 템플릿
├── requirements.txt
└── README.md

Related MCP server: notion-mcp-server

🤖 일일 자동화

GitHub Actions 자동 실행

• 스케줄: 매달 1일·15일·말일 오전 09:00 KST (GitHub cron 최대 수 시간 지연 가능)

• 실행일 외: cron은 1,15,28-31에 매번 트리거되며, 스크립트 내부에서 calendar.monthrange로 실제 1일/15일/말일 여부를 재확인해 아니면 스킵

• 공휴일: 한국 공휴일 자동 감지 후 스킵 (holidays 라이브러리)

• 시간대: KST(UTC+9) 기준으로 날짜·말일 계산

• 수동 실행: GitHub → Actions → Daily Notion Summary → Run workflow

• 필요 Secrets: NOTION_API_KEY, ANTHROPIC_API_KEY

• Node.js: 24 강제 적용 (FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: 'true')

• AI 모델: Claude Sonnet 4.6 (Anthropic API)

• RSS 재시도: 0건 반환 시 3초 간격으로 최대 2회 자동 재시도

• 빈 콘텐츠 방지: 모든 국내 뉴스 소스가 0건이면 ①② 저장 스킵

저장 항목 (4개)

• 오늘 날짜 페이지가 이미 있으면 항목별 자동 스킵

• 4개 항목 Claude 요약 병렬 생성 후 순차 저장

실행 순서

1. 오래된 항목 자동 삭제 — RETENTION_DAYS 기준 초과 항목 아카이브

2. 중복 체크 — 오늘 날짜 페이지 이미 존재하면 해당 항목 스킵

3. 데이터 수집 — RSS·yfinance·네이버 금융 병렬 수집

4. Claude 요약 생성 — 필요한 항목만 병렬 API 호출

5. Notion 저장 — stock_research DB에 페이지 생성

데이터 소스

보존 기간 (자동 삭제)

🗄️ Notion DB 구조

모두 "Finance & 투자" 페이지 (33117b872be68187a1b4ddc51261856e) 내 인라인 DB.

🔧 MCP 도구 (server.py)

save_summary_to_notion 파라미터

⚙️ 환경 설정

의존성 설치

& "D:\Anaconda3\envs\project\python.exe" -m pip install -r requirements.txt

환경변수 (.env)

NOTION_API_KEY=secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NOTION_PAPER_DB_ID=34617b872be68060a474e18a73510f38
NOTION_STOCK_RESEARCH_DB_ID=39bf50a1aca04ad2a10079e958cf96d4
NOTION_STOCK_STUDY_DB_ID=d1afcb876857487eb978c1a8e0952d05
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx

MCP 서버 등록 (Claude Code)

~/.claude/settings.json에 추가:

{
  "mcpServers": {
    "notion-finance-digest": {
      "command": "D:\\Anaconda3\\envs\\project\\python.exe",
      "args": ["d:/projects/python/notion-finance-digest/server.py"]
    }
  }
}

✍️ 콘텐츠 포맷 규칙

• 마크다운 헤더(##, ###) 사용 금지 → ━━━ 섹션명 ━━━ 형식 사용

• 이모지 적극 활용 (섹션 구분, 수치 강조)

• 문단 형식으로 충분히 서술 (bullet 나열 금지)

⚠️ 주의사항

• .env는 .gitignore에 포함되어 있습니다. API 키를 커밋하지 마세요.

• Notion DB의 title 프로퍼티 이름은 자동으로 감지합니다.

• 본문이 길면 자동 분할 저장합니다 (Notion 블록 제한: 2000자).

• MCP 서버 코드 변경 후에는 Claude Code를 재시작해야 합니다.

• 포트폴리오 변경 시 daily_action.py 상단 PORTFOLIO_HOLDINGS 상수를 수동으로 업데이트해야 합니다.