# MuckScraper

> Self-hosted news aggregator grouping articles into stories, scoring bias via AllSides and local LLMs, generating AI summaries on your hardware via Docker Compose.

- **Category:** Feed Aggregator
- **Licence:** MIT
- **Latest version:** v1.0.2
- **Open source:** oss
- **Languages:** Python, HTML
- **Platforms:** Docker Compose
- **Tags:** RSS, News Aggregator, News, LLM, Ollama, Meilisearch, Docker, Open Source, Flask, Summarization, Pgvector, Self Hosted, Bias Detection, Political Bias, New Aggregator

## Description

MuckScraper is a self-hosted news aggregator that pulls articles from RSS feeds and news APIs, then uses local language models to group related coverage into unified stories. Each story displays the count of left, center, and right outlets that reported on it, with a button to fetch more from underrepresented sides. Opinion columns are kept separate from news coverage. The system publishes curated editions twice daily and keeps past editions. It runs via Docker Compose with PostgreSQL for embeddings, Meilisearch for search, and an optional MCP server for AI assistants. The web interface offers light and dark themes, role-based access, and optional public read-only mode. Setup is automated through install.sh which handles secrets, migrations, and admin creation.

## Links

- [Homepage](https://github.com/grregis/muckscraper)
- [GitHub Repository](https://github.com/grregis/muckscraper)
- [Documentation (README)](https://github.com/grregis/muckscraper/blob/main/README.md)
- [CHANGELOG](https://github.com/grregis/muckscraper/blob/main/CHANGELOG.md)
- [MCP Server Documentation](https://github.com/grregis/muckscraper/blob/main/docs/MCP.md)
- [Demo Instance](https://sample.muckscraper.news)
- [Newspaper Site](https://muckscraper.news)

---
Source: https://selfhost.directory/project/muckscraper