Super Rss Agent — 超级RSS代理
v0.1.0功能强大的 RSS 订阅管理与阅读工具。用于 (1) 导入/导出 OPML 文件, (2) 管理 RSS 订阅源(支持自动发现), (3) 扫描并追踪文章的已读/未读状态, (4) 无 RSS 站点的 HTML 抓取回退, (5) 渐进式阅读与文章摘要, (6) 文章搜索与统计, (7) 自动清理旧文章。 (无需翻译,原文已是中文)
运行时依赖
安装命令
点击复制技能文档
Super RSS 代理
在 OpenClaw 中直接管理和消费 RSS 订阅。本 技能 替代传统 RSS 阅读器,提供 AI 驱动的摘要、渐进式阅读、文章追踪和自动化推送。
快速开始 # 添加博客(自动发现 RSS 订阅源) python3 scripts/super_rss_代理.py 添加 https://example.com --name "我的博客" --category 技术
# 扫描所有订阅,拉取新文章 python3 scripts/super_rss_代理.py 扫描
# 查看未读文章 python3 scripts/super_rss_代理.py articles
# 搜索文章 python3 scripts/super_rss_代理.py 搜索 "AI"
# 标记文章为已读 python3 scripts/super_rss_代理.py read 42
# 列出所有订阅 python3 scripts/super_rss_代理.py 列出
# 导出为 OPML python3 scripts/super_rss_代理.py 导出 -o my_feeds.opml
所有命令均支持 --db <路径> 全局参数指定自定义数据库文件。
命令行工具 命令 列出 - 列出订阅 super_rss_代理 列出 # 列出所有订阅 super_rss_代理 列出 --category Tech # 按分类筛选 super_rss_代理 列出 --verbose # 显示订阅源 URL、选择器、上次扫描时间
添加 - 添加订阅 super_rss_代理 添加 # 从博客 URL 自动发现订阅源 super_rss_代理 添加 --name "我的博客" -c 技术 # 自定义名称和分类 super_rss_代理 添加 --feed-url # 手动指定订阅源 URL super_rss_代理 添加 --scrape-selector "article h2 a" # 设置 HTML 抓取的 CSS 选择器
Feed 自动发现:输入博客主页 URL 时,代理会自动发现 RSS/Atom 订阅源:
搜索 HTML 中的 标签 尝试常见路径:/feed、/rss、/feed.xml、/atom.xml 等 移除 - 删除订阅 super_rss_代理 移除 "订阅名称" # 按名称删除(需确认) super_rss_代理 移除 "订阅名称" -y # 跳过确认直接删除 super_rss_代理 移除 https://example.com/feed.xml # 按 URL 删除
更新 - 更新订阅信息 super_rss_代理 更新 "订阅名称" -n "新名称" # 修改名称 super_rss_代理 更新 "订阅名称" -c "新分类" # 修改分类 super_rss_代理 更新 "订阅名称" --feed-url # 修改 Feed URL super_rss_代理 更新 "订阅名称" --url # 修改主页 URL super_rss_代理 更新 "订阅名称" --scrape-selector "" # 清除 CSS 选择器
扫描 - 扫描新文章 super_rss_代理 扫描 # 扫描所有订阅 super_rss_代理 扫描 "博客名称" # 扫描指定博客 super_rss_代理 扫描 --workers 10 # 使用 10 个并发线程 super_rss_代理 扫描 --silent # 静默模式(不输出过程信息)
扫描器的工作流程:
优先尝试 RSS/Atom 订阅源 如果没有 feed_url,自动发现 Feed 并更新记录 如果配置了 scrape_selector,回退到 HTML 抓取 按 URL 自动去重 将新文章存入数据库 扫描完成后自动清理旧的已读文章(可通过 config 关闭) articles - 列出文章 super_rss_代理 articles # 显示未读文章(默认每页 50 条) super_rss_代理 articles --all # 包含已读文章 super_rss_代理 articles --b记录 "博客名称" # 按博客筛选 super_rss_代理 articles --category "技术" # 按分类筛选 super_rss_代理 articles -n 20 # 每页 20 条 super_rss_代理 articles --off设置 50 # 翻页(跳过前 50 条)
搜索 - 搜索文章 super_rss_代理 搜索 "WASM" # 按关键词搜索标题和摘要 super_rss_代理 搜索 "AI" --all # 搜索含已读文章 super_rss_代理 搜索 "Rust" -c "技术" # 按分类筛选 super_rss_代理 搜索 "安全" -b "博客名称" # 按博客筛选 super_rss_代理 搜索 "AI" -n 100 # 增加结果数量(默认 50)
read / unread - 标记文章状态 super_rss_代理 read <文章ID> # 标记为已读 super_rss_代理 unread <文章ID> # 标记为未读
read-all - 全部标记为已读 super_rss_代理 read-all # 全部标记为已读(需确认) super_rss_代理 read-all -y # 跳过确认 super_rss_代理 read-all --b记录 "博客名称" # 仅标记指定博客的文章 super_rss_代理 read-all --category "技术" # 仅标记指定分类的文章
检查 - 健康检查 super_rss_代理 检查 # 检查所有订阅源的连通性
fetch - 实时拉取内容 super_rss_代理 fetch "订阅名称" # 拉取最新 5 条 super_rss_代理 fetch "订阅名称" -n 10 # 拉取最新 10 条 super_rss_代理 fetch "订阅名称" -v # 显示链接 super_rss_代理 fetch "订阅名称" --full-content # 拉取全文(如果订阅源支持)
digest - 每日摘要 super_rss_代理 digest # 获取今日更新 super_rss_代理 digest -d 2 # 获取近 2 天的更新 super_rss_代理 digest -c "AI" --limit 5 # 按分类筛选
stats - 订阅统计 super_rss_代理 stats # 显示所有订阅的统计信息 super_rss_代理 stats --stale-days 60 # 自定义死源检测阈值(默认 90 天)
显示内容:总订阅数、总文章数、未读数、数据库大小、按分类分组的各源活跃度和未读积压、疑似死源检测。
config - 查看/修改配置 super_rss_代理 config # 列出所有配置 super_rss_代理 config auto_清理 false # 关闭自动清理 super_rss_代理 config auto_清理_days 30 # 修改清理天数 super_rss_代理 config auto_清理 --re设置 # 恢复默认值
配置项 默认值 说明 auto_清理 true 扫描后是否自动清理旧的已读文章 auto_清理_days 90 自动清理多少天前的已读文章 清理 - 手动清理旧文章 super_rss_代理 清理 # 清理 90 天前的已读文章(需确认) super_rss_代理 清理 -d 30 # 清理 30 天前 super_rss_代理 清理 -b "博客名称" # 仅清理指定博客 super_rss_代理 清理 --include-unread # 同时清理未读文章 super_rss_代理 清理 -y # 跳过确认
test - 测试订阅 super_rss_代理 test https://example.com # 测试 URL 是否可以订阅 super_rss_代理 test https://example.com --scrape-selector "article h2 a" # 测试 HTML 抓取
执行 5 步诊断:URL 验证 → 连通性测试 → Feed 类型检测 → Feed 自动发现 → 解析并展示样本文章。
导出 - 导出为 OPML super_rss_代理 导出 # 导出为 rss_导出_YYYYMMDD.opml super_rss_代理 导出 -o 备份.opml # 指定输出文件名
导入 - 从 OPML 导入 super_rss_代理 导入 follow.opml # 从 OPML 文件导入
命令速查表 命令 说明 常用参数 列出 列出所有订阅 -c 分类, -v 详细 添加 添加订阅 -n 名称, -c 分类, --feed-url, --sc