telepost

TelePost는 오픈소스 Telegram 채널 투고·심사·자동 게시 플랫폼입니다. 사용자는 Telegram 채팅이나 Mini App을 통해 투고할 수 있고, 관리자는 중앙에서 심사하고 콘텐츠를 관리할 수 있습니다. 외부 프로그램은 HTTP API를 통해 자동으로 게시물을 전달할 수 있습니다. 모든 진입점은 동일한 투고·심사·검색·게시·상태 관리 흐름을 공유합니다. 주요 기능은 다음과 같습니다: - 투고 및 게시: 이미지, 비디오, 오디오, 파일을 지원하며 미리보기, 편집, 태그, 익명, 스포일러 기능을 제공합니다. - 소스 신뢰도 기반 심사: 채팅 직접 발송은 기본적으로 즉시 게시(구성 가능한 심사)되며, API 자동 투고는 고정적으로 비공개 심사 그룹으로 들어가고, Mini App은 별도의 MINIAPP_REVIEW_REQUIRED로 제어됩니다. 심사자는 편집 후 게시할 수 있으며, 투고자의 원본은 변경되지 않습니다. - Mini App: 일반 사용자는 투고하고 자신의 투고를 확인할 수 있으며, 심사자는 큐와 세부 정보를 처리할 수 있습니다. - HTTP API: Bearer Token, 멱등 키, 파일 업로드, Telegram file_id를 지원하여 스크립트 및 자동화 서비스에 적합합니다. - 채널 관리: 채널 기록, 태그, 개인 투고, 로컬 인기 순위 검색을 지원하며 일반 관리 명령을 제공합니다. - 다중 Bot: 하나의 supervisor가 서로 격리된 여러 Bot을 실행할 수 있으며, 각각 독립적인 구성과 데이터 디렉터리를 사용합니다. - 실행 방식: Polling, Webhook, 자동 선택을 지원하며 특정 클라우드 플랫폼에 구속되지 않습니다. TelePost는 Telegram에만 의존하며, Bot과 대상 채널만 있으면 게시할 수 있습니다. Mini App, HTTP API, 배포 플랫폼, 다중 Bot은 모두 선택적 통합이며 각각 별도 문서가 있습니다. 프로젝트는 전체 설치 배포, 구성 참조, 명령 참조, HTTP API 문서, Mini App 문서, Webhook 및 Polling 모드, Fly.io 배포, 운영 매뉴얼, 문제 해결 가이드를 제공합니다. TelePost는 PixivFlow와 같은 도구와도 호환되어 HTTP API를 통해 자동 수집된 콘텐츠를 받고 수동 검토를 유지할 수 있습니다. 선택적 MCP 사이드카는 AI 에이전트가 대기 중인 콘텐츠를 읽고 제안할 수 있게 하지만, 최종 게시는 인간이 명시적으로 확인합니다. 프로젝트는 MIT 라이선스를 사용하며 python-telegram-bot, aiohttp, aiosqlite, Whoosh, jieba, Pillow 등의 오픈소스 프로젝트를 기반으로 구축되었습니다.