Skip to content
Back to search

NewsBlur

NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/samuelclay/NewsBlur with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/samuelclay/NewsBlur'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/samuelclay--newsblur/badge.svg)](/listings/samuelclay--newsblur)

HTML

<a href="/listings/samuelclay--newsblur"><img src="/api/listings/samuelclay--newsblur/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This repository contains everything you need to run your own NewsBlur instance with complete control over your data.

**Prerequisites**: Docker and Docker Compose

git clone https://github.com/samuelclay/NewsBlur.git
cd NewsBlur
make

Visit `https://localhost` (type `thisisunsafe` to bypass the self-signed certificate warning).

**Common commands:** - `make` - Start/update and apply migrations (run after `git pull`) - `make log` - View web and node logs - `make logall` - View all container logs - `make shell` - Django shell with auto-imported models - `make bash` - Bash shell in web container - `make test` - Run tests - `make lint` - Format code (isort, black, flake8) - `make down` - Stop containers

**Bootstrap discover feeds (without fetching):**

docker exec -t newsblur_web python manage.py bootstrap_popular_feeds --skip-fetch

This creates `PopularFeed` records from the curated fixtures file without fetching any feed content. You can filter by type with `--type youtube`, `--type reddit`, `--type podcast`, `--type newsletter`, or `--type rss`.

**Database access:** - `make mongo` - MongoDB shell - `make redis` - Redis CLI - `make postgres` - PostgreSQL shell

See `AGENTS.md` for detailed development guidelines.

Configuration

To customize your NewsBlur installation, create `newsblur_web/local_settings.py` to override settings from [`docker_local_settings.py`](newsblur_web/docker_local_settings.py).

**Settings for self-hosted installations:**

- `NEWSBLUR_URL` - Your domain (default: `https://localhost`). Also used for Archive browser extension OAuth. - `SESSION_COOKIE_DOMAIN` - Cookie domain for authentication - `AUTO_PREMIUM` - Give new users premium features (default: `True`) - `AUTO_ENABLE_NEW_USERS` - Auto-activate new accounts (default: `True`) - `ENFORCE_SIGNUP_CAPTCHA` - Require captcha on signup (default: `False`) - `OPENAI_API_KEY` - AI features and Discover for related stories - `DAYS_OF_UNREAD` - Story retention for premium users in days (default: `30`) - `DAYS_OF_UNREAD_FREE` - Story retention for free users in days (default: `14`) - `HOMEPAGE_USERNAME` - Username shown on homepage to unauthenticated users (default: `"popular"`)

**Uncommon settings (for running full newsblur.com):**

- `EMAIL_BACKEND` - Email delivery method - `STRIPE_SECRET` / `STRIPE_PUBLISHABLE` - Stripe payment processing - `PAYPAL_API_CLIENTID` / `PAYPAL_API_SECRET` - PayPal payment processing - `S3_*` settings - AWS S3 bucket configuration for backups, icons, avatars - `FACEBOOK_APP_ID` / `TWITTER_CONSUMER_KEY` / `YOUTUBE_API_KEY` - Social API keys

See the full list in [`docker_local_settings.py`](https://github.com/samuelclay/NewsBlur/blob/master/newsblur_web/docker_local_settings.py) and [`settings.py`](https://github.com/samuelclay/NewsBlur/blob/master/newsblur_web/settings.py).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 259 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # NewsBlur
  2. <div align="center">
  3. **A personal news reader bringing people together to talk about the world.**
  4. *A new sound of an old instrument.*
  5. [www.newsblur.com](https://www.newsblur.com)
  6. <img src="media/img/welcome/welcome-mac.png" width="100%" alt="NewsBlur Web" />
  7. <img src="media/img/welcome/welcome-ios.png" width="60%" alt="NewsBlur iOS" /> <img src="media/img/welcome/welcome-android.png" width="35%" alt="NewsBlur Android" />
  8. <a href="https://f-droid.org/repository/browse/?fdid=com.newsblur" target="_blank">
  9. <img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="60"/></a>
  10. <a href="https://play.google.com/store/apps/details?id=com.newsblur" target="_blank">
  11. <img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" alt="Get it on Google Play" height="60"/></a>
  12. <br/>
  13. <a href="https://apps.apple.com/us/app/newsblur/id463981119">
  14. <img src="https://tools.applemediaservices.com/api/badges/download-on-the-app-store/black/en-us?size=250x83" alt="Download on the Apple App Store" height="60"></a>
  15. </div>
  16. ## About
  17. NewsBlur is a personal news reader with intelligence. It's an RSS feed reader and social news network that shows the original site while giving you powerful filtering tools. Train NewsBlur to learn what you like and dislike, and it will automatically highlight and hide stories.
  18. NewsBlur is free to use at [newsblur.com](https://www.newsblur.com) (up to 64 sites) with premium plans available, or you can self-host your own instance using this repository.
  19. ## Features
  20. - **Real-time RSS** - Stories are pushed directly to you, so you can read news as it comes in
  21. - **Original Site View** - Read the content in context, the way it was meant to be seen
  22. - **Training** - Hide the stories you don't like and highlight the stories you do
  23. - **Shared Stories** - Reading news is better with friends. Share stories on your public blurblog
  24. - **Full Text Search** - Quickly find stories across all of your subscriptions
  25. - **Story Tagging** - Save stories with custom tags for fast references
  26. - **Blurblog Privacy** - Share stories with the world or only with your friends
  27. - **Saved Searches** - Regularly used searches are conveniently given their own feeds
  28. - **Read the Full Story** - The original story from truncated RSS feeds is seamlessly expanded
  29. - **Track Changes** - See how a story evolved since it was first published
  30. - **Email Newsletters** - Read your email newsletters where they belong, in a news reader
  31. - **Multiple Layouts** - Grid, List, Split, or Magazine view for each site
  32. - **Dark Mode** - Easy on the eyes and built into the web, iOS, and Android
  33. - **YouTube Channels** - Even sites that don't publish RSS feeds can be followed
  34. - **Third-party Apps** - Supports Reeder, ReadKit, Unread, and many more
  35. - **IFTTT Integration** - Hook NewsBlur up to nearly every service on the web
  36. - **MCP Server** - Connect AI agents to your feeds, stories, and classifiers
  37. - **Native Mobile Apps** - Free iOS, macOS, and Android apps jam-packed with features
  38. ## Technology
  39. NewsBlur is a Django application (Python 3.7+) with a Backbone.js frontend. It uses:
  40. - PostgreSQL for relational data (feeds, subscriptions, accounts)
  41. - MongoDB for stories and read states
  42. - Redis for story assembly and caching
  43. - Elasticsearch for search (optional)
  44. - Celery for background tasks (feed fetching)
  45. - Node.js services for text extraction and image processing
  46. ## Self-Hosted Installation
  47. This repository contains everything you need to run your own NewsBlur instance with complete control over your data.
  48. **Prerequisites**: Docker and Docker Compose
  49. ```bash
  50. git clone https://github.com/samuelclay/NewsBlur.git
  51. cd NewsBlur
  52. make
  53. ```
  54. Visit `https://localhost` (type `thisisunsafe` to bypass the self-signed certificate warning).
  55. **Common commands:**
  56. - `make` - Start/update and apply migrations (run after `git pull`)
  57. - `make log` - View web and node logs
  58. - `make logall` - View all container logs
  59. - `make shell` - Django shell with auto-imported models
  60. - `make bash` - Bash shell in web container
  61. - `make test` - Run tests
  62. - `make lint` - Format code (isort, black, flake8)
  63. - `make down` - Stop containers
  64. **Bootstrap discover feeds (without fetching):**
  65. ```bash
  66. docker exec -t newsblur_web python manage.py bootstrap_popular_feeds --skip-fetch
  67. ```
  68. This creates `PopularFeed` records from the curated fixtures file without fetching any feed content. You can filter by type with `--type youtube`, `--type reddit`, `--type podcast`, `--type newsletter`, or `--type rss`.
  69. **Database access:**
  70. - `make mongo` - MongoDB shell
  71. - `make redis` - Redis CLI
  72. - `make postgres` - PostgreSQL shell
  73. See `AGENTS.md` for detailed development guidelines.
  74. ### Configuration
  75. To customize your NewsBlur installation, create `newsblur_web/local_settings.py` to override settings from [`docker_local_settings.py`](newsblur_web/docker_local_settings.py).
  76. **Settings for self-hosted installations:**
  77. - `NEWSBLUR_URL` - Your domain (default: `https://localhost`). Also used for Archive browser extension OAuth.
  78. - `SESSION_COOKIE_DOMAIN` - Cookie domain for authentication
  79. - `AUTO_PREMIUM` - Give new users premium features (default: `True`)
  80. - `AUTO_ENABLE_NEW_USERS` - Auto-activate new accounts (default: `True`)
  81. - `ENFORCE_SIGNUP_CAPTCHA` - Require captcha on signup (default: `False`)
  82. - `OPENAI_API_KEY` - AI features and Discover for related stories
  83. - `DAYS_OF_UNREAD` - Story retention for premium users in days (default: `30`)
  84. - `DAYS_OF_UNREAD_FREE` - Story retention for free users in days (default: `14`)
  85. - `HOMEPAGE_USERNAME` - Username shown on homepage to unauthenticated users (default: `"popular"`)
  86. **Uncommon settings (for running full newsblur.com):**
  87. - `EMAIL_BACKEND` - Email delivery method
  88. - `STRIPE_SECRET` / `STRIPE_PUBLISHABLE` - Stripe payment processing
  89. - `PAYPAL_API_CLIENTID` / `PAYPAL_API_SECRET` - PayPal payment processing
  90. - `S3_*` settings - AWS S3 bucket configuration for backups, icons, avatars
  91. - `FACEBOOK_APP_ID` / `TWITTER_CONSUMER_KEY` / `YOUTUBE_API_KEY` - Social API keys
  92. See the full list in [`docker_local_settings.py`](https://github.com/samuelclay/NewsBlur/blob/master/newsblur_web/docker_local_settings.py) and [`settings.py`](https://github.com/samuelclay/NewsBlur/blob/master/newsblur_web/settings.py).
  93. ## Development with Worktrees
  94. NewsBlur supports Git worktrees for working on multiple features simultaneously, with each worktree running on its own set of ports. This is ideal when working with AI coding assistants like Claude Code.
  95. **Create and start a worktree:**
  96. ```bash
  97. git worktree add .worktree/feature-name
  98. cd .worktree/feature-name
  99. make worktree
  100. ```
  101. Each worktree automatically gets unique ports based on its directory name:
  102. - Main repo: `https://localhost` (ports 80/443)
  103. - Worktree: `https://localhost:XXXX` (unique ports)
  104. **View your worktree's URLs:**
  105. ```bash
  106. make worktree
  107. ```
  108. **Follow the worktree logs:**
  109. ```bash
  110. make worktree-log
  111. ```
  112. **Close a worktree:**
  113. ```bash
  114. make worktree-close # Stops containers and removes worktree if no uncommitted changes
  115. ```
  116. All worktrees share the same database services (PostgreSQL, MongoDB, Redis, Elasticsearch), so you can test multiple features without duplicating data.
  117. ## MCP Server & CLI
  118. NewsBlur includes an [MCP server](https://modelcontextprotocol.io) that lets AI agents (Claude Desktop, Claude Code, Cursor, or any MCP-compatible client) interact with your feeds, stories, and classifiers. Premium subscription required.
  119. ### Connect
  120. **Claude Code:**
  121. ```bash
  122. claude mcp add --transport http newsblur https://newsblur.com/mcp/
  123. ```
  124. **Codex:** Add to `~/.codex/config.toml`:
  125. ```toml
  126. [mcp_servers.newsblur]
  127. url = "https://newsblur.com/mcp"
  128. ```
  129. On first use, a browser window opens for you to log in to NewsBlur and authorize access.
  130. ### What you can do
  131. **Read your feeds** - Get unread stories from any feed or folder, search across all subscriptions, retrieve saved stories by tag.
  132. **Take action** - Mark stories as read, save stories with tags and notes, subscribe to new feeds, share stories to your blurblog.
  133. **Train intelligence** - View and update classifiers to like/dislike authors, tags, titles, and feeds. Let an AI agent analyze your reading patterns and suggest training rules.
  134. **Discover** - Find new feeds by topic, see trending feeds, find feeds similar to ones you already follow.
  135. ### Available tools
  136. | Tool | Description |
  137. |------|-------------|
  138. | `newsblur_list_feeds` | All subscribed feeds with folders and unread counts |
  139. | `newsblur_get_stories` | Load stories from feeds, folders, or all subscriptions |
  140. | `newsblur_get_saved_stories` | Saved stories filtered by tag |
  141. | `newsblur_search_stories` | Full-text search across feeds |
  142. | `newsblur_get_original_text` | Fetch full article from source website |
  143. | `newsblur_get_feed_info` | Detailed feed metadata and statistics |
  144. | `newsblur_get_account_info` | User profile and subscription tier |
  145. | `newsblur_mark_stories_read` | Mark stories read by hash, feed, or folder |
  146. | `newsblur_save_story` | Save a story with tags, notes, and highlights |
  147. | `newsblur_unsave_story` | Remove from saved stories |
  148. | `newsblur_subscribe` | Subscribe to a feed by URL |
  149. | `newsblur_unsubscribe` | Remove a feed subscription |
  150. | `newsblur_organize_feed` | Move feeds between folders, rename feeds/folders |
  151. | `newsblur_share_story` | Share to your blurblog with comments |
  152. | `newsblur_train_classifier` | Train like/dislike on title, author, tag, or feed |
  153. | `newsblur_get_classifiers` | View all trained intelligence classifiers |
  154. | `newsblur_discover_feeds` | Search, similar, or trending feed discovery |
  155. | `newsblur_manage_notifications` | View/configure per-feed notifications |
  156. ### Prompt templates
  157. The MCP server includes prompt templates for common workflows:
  158. - **Daily Briefing** - Summarize today's unread stories by folder
  159. - **Triage Inbox** - Review and categorize unread stories, save interesting ones
  160. - **Research Topic** - Search feeds and saved stories on a topic
  161. - **Train from Reading** - Analyze reading patterns and suggest classifier rules
  162. - **Feed Health Check** - Audit subscriptions for dead or unused feeds
  163. - **Discover New Feeds** - Find feeds based on interests
  164. ### Self-hosted MCP server
  165. If you self-host NewsBlur, the MCP server runs as a separate container on port 8099:
  166. ```bash
  167. docker compose up newsblur_mcp
  168. ```
  169. Point your MCP client to `https://your-newsblur-domain/mcp/`.
  170. ## Contributing
  171. NewsBlur welcomes contributions! The development workflow:
  172. - Web and Node servers restart automatically when code changes
  173. - Run `make` after `git pull` to apply migrations
  174. - See `AGENTS.md` for code style and development conventions
  175. ## Support
  176. - **Hosted service**: [newsblur.com](https://www.newsblur.com) (recommended)
  177. - **Questions, suggestions, and bugs**: [forum.newsblur.com](https://forum.newsblur.com)
  178. - **Development questions**: Check `AGENTS.md` first
  179. ## Author
  180. Created by [Samuel Clay](https://www.samuelclay.com) • <samuel@newsblur.com> • [@samuelclay](https://x.com/samuelclay)
  181. ## License
  182. MIT License - see [LICENSE](LICENSE) file for details

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.