🚀 스터디장님, 새 글 확인하셨나요? - 자동화된 새 글 알림 시스템 구축기

(추가) 새 글 알림 구독을 희망자들도 받으면 어떨까? 싶어서 만들었습니다

👉 게시글 알림 구독하기

이메일만 입력하시면, 새글 올라올 때마다 게시글 요약을 보내드려요!
관심사까지 추가 선택해주시면, 추후 관심사 기반 게시글 큐레이션 기능을 만들 때 추천된 게시글만 받아보실 수 있어요! (언제일지 모름😂)

※ 이 게시글은 지피터스 AI게시글 서포터의 도움을 받아 작성되었습니다. (도움받은 내용은 아래 상세히 기입)

💪 하려던 것

스터디 멤버들이 열심히 사례를 남겨도, 정작 스터디장이 제때 확인하지 못하는 경우 많지 않나요? 🤔 이전에는 스터디장이 수동으로 게시판을 확인해야 했어요.

이런 불편을 해결하기 위해! 새 글을 자동으로 알림 보내주는 시스템을 만들었습니다! 🎉

그리고… 여기서 끝이 아닙니다. 스터디장이 단순히 알림만 받는 게 아니라, AI가 알아서 문제 해결까지 도와주는 시스템까지 만들 예정이에요! 어떻게 만들었는지, 그리고 앞으로 어떤 기능을 추가할 계획인지 같이 한 번 볼까요? 👀

(추가) 사실 채널톡 문의로 어떤 멤버 분 께서 지피터스에도 RSS Feed가 있냐고 질문주셨는데, 어쩌다보니 역으로 그 분께 질문하면서 인사이트를 얻어서, 당장 시도하게 됐습니다 ㅎㅎㅎ Ph4nt0m 님 감사합니다!
채널톡 응대하다가 본격 멤버에게 도움받기..ㅎㅎㅎ (근데 당연히 스터디 멤버인 줄 알고 내적 친밀감 높아서 막 말걸었는데, 알고보니 그냥 커뮤니티 멤버셨던 것... 죄송했습니다 😂)

🎯 목표: 스터디장이 자동으로 새 글을 확인할 수 있도록!

이 프로젝트의 목표는 명확했어요.
✅ 스터디장이 실시간(30분 이내)으로 새 글을 받아볼 수 있어야 한다!
✅ 알림톡을 복붙해서 멤버 카톡방에도 쉽게 공유할 수 있어야 한다!
✅ 멤버가 요청한 도움을 AI가 정리해서 스터디장이 바로 답변할 수 있어야 한다! (향후 추가 예정)

👉 즉, "스터디장이 별다른 인지적 노력 없이 복붙만 하면 되는 시스템!"

🚀 전체적인 자동화 개요

자동화 도구: n8n
핵심 개념: 각 단계별 노드(Node)를 연결하여 RSS 감지 → 게시글 정보 조회 → 요약 생성 → 이메일 발송 과정을 자동화
핵심 목표:
- 스터디장이 새 글을 실시간(30분 이내)으로 확인 가능하도록 자동화
- 스터디장이 별다른 고민 없이 "복붙"만 하면 되는 메시지 제공
- 댓글 피드백 포인트가 명확하게 전달되도록 가이드 포함

📌 주요 노드와 역할

1️⃣ 새 글 감지 (RSS 트리거)

RSS Feed Trigger: https://www.gpters.org/rss/feed를 1분마다 확인해 새 글이 올라왔는지 감지
If contains 14기: 새 글이 특정 스터디(예: "14기")와 관련된 경우에만 다음 단계로 진행

📌 이유:

모든 게시글이 아니라 스터디 태그("14기")가 포함된 글만 필터링하여 알림을 보낼 수 있도록 설정

2️⃣ 스터디 정보 조회

getStudy (Airtable): Airtable에서 해당 스터디 태그("14기")를 가진 스터디의 정보를 가져옴 (스터디장 이메일 등)
getPostId (Code): RSS 링크에서 postId를 추출하여 이후 API 호출에 활용

📌 이유:

스터디장 이메일을 동적으로 가져와야 하므로 Airtable을 활용
RSS의 URL에서 postId를 직접 추출해 Better Mode API에서 글을 조회하기 위함

단어 getstudy, getstudy, getstudy, getstudy, getstudy와 함께 흐름도의 스크린 샷

3️⃣ 게시글 상세 정보 가져오기

getPost (GraphQL): Better Mode API를 통해 게시글 정보를 조회 (제목, 본문, 작성자, 태그 등)
getPostValues (Code): GraphQL 응답에서 필요한 값(제목, 본문, 태그)만 추출
getContentText (Code): HTML 태그, 코드 블록 등을 제거하여 깨끗한 텍스트로 정리

📌 이유:

RSS 데이터만으로는 부족하므로 Better Mode API에서 추가 정보를 가져옴
Claude AI로 요약을 생성하려면 본문이 깔끔해야 하므로 HTML 태그 제거

4️⃣ 게시글 요약 생성 (Claude 활용)

Claude 요약 (HTTP Request): Claude API에 글 내용을 전달하여 마크다운 형태의 요약 생성

📌 이유:

GPT처럼 요약하는 AI를 활용하여 게시글의 핵심 내용을 정리
마크다운 형식으로 반환하면 캔버스, 노션 등에 붙여넣기 용이

{
 "model": "claude-3-5-sonnet-20241022",
 "max_tokens": 8000,
 "messages": [
   {
      "role": "assistant",
      "content": "당신은 발표 슬라이드 구성 도우미입니다. 주어진 게시글을 바탕으로 다음 구조의 발표 슬라이드를 작성하세요:\n\n### 하려던 것 📝  \n- 한 줄 사례 설명을 20자 이상 40자 이내로 \"~한 사례\" 형식으로 작성.  \n- 목적, 배경, 해결하고자 한 내용을 '~함' 형식으로 작성  \n- 간결하면서 충분한 설명이 되도록 작성  \n\n### 활용한 툴 ⚒️  \n이 사례를 만드는 동안 사용된 모든 AI 도구나 툴을 어떤 목적으로 사용했는지 간단히 작성하세요.  \n예시:  \n- Claude : 코드 작성 및 수정, 네이버 지도 구조 분석  \n\n### 진행 세부 내용 🔍  \n- 단계별로 1️⃣, 2️⃣ 형식으로 작성(제목은 볼드체)  \n- 각 단계에서 다음 내용을 자세히 설명:  \n  - 시도한 방법과 접근 방식  \n  - 사용한 프롬프트나 코드  \n  - 발생한 문제와 해결 방법  \n  - 얻은 결과나 피드백  \n- 모든 설명은 '~함' 형식으로 작성  \n- 구체적인 수치나 예시 포함  \n\n### 시행착오 ⚠️  \n- 발생한 어려움과 해결 과정  \n- 실패한 시도와 남은 과제 포함  \n\n### 배운 점 📚  \n- 실제 경험에서 얻은 인사이트를 구체적 예시와 함께 작성  \n\n### 도움이 필요한 점 🤝  \n게시글에서 언급된 실제 문제나 의문점을 바탕으로, 코치가 구체적인 해결책을 제시할 수 있도록 상세히 작성합니다.  \n\n각 문제는 다음 형식으로 작성, 문제점 갯수만큼 작성:  \n1️⃣ 문제점 제목  \n   - 현재 상황: 구체적인 문제나 제한사항 설명  \n   - 시도한 방법: 시도해본 해결책과 그 결과  \n   - 필요한 도움: 필요한 해결책이나 방향성  \n\n**주의사항:**  \n- 모든 항목은 불렛포인트로 작성  \n- 작성되지 않은 내용은 임의로 생성하지 말 것  \n- 내용이 부족한 경우 \"내용이 부족하여 요약하지 못했습니다\"라고 답변  \n- 포맷에 맞춰 답변만 출력할 것"
    },
   {
     "role": "user",
     "content":{{ $json.content }}
   }
 ]
}

5️⃣ 이메일 & 메시지 최적화

필요한 데이터 매핑 (Set): Claude 요약 결과, 스터디장 이메일, 게시글 링크 등을 한 곳에 정리
Markdown to Html (Code): Claude 요약 결과(마크다운)를 이메일용 HTML로 변환

📌 이유:

이메일에서 마크다운이 깨지므로 JS 코드로 마크다운 → HTML 변환 필요
이 과정에서 리스트, 들여쓰기 등의 포맷을 조정하는 데 시행착오가 많았음

6️⃣ 최종 이메일 발송 (Gmail API)

Gmail: 스터디장 이메일로 새 글 알림 전송 (HTML 포맷)

📌 이유:

스터디장이 이메일을 통해 빠르게 새 글을 확인할 수 있도록 자동 발송

이메일 결과

배운 점 공유 🔥

📌 RSS Feed Trigger vs RSS Read 노드 차이

노드

역할

동작 방식

RSS Feed Trigger

새 글이 올라왔을 때 트리거됨

직전 실행 시점 이후 새롭게 추가된 글만 반환

RSS Read

RSS 피드를 조회하여 글을 가져옴

지정된 개수(기본 10개)를 한 번에 가져옴

📌 핵심 차이:

RSS Feed Trigger는 새롭게 추가된 글만 감지 (이전 실행 이후 추가된 항목만 반환)
RSS Read는 현재 RSS 피드에서 최신 글 몇 개를 가져오는지 정하는 역할 (보통 기본값은 10개)

📌 RSS Feed Trigger는 즉각적인 업데이트가 가능한가?

RSS 피드가 즉각적으로 업데이트되는지는 서비스에 따라 다름
일반적으로 RSS는 "폴링(Polling)" 방식으로 일정 주기마다 업데이트됨
즉, 실시간 즉각 반영은 아니고, RSS 제공자가 업데이트할 때마다 반영됨
하지만 n8n에서는 최소 1분 간격으로 주기 설정 가능 → 사실상 최대 1분 정도의 딜레이로 새 글을 감지할 수 있음

📌 정리하자면:

RSS Feed 자체는 즉각적인 업데이트는 아니지만, n8n이 1분 간격으로 체크하면 거의 실시간처럼 작동
RSS 제공자가 업데이트하는 주기(서버에 따라 다름) 때문에 몇 초 정도의 딜레이는 있을 수 있음

🛠 시행착오 & 해결 과정

🔹 Markdown → HTML 변환 이슈

Claude 요약 결과가 마크다운(Markdown)으로 제공되어, 이메일에서는 HTML로 변환해야 했음.
기존 변환 코드에서 리스트 들여쓰기 문제 발생 → 불렛포인트가 깨지거나 들여쓰기가 비정상적으로 표시됨.
Markdown to HTML 변환 코드를 수정하고, 여러 번 테스트하여 최적화 완료.

🔹 RSS에서 다수의 게시글 처리 문제

RSS Feed Trigger가 새 글이 올라왔을 때 트리거되지만, 한 번에 여러 개의 게시글이 들어오면 배열 형태로 전달됨.
초기 테스트에서는 단일 게시글 기준으로만 처리하여 여러 개가 감지될 경우 누락되는 문제 발생할 수 있음 (아직 미확인)
Split In Batches 노드를 활용하여 배열을 개별적으로 처리하도록 개선하면 된다고 함!

📌 향후 해야 할 작업 (To-Do List)

사실 그냥 n8n 워크플로 만든 거라, AI Agent를 쓰지 못했어서, 어떤 부분에서 에이전트를 써서 14기 n8n에이전트 스터디 사례글로 만들까.. 고민하다가, '도움필요항목'을 AI agent가 직접 검색해서 답변 초안까지 제공해주는 걸 해보기로 했음!!

✅ 카카오 알림톡 자동 전송 (SOLAPI 활용)

n8n에서 SOLAPI API 연동하여 카카오톡 알림 자동 발송 기능 추가하기
스터디장이 복붙 없이 바로 공유할 수 있도록 알림톡 메시지 템플릿 만들기
알림톡에 게시글 제목, 요약, 링크 포함하여 가독성 높이기

✅ 스터디장이 댓글 달기 쉽게 도움 요청 정리

Claude 요약에서 "도움이 필요한 점"만 자동 추출하는 기능 구현하기 (js 코드)
이메일과 알림톡에서 해당 섹션을 강조하여 스터디장이 한눈에 파악할 수 있도록 개선하기

✅ Perplexity AI를 활용한 해결책 자동 생성

Claude 요약을 Perplexity AI에 전달해 관련된 최신 정보를 검색하도록 설정하기
검색된 내용을 요약하고, 실질적인 해결책을 제안하는 형태로 정리하기
스터디장이 바로 활용할 수 있도록 이메일 본문에 Perplexity 결과 포함하기

✅ 이메일 본문 내 Claude 요약 + Perplexity 해결책 분리

Claude 요약과 Perplexity AI 검색 결과를 명확히 구분하여 가독성 높이기
Perplexity 검색 결과에서 핵심 내용만 정리하여 제공, 불필요한 정보 제거하기

(추가) 구독자 알림기능 + RSS 복수 개 감지 시 반복문 기능 추가

게시글 서포터 GPT 활용법 - 후기

너무 딱딱하게 나오는 게 마음에 안들었고(안 읽힘), 그리고 내가 충분히 맥락을 주지 않았는데 바로 게시글이 작성되는 게 마음에 안들었음
프롬프트로 내가 원하는 방향대로 써주고, 질문해주라고 요청했음
결론 : n8n 워크플로 json 을 던져주고 사례글 작성을 위한 질문 던져달라고 하니까 훨씬 질문이 뾰족하고, 내가 생각치 못했던 부분도 질문해줘서 큰 도움이 됐음.