leiting-eric/DailyBrief

DailyBrief – 개인용 AI 기반 일일 뉴스레터

무엇인가요 – 뉴스, 시장 데이터, AI 생성 요약을 하나의 이중 언어(중국어/영어) HTML 보고서로 통합하는 자체 호스팅형 Node/TypeScript 앱입니다. 6가지 LLM 백엔드(Claude, Anthropic, OpenAI, DeepSeek, MiniMax, Zhipu)와 호환되며 GitHub Actions + Pages, 로컬 머신, 또는 자체 서버에서 실행 가능합니다.

주요 기능

• 다중 소스 집계 – 기술(GitHub Trending, AI 블로그, X/Twitter), 금융(Bloomberg, WSJ, FT), 정치(BBC, Guardian, NYT 등) 및 커뮤니티 사이트(V2EX, Hacker News, Reddit)를 포함한 26개 기본 피드. 모든 소스는 무료 RSS 또는 공개 JSON 엔드포인트이며 API 키가 필요하지 않습니다.
• 시장 스냅샷 – 미국 주식, ETF, 암호화폐, 홍콩 주식, 상품, 거시경제 지표 등 21개 종목의 실시간 데이터. SMA, RSI, MACD 계산과 함께 LLM이 작성한 일일 거래 코멘트 제공.
• 플러그인식 LLM – 환경 변수와 해당 시크릿만 설정하면 6개 백엔드를 간단히 전환 가능. 코드 변경 없이 가능.
• 이중 언어 출력 – REPORT_LOCALE=zh는 중국어 보고서를, en은 완전한 영문 버전(UI 텍스트, 프롬프트, 입장 표현, 날짜 형식)을 생성.
• 제로비용 데이터 – 모든 뉴스 피드는 공개. 유일한 비용은 LLM API 호출(예: DeepSeek ≈ 1달러/월).
• 단일 파일 HTML – 생성된 페이지는 CSS/JS를 인라인으로 포함하므로, 어떤 정적 호스팅에서도 직접 제공 가능.

실행 방법

옵션	대상 사용자	필요 사항	설정 시간
A – GitHub Actions + Pages	서버 없이 무료 공개 URL을 원하는 사용자	GitHub 계정 + 어떤 LLM 백엔드의 API 키	약 5분(포크 → 시크릿/변수 추가 → 워크플로우 실행)
B – 로컬 원클릭 설치	항상 켜져 있는 컴퓨터/서버를 보유한 사용자	Node 20+, git, 선택적 Claude CLI	약 3분(bootstrap.mjs 스크립트 실행)
C – AI 에이전트 설치	AI 어시스턴트(Claude Code, Cursor 등)가 설치를 도와주길 원하는 사용자	B와 동일	에이전트에 1개 프롬프트만 전달

일반 워크플로우

1. 설정 – LLM_BACKEND과 해당 시크릿을 설정(또는 기본 Claude-CLI 사용). 모델, 기본 URL, 보고서 로케일, 타임존, 시간 및 일수를 변경할 수 있는 선택 변수 제공.
2. 스케줄링 – GitHub Actions는 REPORT_TZ를 확인하고 로컬 시간이 REPORT_HOUR와 일치할 때만 빌드를 실행. 로컬 설치는 cron, launchd 또는 Windows 작업 스케줄러를 등록.
3. 실행 – npm run daily는 모든 소스를 가져오고, 시장 지표를 계산하고, LLM에 요약 및 거래 코멘트를 요청한 후 단일 index.html을 렌더링.
4. 배포 – GH-Actions 모드에서는 HTML이 자동으로 gh-pages 브랜치에 푸시되어 GitHub Pages로 제공. 로컬 모드에서는 DEPLOY_HOST와 DEPLOY_PATH를 설정하면 SCP를 통해 자체 서버에 자동 배포 가능.

사용자 맞춤 설정

• 소스 추가/제거 – sources.config.json 편집. 각 항목은 id, name, type(rss/api/scrape), url, category, locales 등을 정의. npm run sources:check로 검증 가능.
• 프롬프트 변경 – 모든 LLM 프롬프트는 lib/ai/prompts.ts에 있으며 백엔드에 독립적.
• 시장 종목 조정 – lib/trading/를 수정하여 심볼 추가. 파이프라인은 자동으로 SMA/RSI/MACD 재계산.
• 다른 곳에 배포 – DEPLOY_HOST/DEPLOY_PATH 설정 시, nginx, Apache 등 어떤 웹 서버에도 SCP로 보고서 전송 가능.

왜 중요한가 DailyBrief는 Feedly, Pocket 등 제3자 리딩 서비스에 의존하지 않고, 완전히 개인적이고 최신의 브리핑을 제공합니다. LLM이 플러그인 가능하고 데이터 소스가 무료이므로, 비용은 거의 제로로 유지하면서도 원하는 언어로 AI 강화된 시장 인사이트와 기술 뉴스를 받을 수 있습니다.

링크

• 실시간 데모(GitHub Pages) – https://leiting-eric.github.io/DailyBrief
• 자체 호스팅 데모 – https://daily.leiting.tech
• 리포지토리 – https://github.com/leiting-eric/DailyBrief