RSS Agent Viewer

組み込みの検出、キャッシング、検索機能を備えた CLI RSS/Atom フィードビューアー。

クイックスタート

npx -y rss-agent-viewer init
npx -y rss-agent-viewer discover https://vercel.com
npx -y rss-agent-viewer add https://vercel.com/atom
npx -y rss-agent-viewer read

コアワークフロー

# 設定とデータベースを初期化
rss-viewer init

# サイトのフィードを検出
rss-viewer discover https://example.com

# フィードを購読 (オプション: --timeout で遅いフィード対応)
rss-viewer add https://example.com/feed.xml
rss-viewer add https://slow-site.com/feed.xml --timeout 30000

# フィードを一覧表示し、記事を読む
rss-viewer feeds
rss-viewer read

よくつかうコマンド

rss-viewer init
rss-viewer add <url>
rss-viewer discover <url>
rss-viewer feeds
rss-viewer remove <url>
rss-viewer read [url]
rss-viewer search <query>
rss-viewer discover-search <query>
rss-viewer import <file>
rss-viewer export
rss-viewer cache <action>
rss-viewer cleanup

使用パターン

検出と購読

rss-viewer discover https://example.com
rss-viewer add https://example.com/rss.xml

単一フィードを読む

rss-viewer read https://example.com/rss.xml

すべてのフィードを読む (デフォルトで新しいデータを取得)

# すべてのフィードから最新の記事を並列で取得
rss-viewer read

# キャッシュデータのみを使用 (ネットワークリクエストをスキップ)
rss-viewer read --cached

# 結果を制限
rss-viewer read --limit 10

# フィードごとに最新記事 1 件 (フィード多様化結果)
rss-viewer read --latest-per-feed --limit 10

# タイムアウト (遅いフィードまたは多くのフィード向け)
rss-viewer read --timeout 15000 --overall-timeout 180000

無効なフィードをクリーンアップ

# 壊れたフィードと重複フィードを削除
rss-viewer cleanup

# 削除されるものをプレビュー
rss-viewer cleanup --dry-run

# 壊れたフィードのみ削除
rss-viewer cleanup --broken

# 重複フィードのみ削除
rss-viewer cleanup --duplicates

すべてのフィードを検索

# ローカルデータベース検索 (全文検索で強化)
rss-viewer search "open source"

# Web 検索 + 検出 + 追加 + 検索を 1 コマンドで実行
rss-viewer discover-search "Rust programming" --auto-add --read

# Exa API を使用 (BYOK)
rss-viewer discover-search "AI safety" \
  --provider exa \
  --max-results 5 \
  --auto-add \
  --read

OPML をインポート

rss-viewer import feeds.opml

フィードをエクスポート

rss-viewer export

検索オプション

ローカルデータベース検索

rss-viewer search "React 19" --limit 10
rss-viewer search "TypeScript" --author "Dan" --since "2024-01-01"

Web 検索と検出

# エージェント組み込みの検索を使用 (デフォルト)
rss-viewer discover-search "micro-frontends" --auto-add --read

# Exa API を使用 (EXA_API_KEY が必要)
export EXA_API_KEY="your-api-key"
rss-viewer discover-search "WebGPU" \
  --provider exa \
  --max-results 5 \
  --category Development \
  --auto-add \
  --read \
  --limit 20

設定

環境変数:

EXA_API_KEY="your-api-key"                    # Exa API キー (オプション)
RSS_FEED_TIMEOUT=10000                        # フィードごとの取得タイムアウト (ミリ秒)
RSS_VIEWER_SEARCH_PROVIDER="agent|exa"        # 検索プロバイダー (デフォルト: agent)
RSS_VIEWER_MAX_WEB_RESULTS=10                 # Web 検索結果の最大数
RSS_VIEWER_SEARCH_LIMIT=20                    # 記事結果の最大数
RSS_VIEWER_BOOST_RECENT=false                 # 検索で最近の記事をブースト
EXA_API_URL="https://api.exa.ai/search"       # カスタム Exa エンドポイント (オプション)

設定ファイル (~/.config/rss-viewer/config.json):

{
  "webSearchProvider": "exa",
  "exaApiKey": "your-api-key",
  "feedTimeout": 10000,
  "overallTimeout": 120000,
  "maxWebResults": 10,
  "searchResultsLimit": 20,
  "boostRecentSearch": false
}

このツールを使うとき

• ターミナルから RSS/Atom フィードを管理・読む
• Web サイトからフィード URL を検出する
• 複数の購読フィード全文検索で検索する
• Web 検索クエリから新しいフィードを検出する
• フィード検出と購読ワークフローを自動化する
• OPML 経由で購読情報をインポート・エクスポートする
• データベースの壊れたフィードや重複フィードをクリーンアップする

詳細情報

• GitHub: https://github.com/brooksy4503/rss-agent-viewer