Colin-XKL/FeedCraft

FeedCraft – AI 강화 RSS 처리

무엇인가요

• 어떤 RSS/Atom 소스와 리더 사이에 위치하는 오픈소스 Go 서비스입니다. 가져오기, 변환, 재게시를 AI 기반 단계로 선택적으로 수행할 수 있습니다.

핵심 개념

개념	의미
AtomCraft	단일 처리 단계 (예: fulltext, translate-title, introduction).
FlowCraft	연결된 AtomCraft들의 파이프라인 (예: fulltext → introduction → translate-title).
Recipe	특정 입력 RSS URL에 FlowCraft를 연결한 이름이 지정된 구성. 사용자가 구독할 수 있는 새로운 RSS 엔드포인트로 노출됩니다.

주요 기능

• AI 기반 변환 – 어떤 OpenAI 호환 LLM (OpenAI, Ollama, Gemini 등)을 연결하고, 다음과 같은 커스텀 프롬프트를 작성 가능:
  • 기사 요약 (introduction, summary)
  • 제목 또는 전체 콘텐츠 번역 (translate-title, translate-content, translate-content-immersive)
  • 텍스트 정리/미화 (beautify-content, ignore-advertorial)
• 풀텍스트 추출 – JavaScript에 의존하는 사이트를 위해 일반 (fulltext) 또는 브라우저 렌더링 (fulltext-plus) 방식 지원.
• 포터블 모드 – 어떤 RSS URL에 짧은 접두사를 붙이면 전용 배포 없이 즉시 처리 가능.
• Dock (고급) 모드 – 지속적인 인스턴스를 실행하고 웹 UI에서 레시피 생성 및 관리, 전후 비교, 프롬프트 편집이 가능.
• HTML/JSON/Search → RSS 생성기 – 임의의 웹 페이지, JSON API 응답(원시 curl 명령어 포함), 검색 결과를 적절한 RSS 피드로 변환 가능.
• 내장 UI – AtomCraft용 시각적 에디터, 레시피 매니저, 피드 비교 도구 제공.

일반 워크플로우

1. FeedCraft 배포 (Docker-compose가 추천 방법).
2. 환경 변수 설정:
   • 브라우저 렌더링 서비스 (FC_BROWSER_PROVIDER + 엔드포인트) – fulltext-plus에 필요.
   • Redis (캐시, 큐).
   • LLM 엔드포인트, 키, 모델, 유형 (FC_LLM_API_*).
3. UI 또는 HTTP API를 통해 레시피 정의, 원하는 AtomCraft 또는 사용자 정의 FlowCraft 선택.
4. 생성된 RSS URL에 구독, 예:

   https://feed-craft.example.com/craft/translate-title?input_url=https://feeds.feedburner.com/visualcapitalist
   

   서비스는 원본 피드를 가져와 설정된 LLM으로 각 제목을 번역하고 새로운 RSS 스트림을 반환합니다.

배포

• Docker 이미지: ghcr.io/colin-xkl/feed-craft (Docker Hub에서도 이용 가능).
• 최소 docker-compose.yml로 앱, Redis 컨테이너, 헤드리스 렌더링용 browserless-chrome 컨테이너를 시작.
• 기본 관리자 자격은 admin / adminadmin – 즉시 변경할 것.
• 환경 변수로 포터블 (단일 요청) 및 Dock (지속 UI) 모드 전환 가능.

AI 통합 세부사항

• 서비스는 모델을 포함하지 않음. OpenAI /v1/chat/completions 계약을 따르는 어떤 엔드포인트에도 프롬프트를 전달함.
• 기본 대상 언어 (FC_DEFAULT_TARGET_LANG)를 설정하면 번역 Craft가 자동으로 출력 언어를 인식 가능.
• UI에서 프롬프트 커스터마이징 가능. LLM의 요약 또는 번역 방식을 세밀하게 조정 가능.

누가 사용할까

• 광고 없는 깔끔한 풀텍스트 기사를 원하는 RSS 마니아.
• 외국어 피드의 실시간 번역이 필요한 다국어 리더.
• 대규모 피드를 빠르게 스크래핑하기 위해 AI 생성 요약을 원하는 콘텐츠 큐레이터.
• 풍부한 RSS를 소비하는 하류 서비스(예: 뉴스레터, 챗봇 피드)를 개발하는 개발자.

라이선스

• GPL-v3. 파생작품도 동일한 라이선스를 유지하면서 실행, 수정, 재배포 가능.

---

결론: FeedCraft는 자체 호스팅 가능한 Go 기반 미들웨어로, 일반 RSS 피드를 AI 강화, 풀텍스트, 번역, 요약된 스트림으로 변환 가능하며, 시각적 UI로 사용자 정의 처리 파이프라인을 구축할 수 있습니다. AI 보조 도구 분야에 명확히 위치하며, 단일 Docker-Compose 파일로 배포 가능합니다.