mcpField
R
rss-agent-viewer

rss-agent-viewer

github.com/brooksy4503生产力6565 次安装35 周前更新
代码仓库

关于 rss-agent-viewer

rss-agent-viewer 是用于发现、管理、阅读和搜索 RSS/Atom 订阅源的 CLI，结合了订阅源发现、缓存阅读、本地全文搜索以及 OPML 导入导出。

主要功能

  1. 01从网站发现订阅源
  2. 02订阅和管理订阅源
  3. 03阅读最新或缓存文章
  4. 04跨订阅源搜索文章
  5. 05导入和导出 OPML
  6. 06清理失效或重复订阅源

适用场景

  1. 01查找并订阅网站的订阅源
  2. 02阅读多个订阅源的文章
  3. 03按词组、作者或日期搜索文章
  4. 04通过 OPML 文件迁移订阅

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/brooksy4503/rss-agent-viewer --skill rss-agent-viewer

安装后在 Claude Code 中输入/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 导入或导出订阅
  • 从数据库中清理失效或重复的订阅源

更多信息

评论

支持 Markdown