주요 기능 - macqueen0987/NotiPy GitHub Wiki

✨ Notipy 주요 기능

Notipy는 Notion과 Discord를 실시간으로 연결하는 협업 도구로, 다음과 같은 기능들을 제공합니다.

🧠 1. Notion 알림 연동

🔔 실시간 웹훅 알림

  • Notion에서 발생하는 페이지 생성 / 수정 / 삭제 이벤트를 자동 감지
  • Discord 채널에 알림 메시지 전송
  • 메시지 전송 방식:
    • 포럼 채널 → 새 스레드 생성
    • 일반 채널 → 기존 메시지 업데이트

🔄 연속성 유지

  • 각 Notion 페이지와 디스코드 스레드를 연결하여 추적 가능
  • 이벤트가 발생할 때마다 해당 스레드에 자동 업데이트

🗃️ 2. 데이터베이스 필터링 및 감지

  • 연결된 Notion DB의 속성을 자동 인식
  • 특정 조건(예: 상태 = "진행 중")에 따라 알림 전송
  • 변경된 페이지만 감지하여 중복 없이 갱신

🧩 3. Discord 명령어 UI

  • 슬래시 명령어(/) 기반 인터페이스
  • 주요 명령어: 
    /노션 노션토큰 설정
/노션 데이터베이스 연결
/프로젝트 생성
/깃허브 연결
  • 인터랙션 기반으로 사용자 친화적인 설정 흐름 제공

👥 4. 서버별 독립 운영

  • 서버 단위로 설정 및 프로젝트를 개별 관리
  • 봇이 여러 서버에 참여하더라도 데이터가 섞이지 않음

🔒 5. 보안 및 내부 요청 보호

  • FastAPI 백엔드가 내부 요청 여부를 X-Internal-Request 헤더로 검증
  • 외부 접근은 Nginx에서 자동 차단
  • 사용자 토큰은 서버에 저장되나 외부로 노출되지 않음

🧠 6. GitHub 프로필 요약

  • GitHub URL 입력 시 프로필 분석
  • LLM을 활용하여 활동/언어/기여도 요약
  • Discord에 공유 가능

🛠️ 7. 프로젝트 관리 기능

  • Discord 내에서 프로젝트 생성
  • 제목, 설명, 분류 등 메타데이터 설정 가능
  • UI 기반으로 손쉽게 확인 및 편집

📈 기타 특징

  • 로그 파일 별도 분리 (디버그/에러)
  • .env 기반 유연한 설정 가능
  • 다국어 지원 예정 (현재 한국어/영어 지원)

주의 사항

  • GitHub 프로필 요약, 프로젝트 관리 기능은 로컬에서 LLM을 실행하여 제공되는 정보들로 사용자의 정보를 외부에 공유하지 않습니다.
  • 해당 기능들은 사용시 서버 부하가 굉장히 큰 관계로 원활한 사용이 어려울 수 있습니다.

📖 자세한 사용법은 튜토리얼 문서를 참고하세요.