Metadata-Version: 2.4
Name: rss-ai-middleware
Version: 0.2.0
Summary: AI-powered RSS reader middleware — MCP server connecting Miniflux/FreshRSS to Ollama for smart feed processing
Project-URL: Homepage, https://github.com/ziuus/rss-ai-middleware
Project-URL: Repository, https://github.com/ziuus/rss-ai-middleware
Project-URL: Issues, https://github.com/ziuus/rss-ai-middleware/issues
Project-URL: Documentation, https://github.com/ziuus/rss-ai-middleware#readme
Author-email: Noel <noel@ziuus.dev>
License: MIT
Keywords: ai,freshrss,mcp,miniflux,ollama,rss,summarization
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: fastmcp>=0.4.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 📡 RSS AI Middleware

**Transform your RSS feeds into actionable intelligence.**

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![MCP](https://img.shields.io/badge/Protocol-MCP-orange.svg)](https://modelcontextprotocol.io)
[![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://www.docker.com/)
[![PyPI](https://img.shields.io/badge/PyPI-v0.2.0-green.svg)](https://pypi.org)

RSS AI Middleware empowers information-overloaded researchers and power users to eliminate manual feed-scrolling by transforming their curated RSS readers into an interactive AI intelligence agent for instant search, summarization, and organization.

---

## 😫 The Friction vs. ⚡ The Flow

| The Old Way (Manual) | The AI Way (Middleware) |
| :--- | :--- |
| ⏳ Hours spent scrolling through 100+ articles | 🚀 Seconds to find the exact update you need |
| 🤯 Information overload and "tab fatigue" | 🎯 Precise, AI-generated summaries of key points |
| 🔍 Manual keyword searching across multiple feeds | 🤖 Natural language queries across your entire library |
| 📁 Tedious manual tagging and starring | 🪄 Auto-organization based on intent and priority |

---

## 🎯 Designed For

- **Researchers**: Who need to track niche academic or industry trends without reading every single post.
- **Developers**: Who follow 50+ tech blogs and need to know *exactly* when a specific library updates.
- **News Junkies**: Who want a "Daily Briefing" generated from their own curated sources, not an algorithm.
- **AI Agents**: Who need a real-time "eye" on the web to feed current data into their workflows.

---

## 🛠 The Intelligence Suite

### 🔍 Deep Discovery
- **Semantic Search**: Find entries based on meaning, not just keywords.
- **Cross-Feed Analysis**: Query across Miniflux and FreshRSS simultaneously.
- **Instant Retrieval**: Get the full content of any entry without leaving your AI chat.

### ✍️ Synthesis & Insight
- **Token-by-Token Summaries**: Get real-time, streaming summaries via Ollama.
- **Multi-Language Translation**: Convert global news into your native language instantly.
- **Key Takeaway Extraction**: Turn long-form articles into bulleted action items.

### 🗂 Smart Management
- **Intent-Based Starring**: "Star all articles related to Wayland stability."
- **Bulk Status Updates**: Mark entire categories as read based on AI filtering.
- **Category Intelligence**: List and organize feeds by topic automatically.

---

## 💎 The Unfair Advantage (USP)

Unlike generic AI news apps, **RSS AI Middleware** puts you in total control:

- **BYOK (Bring Your Own Key)**: Use OpenAI, Anthropic, or Google Gemini.
- **Local-First Privacy**: Full support for **Ollama**. Your news and your keys never leave your machine.
- **MCP Standard**: Plug-and-play compatibility with Claude Desktop, Cursor, and OpenCode.
- **Reader Agnostic**: Works seamlessly with both **Miniflux** and **FreshRSS**.

---

## ⚙️ How it Works

`Your RSS Reader` $\rightarrow$ `RSS AI Middleware (MCP)` $\rightarrow$ `LLM (Ollama/OpenAI)` $\rightarrow$ `Your AI Agent`

1. **Connect**: Link your Miniflux/FreshRSS instance via `.env`.
2. **Bridge**: The middleware exposes your feeds as "Tools" to the LLM.
3. **Interact**: Ask your AI: *"What are the top 3 updates on AI agents from my feeds today?"*
4. **Execute**: The AI searches, reads, summarizes, and returns the answer.

---

## 🚀 Quick Start

### 1. Clone & Install
\`\`\`bash
git clone https://github.com/ziuus/rss-ai-middleware.git
cd rss-ai-middleware
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
\`\`\`

### 2. Configure
Update your `.env` with your RSS credentials and Ollama URL.

### 3. Run
\`\`\`bash
python -m src.server
\`\`\`

---

## 🌟 Community & Trust

> "Finally, a way to actually *use* my RSS feeds instead of just hoarding them. The Ollama integration is a game changer for privacy."
> — **Early Beta User**

> "The MCP implementation is flawless. I have my news feed integrated directly into my coding agent, and it's a productivity superpower."
> — **Open Source Contributor**

**Trusted by developers and researchers who value their time and their privacy.**

---

## 📄 License
MIT © [ziuus](https://github.com/ziuus)
