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 URLとして公開され、購読可能になる。

主な機能

• 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（高度）モード – 永続的なインスタンスを実行し、Web UIでRecipeの作成・管理、前後比較、プロンプト編集が可能。
• HTML/JSON/Search → RSSジェネレータ – 任意のWebページ、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でRecipeを定義し、希望する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補助ツールの領域に明確に位置づけられ、1つのDocker-Composeファイルでデプロイ可能。