newsblur-cli
- Repo stars 7,469
- License MIT
- Author updated Live
- Author repo NewsBlur
- Domain
- Engineering
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 94 / 100 · audit passed
- Author / version / license
- @samuelclay · MIT
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- Python >=3.11
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- External requests
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: newsblur-cli
description: Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, tra…
category: engineering
runtime: Python
---
# newsblur-cli output preview
## PART A: Task fit
- Use case: Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, train intelligence classifiers, discover new feeds, and automate workflows with the NewsBlur CLI. Use when the user wants to interact with their NewsBlur account, check feeds, manage subscriptions, or build scripts around their news reading..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Setup / Readonly Mode / Output Formats” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, train intelligence classifiers, discover new feeds, and automate workflows with the NewsBlur CLI. Use when the user wants to interact with their NewsBlur account, check feeds, manage subscriptions, or build scripts around their news reading.”.
- **02** When the source has headings, the agent prioritizes “Setup / Readonly Mode / Output Formats” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; may access external network resources; usually needs no extra API key.
## Running Rules
- read files, write/modify files; may access external network resources; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “Setup / Readonly Mode / Output Formats”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: newsblur-cli
description: Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, tra…
category: engineering
source: samuelclay/NewsBlur
---
# newsblur-cli
## When to use
- Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, train intelligence classi…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Setup / Readonly Mode / Output Formats” and keep inference separate from source facts.
- read files, write/modify files; may access external network resources; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "newsblur-cli" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Setup / Readonly Mode / Output Formats
rules -> SKILL.md triggers / order / output contract
runtime -> Python | read files, write/modify files | may access external network resources
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} NewsBlur CLI
The NewsBlur CLI (newsblur-cli) gives you full access to your NewsBlur account from the terminal. Install it and authenticate before running any commands.
Setup
uv pip install newsblur-cli
newsblur auth login
auth login opens a browser for OAuth authorization. The token is stored at ~/.config/newsblur/.
For self-hosted instances, pass --server or set NEWSBLUR_SERVER:
newsblur --server https://my-newsblur.example.com auth login
Readonly Mode
The CLI has a readonly mode that blocks all write operations (saving, sharing, training, subscribing, marking as read). Useful when handing the CLI to an AI agent.
newsblur auth readonly --on
Check current readonly status:
newsblur auth readonly
Disabling readonly logs you out and requires browser re-authentication. An AI agent cannot silently toggle this off.
newsblur auth readonly --off
# "You have been logged out and must re-authenticate."
newsblur auth login
If you are operating in readonly mode, all write commands will fail with an error. Read commands work normally.
Output Formats
Every command supports these flags:
--json— structured JSON output, pipe tojq--raw— unformatted plain text- Default — human-readable formatted output
Commands
Stories
List unread stories across all feeds:
newsblur stories list
Filter by folder or limit results:
newsblur stories list --folder Tech --limit 5
Full-text search across your archive:
newsblur stories search "machine learning"
View saved/starred stories, optionally filtered by tag:
newsblur stories saved
newsblur stories saved --tag research
Browse stories from rarely-publishing feeds (easy to miss in a busy river):
newsblur stories infrequent
Fetch the original full article text from the source:
newsblur stories original <story_hash>
View stories you've already read:
newsblur stories read
Daily Briefing
Get an AI-curated briefing with top stories, infrequent site gems, and long reads:
newsblur briefing
newsblur briefing --limit 1
newsblur briefing --json
Feeds and Folders
List all subscriptions:
newsblur feeds list
View the folder tree with unread counts:
newsblur feeds folders
Get detailed info about a specific feed:
newsblur feeds info <feed_id>
Subscribe to a new feed:
newsblur feeds add https://example.com/feed.xml
newsblur feeds add https://blog.com -f Tech
Unsubscribe from a feed:
newsblur feeds remove <feed_id>
Move a feed between folders or rename it:
newsblur feeds organize move_feed --feed-id 42 --from News --to Tech
Story Actions
Save a story with tags:
newsblur save <story_hash> --tag ai --tag research
Remove a story from saved:
newsblur unsave <story_hash>
Mark stories as read by feed, folder, or specific story hashes:
newsblur read --feed 42
newsblur read --folder Tech
newsblur read 123:abc 456:def
Share a story to your Blurblog:
newsblur share <story_hash> --comment "Worth reading"
Intelligence Training
View your trained classifiers for a feed:
newsblur train show --feed 42
Train a like on an author, tag, title, or feed:
newsblur train like --feed 42 --author "Ben Thompson"
newsblur train like --feed 42 --tag analysis
newsblur train like --feed 42 --title "quarterly earnings"
Train a dislike:
newsblur train dislike --feed 42 --tag sponsored
newsblur train dislike --feed 42 --author "Guest Post"
Feed Discovery
Search for new feeds by topic:
newsblur discover search "machine learning"
Find feeds similar to one you already follow:
newsblur discover similar --feed 42
Browse trending feeds:
newsblur discover trending
Notifications
Manage per-feed notification settings:
newsblur notifications --feed 42
Account
View your account info and subscription status:
newsblur account
Scripting Examples
Pipe story titles to the terminal:
newsblur stories list --json | jq -r '.items[] | "\(.title) - \(.feed_title)"'
Extract briefing summaries:
newsblur briefing --json | jq '.items[0].section_summaries'
Save all unread stories from a folder with a tag:
for hash in $(newsblur stories list --folder Research --json | jq -r '.items[].story_hash'); do
newsblur save "$hash" --tag to-review
done
Export your feed list:
newsblur feeds list --json | jq -r '.items[] | "\(.feed_title),\(.feed_address)"'
Requirements
- Python 3.11+
- Premium Archive ($99/year) or Premium Pro ($29/month) subscription
- OAuth authentication via browser
Decide Fit First
Design Intent
How To Use It
Boundaries And Review