Metadata-Version: 2.4
Name: newsblur-cli
Version: 0.1.0
Summary: NewsBlur CLI and MCP server - manage feeds, stories, and classifiers
Project-URL: Homepage, https://newsblur.com/features/mcp-cli
Project-URL: Repository, https://github.com/samuelclay/NewsBlur
Project-URL: Issues, https://github.com/samuelclay/NewsBlur/issues
License-Expression: MIT
Keywords: cli,feeds,mcp,news,newsblur,rss
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.15.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.22; extra == 'dev'
Description-Content-Type: text/markdown

# NewsBlur CLI

A command-line interface for [NewsBlur](https://newsblur.com), the visual intelligence RSS reader. Read feeds, manage stories, train classifiers, and more from your terminal.

## Install

```bash
pip install newsblur-cli
```

## Quick Start

```bash
# Log in (opens your browser for OAuth)
newsblur auth login

# Get your daily briefing
newsblur briefing

# List your feeds
newsblur feeds list

# Read stories from a feed
newsblur stories river --feed 42

# Search stories
newsblur stories search "machine learning"

# Save a story
newsblur save <story-hash>

# Mark stories as read
newsblur read <story-hash>
```

## Commands

| Command | Description |
|---------|-------------|
| `newsblur auth login` | Log in via OAuth |
| `newsblur auth logout` | Log out and remove credentials |
| `newsblur auth status` | Show authentication status |
| `newsblur briefing` | Daily briefing of top stories |
| `newsblur stories river` | Read stories from feeds or folders |
| `newsblur stories search` | Search across stories |
| `newsblur feeds list` | List subscribed feeds |
| `newsblur feeds add` | Subscribe to a new feed |
| `newsblur feeds remove` | Unsubscribe from a feed |
| `newsblur train show` | View intelligence classifiers |
| `newsblur train set` | Train a classifier |
| `newsblur discover` | Find new feeds by topic |
| `newsblur account` | Show account info |
| `newsblur save` | Save a story |
| `newsblur read` | Mark a story as read |

## Self-Hosted

For self-hosted NewsBlur instances, pass `--server`:

```bash
newsblur auth login --server https://nb.example.com
```

The server URL is persisted to `~/.config/newsblur/config.json`.

## Output Formats

```bash
# Rich terminal output (default)
newsblur feeds list

# JSON output (for scripting)
newsblur --json feeds list

# Raw text output
newsblur --raw feeds list
```

## MCP Server

This package also includes an MCP (Model Context Protocol) server for AI assistants. See [NewsBlur MCP](https://newsblur.com/features/mcp-cli) for details.

## Requirements

- Python 3.11+
- A NewsBlur account (premium required for most features)

## Links

- [NewsBlur](https://newsblur.com)
- [GitHub](https://github.com/samuelclay/NewsBlur)
- [MCP & CLI Features](https://newsblur.com/features/mcp-cli)
