newsblur-cli 0.1.0__tar.gz

newsblur_cli-0.1.0/.gitignore

@@ -0,0 +1,95 @@
+logs/*.log
+logs/*.log.*
+logs/*.pid
+logs/celerybeat-schedule.db
+logs/celerybeat-schedule-*.db
+*.pyc
+backup.db
+__pycache__/
+static/*
+local_settings.py
+celerybeat-schedule
+celerybeat.pid
+media/iphone/NewsBlur/build
+media/iphone/build
+build/
+certbot.conf
+.DS_Store
+**/*.perspectivev*
+.vscode/*
+.env
+task_env.py
+app_env.py
+data/
+api/ip_addresses.txt
+.prom_cache
+config/certificates
+**/*.xcuserstate
+UserInterfaceState.xcuserstate
+UserInterfaceState\.xcuserstate
+*.xcuserstate
+xcuserdata
+.xcodeproj/ push.xcodeproj/project.pbxproj
+clients/ios/NewsBlur.xcodeproj/project.xcworkspace/xcshareddata/
+*.mode1v3
+*.pbxuser
+media/maintenance.html
+media/maintenance.html.unused
+config/settings
+static.tgz
+.sass-cache
+media/css/circular/.sass-cache
+media/css/circular/sass/.sass-cache
+media/css/circular
+config/settings
+config/secrets
+ansible/roles/sentry/vars/secrets.yml
+templates/maintenance_on.html
+apps/social/spam.py
+venv*
+/backup
+/backups
+config/mongodb_keyfile.key
+
+# Docker Jinja templates
+docker/haproxy/haproxy.consul.cfg
+# docker/haproxy/haproxy.staging.cfg # Staging doesn't use jinja templates, so no need to ignore
+# Conductor workspace files (auto-generated by .conductor/conductor-setup.sh)
+.conductor/docker-compose.*.yml
+.conductor/haproxy/
+# Ignore all subdirs in .conductor
+.conductor/**/*
+
+# Worktree development files (auto-generated by worktree-dev.sh)
+.worktree/
+docker/nginx/nginx.consul.conf
+docker/prometheus/prometheus.yml
+docker/redis/redis_replica.conf
+docker/redis/redis_*_replica.conf
+docker/postgres/postgres.conf
+
+# Local configuration file (sdk path, etc)
+/originals
+/node/originals
+media/safari/NewsBlur.safariextz
+
+# Discovery cache files (generated by discover_* management commands)
+apps/discover/fixtures/*_cache.json
+
+# IDE files
+/docker/volumes/*
+
+**/node_modules
+*.tfstate*
+.terraform*
+grafana.ini
+apps/api/ip_addresses.txt
+.ansible/
+.dev_session
+.conductor
+.worktree
+docs
+plans
+
+# PyPI build artifacts
+newsblur_mcp/dist/

newsblur_cli-0.1.0/Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.12-slim
+
+WORKDIR /srv/newsblur_mcp
+
+RUN pip install --no-cache-dir uv
+
+COPY pyproject.toml .
+COPY newsblur_mcp/ newsblur_mcp/
+RUN uv pip install --system --no-cache .
+
+EXPOSE 8099
+
+CMD ["python", "-m", "newsblur_mcp"]

newsblur_cli-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+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)

newsblur_cli-0.1.0/README.md

@@ -0,0 +1,92 @@
+# 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)

newsblur_cli-0.1.0/newsblur_mcp/__main__.py

@@ -0,0 +1,10 @@
+"""Entry point for `python -m newsblur_mcp`.
+
+Imports from the canonical module to avoid the double-import problem
+that occurs when `python -m` loads the module as __main__ while tool
+sub-modules import from newsblur_mcp.server.
+"""
+
+from newsblur_mcp.server import main
+
+main()

newsblur_cli-0.1.0/newsblur_mcp/auth.py

@@ -0,0 +1,106 @@
+"""NewsBlur OAuth provider for FastMCP.
+
+Proxies authentication through Django's existing OAuth2 infrastructure
+so that MCP clients (Claude Code, Codex, etc.) can authenticate via
+standard OAuth flows without any manual token setup.
+"""
+
+from __future__ import annotations
+
+import logging
+import time
+
+import httpx
+from fastmcp.server.auth import TokenVerifier
+from fastmcp.server.auth.auth import AccessToken
+from fastmcp.server.auth.oauth_proxy import OAuthProxy
+from pydantic import AnyHttpUrl
+
+logger = logging.getLogger(__name__)
+
+from newsblur_mcp.settings import (
+    MCP_OAUTH_BASE_URL,
+    MCP_OAUTH_CLIENT_ID,
+    MCP_OAUTH_CLIENT_SECRET,
+    MCP_OAUTH_INTERNAL_URL,
+    MCP_OAUTH_UPSTREAM_URL,
+)
+from newsblur_mcp.ui import patch_fastmcp_ui
+
+# Replace FastMCP's generic OAuth pages with NewsBlur-branded ones
+patch_fastmcp_ui()
+
+
+class NewsBlurTokenVerifier(TokenVerifier):
+    """Validates upstream Django OAuth tokens by calling NewsBlur's API."""
+
+    def __init__(self, upstream_base_url: str, timeout_seconds: int = 10):
+        super().__init__(required_scopes=None)
+        self.upstream_base_url = upstream_base_url
+        self.timeout_seconds = timeout_seconds
+
+    async def verify_token(self, token: str) -> AccessToken | None:
+        """Verify a Django OAuth access token by calling the user info endpoint."""
+        try:
+            async with httpx.AsyncClient(timeout=self.timeout_seconds) as client:
+                response = await client.get(
+                    f"{self.upstream_base_url}/oauth/user/info/",
+                    headers={"Authorization": f"Bearer {token}"},
+                )
+
+                if response.status_code != 200:
+                    logger.warning("Django token verification failed: status=%d url=%s", response.status_code, self.upstream_base_url)
+                    return None
+
+                user_info = response.json()
+                logger.info("Token verified for user=%s", user_info.get("user_name", "unknown"))
+
+                return AccessToken(
+                    token=token,
+                    client_id=MCP_OAUTH_CLIENT_ID,
+                    scopes=["read", "write", "mcp"],
+                    expires_at=int(time.time()) + (60 * 60 * 24 * 365 * 10),
+                    claims={
+                        "sub": str(user_info.get("user_id", "")),
+                        "username": user_info.get("user_name", ""),
+                    },
+                )
+        except Exception as e:
+            logger.error("Django token verification error: %s", e)
+            return None
+
+
+class NewsBlurOAuthProvider(OAuthProxy):
+    """OAuth provider that proxies to Django's OAuth2 infrastructure."""
+
+    def __init__(
+        self,
+        *,
+        base_url: AnyHttpUrl | str | None = None,
+        upstream_url: str | None = None,
+        internal_url: str | None = None,
+        client_id: str | None = None,
+        client_secret: str | None = None,
+    ):
+        base_url = base_url or MCP_OAUTH_BASE_URL
+        upstream_url = upstream_url or MCP_OAUTH_UPSTREAM_URL
+        internal_url = internal_url or MCP_OAUTH_INTERNAL_URL
+        client_id = client_id or MCP_OAUTH_CLIENT_ID
+        client_secret = client_secret or MCP_OAUTH_CLIENT_SECRET
+
+        token_verifier = NewsBlurTokenVerifier(upstream_base_url=internal_url)
+
+        super().__init__(
+            # Browser redirect — user sees this URL
+            upstream_authorization_endpoint=f"{upstream_url}/oauth/authorize/",
+            # Server-to-server — bypasses TLS for self-signed certs in dev
+            upstream_token_endpoint=f"{internal_url}/oauth/token/",
+            upstream_client_id=client_id,
+            upstream_client_secret=client_secret,
+            token_verifier=token_verifier,
+            base_url=base_url,
+            issuer_url=base_url,
+            require_authorization_consent=False,
+            forward_pkce=False,
+            valid_scopes=["read", "write", "mcp"],
+        )

newsblur_cli-0.1.0/newsblur_mcp/cli/__init__.py

@@ -0,0 +1,75 @@
+"""NewsBlur CLI - read feeds, manage stories, and train classifiers from your terminal."""
+
+from __future__ import annotations
+
+import typer
+
+app = typer.Typer(
+    name="newsblur",
+    help="NewsBlur CLI - read feeds, manage stories, and train classifiers from your terminal.",
+    no_args_is_help=True,
+)
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
+    raw_output: bool = typer.Option(False, "--raw", help="Output unformatted text"),
+    version: bool = typer.Option(False, "--version", "-v", help="Show version"),
+    server: str = typer.Option(
+        None, "--server", "-s",
+        help="NewsBlur server URL (default: https://newsblur.com). Persisted to config.",
+    ),
+):
+    """NewsBlur CLI - read feeds, manage stories, and train classifiers."""
+    ctx.ensure_object(dict)
+    ctx.obj["json"] = json_output
+    ctx.obj["raw"] = raw_output
+    if server:
+        from newsblur_mcp.cli.auth import set_server_url
+        set_server_url(server)
+    if version:
+        try:
+            from importlib.metadata import version as get_version
+
+            typer.echo(f"newsblur {get_version('newsblur-cli')}")
+        except Exception:
+            typer.echo("newsblur 0.1.0")
+        raise typer.Exit()
+    if ctx.invoked_subcommand is None:
+        typer.echo(ctx.get_help())
+        raise typer.Exit()
+
+
+# Register all command groups
+from newsblur_mcp.cli.commands import account as account_commands
+from newsblur_mcp.cli.commands import actions as actions_commands
+from newsblur_mcp.cli.commands import auth as auth_commands
+from newsblur_mcp.cli.commands import discover as discover_commands
+from newsblur_mcp.cli.commands import feeds as feeds_commands
+from newsblur_mcp.cli.commands import intelligence as intelligence_commands
+from newsblur_mcp.cli.commands import stories as stories_commands
+
+app.add_typer(auth_commands.app, name="auth", help="Login, logout, and check auth status")
+app.add_typer(stories_commands.app, name="stories", help="Read, search, and browse stories")
+app.add_typer(feeds_commands.app, name="feeds", help="List, add, and manage feed subscriptions")
+app.add_typer(
+    actions_commands.app,
+    name="actions",
+    help="Mark read, save, unsave, share stories",
+)
+app.add_typer(
+    intelligence_commands.app,
+    name="train",
+    help="View and train intelligence classifiers",
+)
+app.add_typer(discover_commands.app, name="discover", help="Find new feeds by topic or similarity")
+
+# Top-level shortcuts for common actions
+app.command("account")(account_commands.account_info)
+app.command("briefing")(stories_commands.briefing)
+app.command("read")(actions_commands.mark_read)
+app.command("save")(actions_commands.save)
+app.command("unsave")(actions_commands.unsave)
+app.command("share")(actions_commands.share)