Back to Details

rss-agent-viewer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

RSS Agent Viewer

RSS Agent 阅读器

CLI RSS/Atom feed viewer with built-in discovery, caching, and search.
一款内置发现、缓存和搜索功能的CLI RSS/Atom阅读器。

Quick start

快速开始

bash
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
bash
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

Core workflow

核心工作流

bash
undefined
bash
undefined

Initialize config + database

初始化配置与数据库

rss-viewer init
rss-viewer init

Discover feeds for a site

发现指定网站的订阅源

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

Subscribe to a feed

订阅一个源

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

List feeds and read articles

列出订阅源并阅读文章

rss-viewer feeds rss-viewer read
undefined
rss-viewer feeds rss-viewer read
undefined

Common commands

常用命令

bash
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>
bash
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>

Usage patterns

使用场景

Discover and subscribe

发现并订阅

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

Read a single feed

阅读单个订阅源

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

Search across all feeds

跨所有订阅源搜索

bash
undefined
bash
undefined

Local database search (enhanced with full-text search)

本地数据库搜索（支持全文搜索增强）

rss-viewer search "open source"
rss-viewer search "open source"

Web search + discovery + add + search in one command

一站式完成网页搜索+订阅源发现+添加+搜索

rss-viewer discover-search "Rust programming" --auto-add --read
rss-viewer discover-search "Rust programming" --auto-add --read

Using Exa API (BYOK)

使用Exa API（需自备密钥）

rss-viewer discover-search "AI safety"
--provider exa
--max-results 5
--auto-add
--read
undefined
rss-viewer discover-search "AI safety"
--provider exa
--max-results 5
--auto-add
--read
undefined

Import OPML

导入OPML

bash
rss-viewer import feeds.opml
bash
rss-viewer import feeds.opml

Export feeds

导出订阅源

bash
rss-viewer export
bash
rss-viewer export

Search Options

搜索选项

Local Database Search

本地数据库搜索

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

Web Search with Discovery

结合订阅源发现的网页搜索

bash
undefined
bash
undefined

Use agent's built-in search (default)

使用工具内置的搜索（默认）

rss-viewer discover-search "micro-frontends" --auto-add --read
rss-viewer discover-search "micro-frontends" --auto-add --read

Use Exa API (requires EXA_API_KEY)

使用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
undefined
export EXA_API_KEY="your-api-key" rss-viewer discover-search "WebGPU"
--provider exa
--max-results 5
--category Development
--auto-add
--read
--limit 20
undefined

Configuration

配置

Environment Variables:
bash
EXA_API_KEY="your-api-key"                    # Exa API key (optional)
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 File (~/.config/rss-viewer/config.json):
json
{
  "webSearchProvider": "exa",
  "exaApiKey": "your-api-key",
  "maxWebResults": 10,
  "searchResultsLimit": 20,
  "boostRecentSearch": false
}
环境变量：
bash
EXA_API_KEY="your-api-key"                    # Exa API密钥（可选）
RSS_VIEWER_SEARCH_PROVIDER="agent|exa"        # 搜索提供商（默认：agent）
RSS_VIEWER_MAX_WEB_RESULTS=10                 # 最大网页搜索结果数
RSS_VIEWER_SEARCH_LIMIT=20                    # 最大文章结果数
RSS_VIEWER_BOOST_RECENT=false                # 是否在搜索中优先显示近期文章
EXA_API_URL="https://api.exa.ai/search"      # 自定义Exa接口地址（可选）
配置文件（~/.config/rss-viewer/config.json）：
json
{
  "webSearchProvider": "exa",
  "exaApiKey": "your-api-key",
  "maxWebResults": 10,
  "searchResultsLimit": 20,
  "boostRecentSearch": false
}

When to use this tool

适用场景

  • Manage and read RSS/Atom feeds from the terminal
  • Discover feed URLs from a website
  • Search across multiple subscriptions with full-text search
  • Discover new feeds from web search queries
  • Automate feed discovery and subscription workflow
  • Import or export subscriptions via OPML
  • 从终端管理和阅读RSS/Atom订阅源
  • 从网站中发现订阅源地址
  • 通过全文搜索跨多个订阅源查找内容
  • 根据网页搜索结果发现新的订阅源
  • 自动化订阅源发现与订阅流程
  • 通过OPML导入或导出订阅列表

More information

更多信息