RitualFlow가 Notion을 설정 + 실행 + 저장소로 활용해 Claude 기반 AI 콘텐츠 생성을 완전 자동화하는 CLI 도구 개발

Context

Notion 사용자들이 매일 퀴즈, 뉴스레터, 학습 자료 등을 수동으로 작성하거나 외부 도구를 통해 산재된 워크플로우로 관리해야 했다. Notion 내에서 습관 기반의 자동화된 콘텐츠 생성과 추적 체계가 필요했다.

Technical Solution

• Notion 데이터베이스를 단일 설정 소스로 활용: 사용자가 Notion에서 습관 정의(이름, 빈도, AI 프롬프트, 카테고리)를 작성하면 RitualFlow CLI가 자동으로 읽음
• Python Click 기반 6개 명령어 CLI 구현: setup(Notion 초기화) → add(습관 추가) → run(콘텐츠 생성) → status(상태 확인) → delete(습habit 삭제) → history(히스토리 조회)
• Anthropic API 우선 + Claude Code CLI 폴백 구조: API 가용성에 따라 자동으로 대체 방식 선택
• Markdown-to-Notion 블록 변환 엔진: 생성된 콘텐츠를 헤딩, 불릿, 토글(quiz 답안용), 인용, 코드블록으로 자동 포맷팅
• 기간별 중복 제거 로직: daily(날짜 기준), weekly(주차 번호), monthly(월 기준) 키로 동일 콘텐츠 재생성 방지
• 실시간 대시보드 동기화: 각 run 후 Notion 메인 페이지의 stats callout 블록에 주간/전체 생성 횟수 자동 업데이트
• 웹 검색 통합: Claude가 최신 기술 뉴스, 실제 장소 정보 등 현재 데이터를 기반으로 콘텐츠 생성

Key Takeaway

Notion을 단순 데이터 저장소가 아닌 애플리케이션 인터페이스 전체(설정 입력 → 콘텐츠 생성 → 진행률 추적)로 설계하면 사용자가 외부 대시보드나 설정 파일 없이 Notion 워크플로우 내에서 완전히 작업할 수 있다. 이는 기존 Notion 사용자에게 별도 학습곡선 없이 도구를 즉시 채택하게 한다.