rss-agent-viewer

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

基本的なワークフロー

# Initialize config + database
rss-viewer init

# Discover feeds for a site
rss-viewer discover https://example.com

# Subscribe to a feed (optional: --timeout for slow feeds)
rss-viewer add https://example.com/feed.xml
rss-viewer add https://slow-site.com/feed.xml --timeout 30000

# List feeds and read articles
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

すべてのフィードを読む（デフォルトで最新の内容を取得）

# Fetches fresh articles from all feeds in parallel
rss-viewer read

# Use cached data only (skip network requests)
rss-viewer read --cached

# Limit results
rss-viewer read --limit 10

# One latest article per feed (feed-diverse results)
rss-viewer read --latest-per-feed --limit 10

# Timeouts (for slow feeds or many feeds)
rss-viewer read --timeout 15000 --overall-timeout 180000

無効なフィードを整理する

# Remove broken and duplicate feeds
rss-viewer cleanup

# Preview what would be removed
rss-viewer cleanup --dry-run

# Only remove broken feeds
rss-viewer cleanup --broken

# Only remove duplicates
rss-viewer cleanup --duplicates

すべてのフィードを検索する

# Local database search (enhanced with full-text search)
rss-viewer search "open source"

# Web search + discovery + add + search in one command
rss-viewer discover-search "Rust programming" --auto-add --read

# Using 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"

検出機能を使ったウェブ検索

# Use agent's built-in search (default)
rss-viewer discover-search "micro-frontends" --auto-add --read

# Use Exa API (requires 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 key (optional)
RSS_FEED_TIMEOUT=10000                        # Per-feed fetch timeout (ms)
RSS_VIEWER_SEARCH_PROVIDER="agent|exa"        # Search provider (default: agent)
RSS_VIEWER_MAX_WEB_RESULTS=10                 # Max web search results
RSS_VIEWER_SEARCH_LIMIT=20                    # Max article results
RSS_VIEWER_BOOST_RECENT=false                 # Boost recent articles in search
EXA_API_URL="https://api.exa.ai/search"       # Custom Exa endpoint (optional)

設定ファイル（~/.config/rss-viewer/config.json）：

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

このツールを使う場面

• ターミナルから RSS/Atom フィードを管理して読む
• ウェブサイトからフィード URL を検出する
• 全文検索で複数の購読フィードを検索する
• ウェブ検索クエリから新しいフィードを検出する
• フィードの検出と購読のワークフローを自動化する
• OPML で購読をインポートまたはエクスポートする
• データベースから壊れたフィードや重複したフィードを整理する

詳細情報

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