mcpField
F
freshrss

freshrss

github.com/wmy2981生产力155 次安装5 周前更新
代码仓库

关于 freshrss

freshrss 是用于通过 FreshRSS 的 Google Reader 兼容 API 管理订阅和文章的技能，适合自托管 RSS 阅读器用户。它通过 Python 脚本提供阅读、搜索和订阅管理操作。

主要功能

  1. 01查看最新、未读和收藏文章
  2. 02按订阅源或分类筛选文章
  3. 03搜索文章标题或内容
  4. 04管理订阅源与分类
  5. 05标记已读或收藏文章
  6. 06以 JSON 输出结果

适用场景

  1. 01查看 FreshRSS 中的未读文章
  2. 02搜索订阅文章中的关键词
  3. 03添加、移动或移除订阅源
  4. 04按兴趣主题寻找新订阅源

安装

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

$npx skills add https://github.com/wmy2981/skills --skill freshrss

安装后在 Claude Code 中输入/freshrss确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.claude-plugin/
plugin.json
references/
api_doc.md
scripts/
.env.example
freshrss.py

详细介绍

FreshRSS

通过兼容 Google Reader 的 API（GReader）访问的自托管 RSS 阅读器。 所有操作都通过单个 Python 脚本完成。

执行规则

直接运行用户请求的命令，不要预先检查依赖项、环境变量或配置。如果出现问题，脚本会给出明确的错误信息——届时再检查并修复。

环境变量

变量描述
FRESHRSS_URL基础 URL（例如 http://127.0.0.1:1180）
FRESHRSS_API_USERAPI 用户名
FRESHRSS_API_PASSWORDAPI 密码

💡 环境变量可以配置在 ~/.wmyskills/.env（技能间共享）或 scripts/.env（如果存在，则优先使用）。脚本会自动加载它们。

用法

python scripts/freshrss.py <command> [options]

阅读命令的常用选项：--count N（默认值为 20）、-v/--verbose（包含摘要文本）。

阅读文章

最新文章
python scripts/freshrss.py recent --count 10
python scripts/freshrss.py recent --count 5 -v    # with summary
未读文章
python scripts/freshrss.py unread --count 20
特定订阅源的文章
python scripts/freshrss.py feed --url "https://example.com/rss" --count 10
特定分类的文章
python scripts/freshrss.py category --name "Technology" --count 15
已加星标的文章
python scripts/freshrss.py starred --count 20
搜索文章

仅搜索标题（速度快，默认扫描 200 篇文章，最多 1000 篇）：

python scripts/freshrss.py search -k "keyword"

搜索标题和内容（速度较慢，可使用 --batch 控制扫描数量）：

python scripts/freshrss.py search -k "keyword" --deep --batch 500

订阅源管理

列出所有订阅
python scripts/freshrss.py list-feeds
列出分类
python scripts/freshrss.py list-categories
未读数量
python scripts/freshrss.py unread-count
添加订阅源
python scripts/freshrss.py add-feed --url "https://example.com/feed.xml" --category "News"
将订阅源移至其他分类
python scripts/freshrss.py move-feed --feed-id "feed/https://..." --to "NewCat" --from "OldCat"
移除订阅源
python scripts/freshrss.py remove-feed --feed-id "feed/https://..."
将文章标记为已读
python scripts/freshrss.py mark-read --item-id "tag:google.com,2005:reader/item/..."
为文章加星标
python scripts/freshrss.py star --item-id "tag:google.com,2005:reader/item/..."

订阅源推荐

收到推荐请求时：

  1. 运行 list-feeds，查看当前订阅和分类
  2. 根据订阅源标题和分类识别主题
  3. 使用网页搜索查找用户尚未关注的相似主题订阅源
  4. 按兴趣领域分组展示推荐内容

备注

  • 每次调用都会重新获取身份验证令牌（无需缓存）
  • 所有输出均为 JSON，便于解析
  • 由于 GReader API 不支持原生搜索，搜索会在客户端进行筛选
  • 订阅源流 ID 使用格式 feed/https://example.com/rss
  • 使用 -v 可在输出中包含文章摘要（适用于所有阅读命令）

评论

支持 Markdown