Home

HackDigest — Wiki

AI-summarized daily news digest — delivered to your inbox every morning.

프로젝트 개요

HackDigest는 매일 아침 Tech, 주식, 부동산 분야의 최신 뉴스를 수집하고, AI(Groq LLM)로 요약한 후 이메일로 발송하는 자동화된 뉴스 다이제스트 서비스입니다.

구독 페이지: minjungsung.github.io/hackdigest

비용: $0/month — 100% 서버리스 아키텍처

기술 스택

카테고리	기술
언어	Python 3.11
AI 요약	Groq API (qwen/qwen3.8-27b)
번역 폴백	Google Translate (무료 API)
기사 추출	trafilatura
RSS 파싱	feedparser
이메일 발송	Gmail SMTP (SSL)
구독 프록시	Cloudflare Worker (JavaScript)
CI/CD & 런타임	GitHub Actions
캐싱	GitHub Actions Cache (일간 JSON)
구독 페이지	GitHub Pages (vanilla HTML/JS)
스케줄링	cronjob.io → workflow_dispatch
보안	Bandit + 커스텀 인젝션/시크릿 검사
의존성 관리	Dependabot (일간, 자동 병합)

주요 기능

• 멀티 토픽 뉴스 큐레이션 — Tech (Hacker News), 주식 (Yahoo Finance/Google News), 부동산 (Zillow/HousingWire/CNBC)
• 지역별 소스 — 한국어 구독자는 한국 주식/부동산 뉴스, 영어 구독자는 미국 소스
• AI 요약 — Groq Qwen 모델이 3문장 캐주얼 요약 생성, Google Translate 폴백
• 구독자별 개인화 — 언어 + 토픽 선택
• 자동 감지 구독 페이지 — 브라우저 언어 감지, 반응형 UI
• 제로 인프라 비용 — GitHub Actions + Cloudflare Workers + GitHub Pages

Wiki 목차

페이지	내용
Architecture	데이터 파이프라인 흐름, 컴포넌트 다이어그램
Services	각 서비스 상세 설명 (fetchers, summarizer, notifier, subscriber, worker)
Setup Guide	로컬 실행, GitHub Actions 설정, 환경변수, Cloudflare Worker 배포
Adding a News Source	새 뉴스 소스 추가 방법 (fetcher 구현 가이드)

프로젝트 구조

hackdigest/
├── src/
│   ├── main.py           # 엔트리포인트 — 전체 파이프라인 오케스트레이션
│   ├── models.py          # 데이터 모델 (Article, Subscriber, Topic, Language)
│   ├── fetchers/
│   │   ├── __init__.py    # 토픽별 fetcher 라우팅
│   │   ├── tech.py        # Hacker News API fetcher
│   │   ├── stocks.py      # Yahoo Finance / Google News 주식 fetcher
│   │   └── realestate.py  # Zillow / HousingWire / CNBC / Google News 부동산 fetcher
│   ├── summarizer.py      # Groq LLM 요약 + Google Translate 폴백
│   ├── notifier.py        # 이메일 발송 (Gmail SMTP)
│   ├── subscribers.py     # 구독자 관리 (JSON 기반 CRUD)
│   └── cache.py           # GitHub Actions Cache 연동
├── worker/
│   └── src/index.js       # Cloudflare Worker — 구독 프록시
├── docs/
│   └── index.html         # GitHub Pages 구독 페이지
├── subscribers.json       # 구독자 목록
├── requirements.txt       # Python 의존성
├── .github/workflows/
│   ├── daily-digest.yml   # 매일 다이제스트 발송
│   ├── subscribers.yml    # 구독자 관리 (add/remove/update)
│   ├── security-scan.yml  # 보안 스캔
│   ├── clear-cache.yml    # 캐시 초기화
│   └── release.yml        # Semantic Release
└── scripts/
    └── check_injection.py # 인젝션 검사 스크립트