news-engine: Instructions file for Claude Code

News Engine — AI 테크 뉴스 분석 엔진 Claude Code 작업 지침서

프로젝트 개요

글로벌 AI/테크 뉴스를 자동 수집 → Claude API로 분석(요약, 관련 산업, 호재/악재, 영향 크기, 총평) → 텔레그램 채널로 매일 아침 자동 발송하는 파이프라인. 포트폴리오/실사용 겸용. SQLite에 저장하여 나중에 앱 백엔드로 재활용 가능.

기술 스택

• 런타임: Node.js + TypeScript (strict)
• 뉴스 수집: rss-parser (해외 RSS), Naver News Search API (한국 뉴스)
• AI 분석: Anthropic Claude API (@anthropic-ai/sdk)
• 텔레그램 발송: grammy
• 데이터베이스: SQLite (better-sqlite3)
• 스케줄링: node-cron
• 환경변수: dotenv
• 빌드: tsx (실행), tsup (빌드)

---

아키텍처

[뉴스 소스]          [수집기]          [분석기]         [발송기]

RSS Feeds ────→ Collector ────→ Analyzer ────→ Publisher
Naver API ──┘    (수집+중복제거)   (Claude API)    (Telegram)
                      │                │              │
                      └────── SQLite DB ──────────────┘
                              (articles, analyses)

                    [스케줄러]
                    node-cron
                    매일 06:00 KST

데이터 흐름

1. Collector: RSS + Naver API에서 뉴스 50~100건 수집 → 중복 제거 → DB에 raw articles 저장
2. Analyzer: Claude API로 중요도 필터링(상위 5건 선정) → 각 뉴스 분석(요약/태그/호악재/영향도/총평) → DB에 분석 결과 저장
3. Publisher: 분석된 5건을 텔레그램 카드 포맷으로 발송
4. Scheduler: 매일 아침 6시(KST) 자동 실행 (Collector → Analyzer → Publisher)

---

뉴스 소스

한국 뉴스

소스	수집 방법	비고
네이버 뉴스	Naver Search API (news)	키워드: "AI", "인공지능", "테크", "IT"
전자신문 IT	RSS feed	etnews.com
매일경제	RSS feed	mk.co.kr IT 섹션

해외 뉴스

소스	수집 방법	RSS URL
TechCrunch	RSS	https://techcrunch.com/feed/
The Verge	RSS	https://www.theverge.com/rss/index.xml
Ars Technica	RSS	https://feeds.arstechnica.com/arstechnica/index
Hacker News	API/RSS	https://hnrss.org/frontpage

---

폴더 구조

news-engine/
├── src/
│   ├── index.ts              # 메인 엔트리 (스케줄러 시작)
│   ├── pipeline.ts           # 파이프라인 오케스트레이터 (collect → analyze → publish)
│   ├── collector/
│   │   ├── index.ts          # 수집기 통합 (RSS + Naver 합치기, 중복 제거)
│   │   ├── rss.ts            # RSS 피드 수집 (rss-parser)
│   │   └── naver.ts          # 네이버 뉴스 API 수집
│   ├── analyzer/
│   │   ├── index.ts          # 분석기 메인 (필터링 + 분석)
│   │   ├── filter.ts         # Claude로 중요도 필터링 (50건 → 5건)
│   │   └── analyze.ts        # Claude로 개별 뉴스 상세 분석
│   ├── publisher/
│   │   ├── index.ts          # 발송기 메인
│   │   └── telegram.ts       # 텔레그램 카드 포맷 발송 (grammy)
│   ├── db/
│   │   ├── index.ts          # SQLite 초기화 + 쿼리 함수
│   │   └── schema.ts         # 테이블 스키마 정의
│   ├── config/
│   │   ├── sources.ts        # RSS 소스 목록
│   │   └── prompts.ts        # Claude API 프롬프트 템플릿
│   └── types/
│       └── index.ts          # 공통 타입 정의
├── data/
│   └── news.db               # SQLite 데이터베이스 파일 (gitignore)
├── .env.example              # 환경변수 예시
├── .env                      # 환경변수 (gitignore)
├── .gitignore
├── package.json
├── tsconfig.json
├── CLAUDE.md
└── README.md