EalZz/IT-AI-NEWS：基于 Gemini 的 AI 新闻监控机器人

AI News Agent Pipeline

매 시간마다 'AI타임스'와 'PyTorch KR' 뉴스를 모니터링하고, LLM(Google Gemini)을 통해 핵심 뉴스만 선별하여 마크다운 형태로 직관적으로 요약한 뒤 지정된 디스코드 채널로 전송하는 스마트 뉴스 에이전트 봇입니다.

🏗️ 시스템 아키텍처 (Architecture Flow)

현재 에이전트는 단기 기억 모듈과 LLM 중요점수 필터링이 결합된 1시간 단위 스케줄러를 기반으로 동작합니다.

sequenceDiagram
    participant GH as GitHub Actions (스케줄러)
    participant Scraper as 뉴스 스크래퍼
    participant State as 상태 관리자 (Memory)
    participant LLM as Gemini API (에이전트 판단)
    participant Discord as Discord Webhook

    loop 매 시간 0분
        GH->>Scraper: 에이전트 구동 시작
        Scraper->>Scraper: AI타임스 & PyTorch KR<br/>RSS 데이터 파싱
        Scraper->>State: 최근 100개의 '보낸 기사' 상태 파일(JSON) 요청
        State-->>Scraper: 이전 기사 URL 목록 반환
        Scraper->>Scraper: 중복 기사 배제 (새로운 뉴스만 필터링)
        
        alt 새로운 기사가 없을 경우
            Scraper-->>GH: [작업 종료]
        else 새로운 기사가 있을 경우
            Scraper->>LLM: 새 기사 목록 전송 및 평가 요청 (중요도 심사)
            LLM->>LLM: 기사 분석 및 필터링 수행
            
            alt 뉴스 중요도가 낮은 경우 (SKIP)
                LLM-->>Scraper: "SKIP" 문자열 반환
                Scraper-->>GH: [작업 종료]
            else 중요 속보/특급 기사인 경우
                LLM-->>Scraper: 주요 기사 마크다운 요약 결과 반환
                Scraper->>Discord: 요약 본문 푸시 전송
                Scraper->>State: 이번에 읽은 기사 URL 추가 (기억 업데이트)
                State->>GH: 기억된 JSON 상태 파일을 저장소에 Commit & Push
            end
        end
    end

🚀 로컬 환경 구동 방법 (테스트 목적)

Python 환경에서 패키지를 설치합니다: pip install -r requirements.txt

.env 파일을 프로젝트 루트에 생성하고 아래 환경변수를 입력합니다.

GEMINI_API_KEY=당신의_구글_제미나이_API_키
DISCORD_WEBHOOK_URL=웹훅주소1,웹훅주소2

python main.py를 실행하여 로컬 환경에서 메시지 전송 및 필터링 로직을 테스트해 봅니다.

빈 GitHub Repository를 Private로 생성합니다.
현재 폴더의 내용물을 생성한 GitHub Repository에 커밋하고 푸시합니다.
GitHub Repository 페이지 상단의 Settings 탭으로 이동합니다.
왼쪽 메뉴에서 Secrets and variables -> Actions 를 클릭합니다.
[New repository secret] 버튼을 눌러 다음 2개의 Secret을 등록합니다.
- Name: GEMINI_API_KEY / Value: (당신의 API Key)
- Name: DISCORD_WEBHOOK_URL / Value: (디스코드 웹훅 주소)
.github/workflows/daily_summary.yml 코드가 이미 포함되어 있으며, 리포지토리 설정에서 Actions의 읽기/쓰기 권한(Read and write permissions)이 켜져 있어야 상태 저장(Commit)이 가능합니다.
액션이 켜지면 매 정각마다 코드가 동작하며 새 뉴스를 디스코드로 전송합니다. 수동 실행은 Actions 탭의 Run workflow 버튼을 이용합니다.