NewsBlur CLI

NewsBlur CLI（newsblur-cli）により、ターミナルから NewsBlur アカウントへのフルアクセスが可能になります。コマンドを実行する前に、インストールと認証を行ってください。

セットアップ

uv pip install newsblur-cli
newsblur auth login

auth login はブラウザを開いて OAuth 認証を実行します。トークンは ~/.config/newsblur/ に保存されます。

セルフホスト型インスタンスの場合、--server を指定するか NEWSBLUR_SERVER を設定してください：

newsblur --server https://my-newsblur.example.com auth login

読み取り専用モード

CLI には読み取り専用モードがあり、すべての書き込み操作（保存、共有、トレーニング、購読、既読マーク）をブロックします。AI エージェントに CLI を渡す際に便利です。

newsblur auth readonly --on

現在の読み取り専用状態を確認します：

newsblur auth readonly

読み取り専用を無効にするとログアウトされ、ブラウザでの再認証が必要になります。AI エージェントがこれをサイレントに無効にすることはできません。

newsblur auth readonly --off
# "You have been logged out and must re-authenticate."
newsblur auth login

読み取り専用モードで動作している場合、すべての書き込みコマンドはエラーで失敗します。読み取りコマンドは正常に動作します。

出力形式

すべてのコマンドは以下のフラグをサポートしています：

• --json — 構造化 JSON 出力、jq にパイプ可能
• --raw — 形式なしのプレーンテキスト
• デフォルト — 人間が読みやすい形式の出力

コマンド

ストーリー

すべてのフィード全体の未読ストーリーをリスト表示：

newsblur stories list

フォルダで絞り込むか、結果を制限：

newsblur stories list --folder Tech --limit 5

アーカイブ全体でフルテキスト検索：

newsblur stories search "machine learning"

保存済み/スター付きストーリーを表示、オプションでタグでフィルタリング：

newsblur stories saved
newsblur stories saved --tag research

更新頻度の低いフィード（忙しいフィードストリームで見逃しやすい）のストーリーを閲覧：

newsblur stories infrequent

ソースから元の完全な記事テキストを取得：

newsblur stories original <story_hash>

既に読んだストーリーを表示：

newsblur stories read

日刊ブリーフィング

AI がキュレーションした、トップストーリー、更新頻度の低いサイトの珠玉、ロングリード含むブリーフィングを取得：

newsblur briefing
newsblur briefing --limit 1
newsblur briefing --json

フィードとフォルダ

すべての購読をリスト表示：

newsblur feeds list

未読数付きのフォルダツリーを表示：

newsblur feeds folders

特定のフィードの詳細情報を取得：

newsblur feeds info <feed_id>

新しいフィードを購読：

newsblur feeds add https://example.com/feed.xml
newsblur feeds add https://blog.com -f Tech

フィードの購読を解除：

newsblur feeds remove <feed_id>

フィードをフォルダ間で移動または名前変更：

newsblur feeds organize move_feed --feed-id 42 --from News --to Tech

ストーリーアクション

ストーリーをタグ付けで保存：

newsblur save <story_hash> --tag ai --tag research

ストーリーを保存済みから削除：

newsblur unsave <story_hash>

フィード、フォルダ、または特定のストーリーハッシュで既読をマーク：

newsblur read --feed 42
newsblur read --folder Tech
newsblur read 123:abc 456:def

Blurblog にストーリーを共有：

newsblur share <story_hash> --comment "Worth reading"

インテリジェンストレーニング

フィードのトレーニング済みクラシファイアを表示：

newsblur train show --feed 42

著者、タグ、タイトル、またはフィードでいいね を トレーニング：

newsblur train like --feed 42 --author "Ben Thompson"
newsblur train like --feed 42 --tag analysis
newsblur train like --feed 42 --title "quarterly earnings"

よくないね をトレーニング：

newsblur train dislike --feed 42 --tag sponsored
newsblur train dislike --feed 42 --author "Guest Post"

フィード発見

トピック別に新しいフィードを検索：

newsblur discover search "machine learning"

既に購読しているフィードと似たフィードを検索：

newsblur discover similar --feed 42

トレンディングフィードを閲覧：

newsblur discover trending

通知

フィードごとの通知設定を管理：

newsblur notifications --feed 42

アカウント

アカウント情報と購読状況を表示：

newsblur account

スクリプト例

ストーリーのタイトルをターミナルにパイプ：

newsblur stories list --json | jq -r '.items[] | "\(.title) - \(.feed_title)"'

ブリーフィングサマリーを抽出：

newsblur briefing --json | jq '.items[0].section_summaries'

フォルダ内のすべての未読ストーリーをタグ付けで保存：

for hash in $(newsblur stories list --folder Research --json | jq -r '.items[].story_hash'); do
  newsblur save "$hash" --tag to-review
done

フィードリストをエクスポート：

newsblur feeds list --json | jq -r '.items[] | "\(.feed_title),\(.feed_address)"'

要件

• Python 3.11 以上
• Premium Archive（99 ドル/年）または Premium Pro（29 ドル/月）購読
• ブラウザ経由の OAuth 認証