ChatGPT Notion 뉴스레터 파이프라인 만들기

ChatGPT Notion 뉴스레터 파이프라인 만들기

ChatGPT Notion 뉴스레터 파이프라인 만들기

기록만 쌓이고 발행은 미뤄지는 구독함 구출하기

오늘 만들 것
기록만 쌓이고 발행은 미뤄지는 구독함 구출하기

유익한 소식을 전달하겠다는 뚜렷한 목표를 품고 정기 간행물 발행을 시작하지만, 매번 새로운 글을 쓰기 위해 빈 화면을 마주하는 일은 생각보다 쉽지 않습니다. 일상 속에서 유용한 아이디어나 링크, 그리고 짤막한 생각들을 메모 앱에 틈틈이 모아두더라도, 정작 발행일이 다가왔을 때 이를 일목요연하고 정돈된 하나의 구조로 조작하고 다듬는 편집 단계에서 예상보다 많은 시간과 노력이 들어가곤 합니다. 이러한 반복 업무가 누적되면 글쓰기 자체에 대한 부담감이 커지고 결국 정기적인 발행 일정이 미뤄지는 현상으로 이어집니다.

수작업으로 이루어지던 단순 정보 취합과 가공 단계를 코드로 자동 처리하여 효율을 개선하면, 창작자는 콘텐츠의 깊이를 더하는 본질적인 작업에 훨씬 몰입할 수 있는 환경이 조성됩니다. 본 글에서는 메모용 데이터베이스에 저장한 거친 기록들을 자동으로 분류하고, 가독성이 뛰어난 마크다운 문서로 편집하여 저장하는 소형 파이프라인 설계 방법을 상세히 다룹니다. 소프트웨어 개발에 익숙하지 않더라도 직관적인 경량 도구를 순차적으로 구성하여 단 몇 분 만에 동작하는 시스템을 완성할 수 있습니다.

준비물

준비물

자동 처리 시스템을 원활하게 가동하기 위해 준비해야 하는 요소는 매우 간결합니다. 우선 인공지능 모델의 API를 호출하는 데 사용되는 개별 접근용 인증 토큰이 필요하며, 정보를 상시 보관하는 Notion 작업 공간 데이터베이스의 고유 식별 주소가 필요할 뿐입니다. 시스템 아키텍처를 방대하게 설계하여 시작부터 시간을 소모하기보다는, 데이터가 막힘없이 흐르는 것을 직관적으로 증명할 수 있는 가벼운 스크립트 작성에 초점을 맞춰 개발을 조율합니다. 데이터베이스에 누적된 리소스 정보를 안전하게 읽어 들이고, 이를 바탕으로 인공지능이 매끄러운 어투의 초안으로 조율하는 간결한 연동 애플리케이션의 구현을 시작해 보겠습니다.

Notion 메모를 모아 정기 간행물 초안으로 합치기

Notion 메모를 모아 정기 간행물 초안으로 합치기

1
데이터베이스 연동과 기본 뼈대 잡기
AI에게 보낸 프롬프트
Notion API를 사용해서 특정 데이터베이스의 페이지 제목과 본문 내용을 텍스트로 읽어오는 Node.js 스크립트를 작성해줘. 라이브러리는 @notionhq/client를 사용하고, API 키와 데이터베이스 ID는 환경변수에서 읽도록 구현해줘. 결과는 단순히 콘솔에 출력하는 형태면 충분해. 파일은 index.js 하나에 담아줘.

첫 단계는 외부 데이터 플랫폼인 데이터베이스에서 가공되지 않은 텍스트 정보를 로컬 터미널로 성공적으로 불러오는 기초 작업입니다. 프로젝트 초기부터 다채로운 프롬프트 지시문이나 정교한 마크다운 파서를 함께 얹어 실행하면, 에러가 발생했을 때 로직 혼선으로 인해 디버깅이 곤란해질 우려가 있습니다. 이러한 혼란을 차단하기 위해 공식 SDK를 프로젝트에 설치하고, 데이터베이스 내부의 정보들이 콘솔 화면에 단순히 출력되는 핵심 부위부터 소규모로 구축합니다. 환경 변수에 입력한 인증 정보들이 서로 정확하게 일치한다면, 지정한 원본 데이터가 터미널 화면에 즉각 표시되는 결과를 확인하게 됩니다.

2
ChatGPT API 연동해서 초안 작성하기
AI에게 보낸 프롬프트
index.js에 OpenAI API 연동을 추가해줘. Notion에서 읽어온 원시 텍스트 데이터 배열을 ChatGPT에게 전달해서 하나의 정돈된 주간 뉴스레터 본문으로 편집하도록 만들 거야. 뉴스레터는 마크다운 포맷이어야 하고 서론, 본론(각 메모들의 내용을 흐름에 맞게 엮어서 풀이한 것), 결론 구조를 갖춰야 해. 완성된 결과물은 완성본.md 파일로 저장되도록 구현해줘.

외부 데이터베이스와의 연동에 성공하여 텍스트를 안정적으로 가져온 후에는, 이 원시 데이터를 생성형 AI 엔진으로 전달하여 세련된 편집을 수행할 차례입니다. 단편적인 여러 메모가 사전에 상세하게 설정한 편집 기준에 맞추어 하나의 유기적인 마크다운 문서로 합쳐지는 과정에 해당합니다. 이 단계를 거치면 매주 여러 개의 기록들을 복사하여 수동으로 배치하고 어휘를 조율하던 편집 과정이 획기적으로 단축되는 이점이 있습니다. 스크립트 작동 커맨드를 입력하면 디스크에 초안 텍스트 파일이 즉시 생성되어 저장되는 로직까지 얹으며 핵심 제어 흐름이 완성됩니다.

3
AGENTS.md 파일로 뉴스레터의 톤과 규칙 다듬기
AI에게 보낸 프롬프트
뉴스레터 본문 생성을 담당하는 ChatGPT의 시스템 프롬프트를 분리해서 AGENTS.md 파일로 관리하고 싶어. 코드 내부에 프롬프트를 직접 박아넣지 말고, 스크립트 실행 시 AGENTS.md의 내용을 읽어와서 시스템 프롬프트로 주입하도록 index.js를 수정해줘. 그리고 AGENTS.md에는 다음 규칙을 작성해줘: 이모지 금지, 문장은 간결한 구어체로 작성할 것, 각 소주제 뒤에 출처나 메모의 핵심 키워드를 괄호로 명시할 것.

실행 코드 내부에 인공지능 지시 사항을 길게 포함하는 대신, 전용 설정 마크다운 파일로 완전하게 격리하여 관리 편의성을 향상시키는 설계 방식을 제안합니다. 가공 로직이 들어 있는 코드 영역과 어조를 정의하는 규칙 영역을 이처럼 분리하면, 이후 이식성과 관리 효율을 높여주는 유용한 설계 구조를 완성하게 됩니다. 메인 실행 파일의 자바스크립트 코드를 건드리지 않고 규칙 명세서의 특정 항목만 부분적으로 변경하는 방식으로, 결과물의 분위기나 요약 품질을 자유롭게 조정하기에 용이합니다. 지시 파일을 따로 격리함으로써 작동 방식에 영향을 주는 에러 위험 없이 오직 결과물의 퀄리티 고도화에 전념할 수 있는 환경이 조성됩니다.

4
마크다운 검수와 빌드 피드백 반영하기
AI에게 보낸 프롬프트
완성된 index.js와 AGENTS.md를 검수하고, 마크다운 포맷팅 오류나 누락된 환경변수 처리가 있는지 교차 검증해줘. 특히 Notion의 리치 텍스트 데이터에서 본문을 추출할 때 발생할 수 있는 에러 핸들링과 예외 처리가 들어있는지 꼼꼼히 확인하고 수정 버전을 보여줘.

마지막 과정은 예외 상황에 유연하게 대응하도록 방어적인 코드를 작성하여 신뢰도를 탄탄히 하는 단계에 해당합니다. 데이터베이스에서 수집해 온 날것의 데이터는 가끔 일부 내용이 누락되었거나 비정상적인 포맷을 가지고 있어 예상외의 에러를 발생시키기 쉽습니다. 더불어 인공지능 API 서버의 응답 지연이나 순간적인 통신 장애 상황도 함께 대비해야 마땅합니다. 본문 데이터의 부재를 사전 확인하는 조건문과 호출 실패 시의 비동기 예외 처리를 꼼꼼하게 배치하면, 서비스가 중단되는 현상을 최소화하고 매끄럽게 돌아가는 자동 가동 시스템을 얻게 됩니다.

예외 상황 대응 및 해결 방안

자동화 구동 과정에서 일반적으로 발생할 수 있는 주요 장애 유형 세 가지와 이를 해결하기 위한 구체적인 대처 방식을 아래와 같이 안내합니다. 첫 번째 상황은 원활한 자격 증명을 완료한 상태인데도 데이터를 요청했을 때 빈 리스트 결과만 콘솔에 반환되는 경우입니다. 이는 API 연동 권한을 발급받은 것과는 별도로, 조회 타깃인 Notion 데이터베이스의 개별 권한 설정에서 해당 API 통합 이름을 찾아 수동으로 접근 허용을 추가하지 않아 조회가 거부된 원인으로 분류됩니다. 대상 데이터베이스 설정의 연결 옵션을 통해 봇 권한을 직접 추가해주야 정상적으로 작동합니다.

두 번째 유형은 실행 시 설정 파일 로드에 실패하여 파일 경로 오류나 객체 생성 실패가 표시되는 경우입니다. 이러한 오류는 환경 변수를 주입하는 초기화 모듈의 호출 시점이 어긋났거나 로드 경로가 틀렸을 때 빈번하게 나타납니다. 코드의 맨 앞부분에 환경 구성 함수를 먼저 배치하도록 코드를 정렬하거나, 실행 명령어의 인자로 필요한 설정값을 함께 밀어 넣음으로써 해결 경로를 우회하는 방법을 권장합니다.

세 번째 유형은 최종 완성본에서 단락의 인과관계가 깨지거나 내용의 일부분이 누락되는 정합성 문제입니다. 이는 단일 처리에 넘겨진 데이터의 크기가 API의 최대 수용 토큰 범위를 초과하면서 모델이 문맥 파악에 실패하여 일어납니다. 이를 개선하기 위해 규칙 파일 내부에 원시 레코드 단위를 명확하게 구분하라는 가이드를 삽입하고, 일회 전송당 취합하는 리소스 데이터의 양을 조절하는 제약 사항을 설계 단계에 적용하여 대응해야 합니다.

마치며

이와 같이 구성한 자동화 흐름 덕분에 매번 수집 도구와 글쓰기 편집기를 번거롭게 전환하면서 허비하던 조율 작업이 명령어 호출 한 번으로 가볍게 단축됩니다. 이후 진행 단계에서는 이번에 생성한 마크다운 문서 파일을 발송 솔루션 API와 연결하여, 구독 관리 페이지에서 독자들에게 작성 완료된 발행물을 정기적으로 편리하게 전송하는 고도화된 배포 체인까지 유기적으로 이어갈 수 있습니다.

관련 검색어

  • 🔍 ChatGPT 사용법
  • 🔍 ChatGPT 비교
  • 🔍 Notion 사용법
  • 🔍 Notion 비교
  • 🔍 뉴스레터 사용법
  • 🔍 뉴스레터 비교

댓글 쓰기

다음 이전