Miniflux阅读管理

技能简介

Miniflux技能提供命令行方式浏览、阅读和管理Miniflux RSS/Atom订阅源文章，支持未读文章列表、内容获取、标记已读/未读、订阅源与分类管理等功能。

能做什么

• 列出未读/已读/星标文章，支持按订阅源、分类、关键词筛选
• 获取单篇文章完整内容或指定长度片段
• 批量标记文章为已读或未读状态
• 查看订阅源列表与分类结构
• 显示文章统计（字数、字符数、预估阅读时间）
• 触发订阅源刷新更新
• 搜索文章内容

使用说明

安装依赖

# 需预先安装 uv
pip install uv

配置方式（三选一，优先级从高到低）

1. 环境变量：export MINIFLUX_URL="https://miniflux.example.org" 和 export MINIFLUX_API_KEY="your-api-key"
2. CLI参数：uv run scripts/miniflux-cli.py --url="..." --api-key="..." list（自动保存至配置文件）
3. 配置文件：首次运行后自动生成于 ~/.local/share/miniflux/config.json

常用操作

# 列出未读文章（简略格式）
uv run scripts/miniflux-cli.py list --status=unread --brief

# 获取文章详情（限制2000字符）
uv run scripts/miniflux-cli.py get 123 --limit=2000

# 分页读取长文章（从第5000字符开始，取5000字符）
uv run scripts/miniflux-cli.py get 123 --offset=5000 --limit=5000

# 标记多篇文章已读
uv run scripts/miniflux-cli.py mark-read 123 456 789

# 查看文章统计
uv run scripts/miniflux-cli.py stats --entry-id=123

# 搜索并筛选未读结果
uv run scripts/miniflux-cli.py search "python" --status=unread --brief

输出格式选项：–brief（仅标题）、–summary（标题+摘要）、–full（完整内容，默认）、–json（JSON格式）、–plain（单行制表符分隔）

输入与输出

见下方输入与输出表格。

风险提示

• API密钥需妥善保管，避免泄露至代码仓库
• 长文章分页读取时注意offset计算，避免内容遗漏
• 频繁调用refresh可能触发Miniflux服务端限流
• content-limit设置过小可能导致关键信息截断

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/shekohex/miniflux/SKILL.md
来源类型：GitHub仓库