Miniflux Skill
Browse, read, and manage Miniflux RSS/atom feed articles through a CLI.
Quick Start
CODEBLOCK0
Configuration
Configuration precedence (highest to lowest):
- 1. CLI flags:
--url, INLINECODE1 - Environment variables:
MINIFLUX_URL, INLINECODE3 - Config file:
~/.local/share/miniflux/config.json (auto-created on first run)
Setup
CODEBLOCK1
Subcommands
list - List Articles
List articles with optional filtering.
CODEBLOCK2
Flags:
- -
--status={read,unread,removed} - Filter by status - INLINECODE6 - Filter by feed ID
- INLINECODE7 - Filter by category ID
- INLINECODE8 - Show only starred
- INLINECODE9 - Search articles
- INLINECODE10 - Max number of entries
- INLINECODE11 - Skip first N chars in content
- INLINECODE12 - Max characters per article
- INLINECODE13 - Titles only
- INLINECODE14 - Title + excerpt
- INLINECODE15 - Full content (default)
- INLINECODE16 - JSON output
- INLINECODE17 - Single-line per entry
get - Get Article by ID
Fetch a single article with content control.
CODEBLOCK3
When content is truncated, shows: INLINECODE18
mark-read - Mark as Read
Mark one or more articles as read.
CODEBLOCK4
mark-unread - Mark as Unread
Mark one or more articles as unread.
CODEBLOCK5
feeds - List Feeds
List all configured feeds.
CODEBLOCK6
categories - List Categories
List all categories.
CODEBLOCK7
stats - Statistics
Show unread counts or article statistics.
CODEBLOCK8
refresh - Refresh Feeds
Trigger feed refresh.
CODEBLOCK9
search - Search Articles
Convenient alias for list --search.
CODEBLOCK10
Output Formats
- -
--brief / -b - Quick overview (titles + feed + date) - INLINECODE22 /
-s - Title + content preview (200 chars) - INLINECODE24 /
-f - Complete article content (default) - INLINECODE26 - Raw JSON output for machine processing
- INLINECODE27 - Single-line per entry (tab-separated)
Long Article Handling
For articles with large content (e.g., >5k words):
- 1. Check statistics first:
uv run scripts/miniflux-cli.py stats --entry-id=123
Shows word count, character count, reading time.
- 2. Use pagination to read in chunks:
CODEBLOCK12
- 3. For summarization: If article is >5000 words, use a subagent to read and summarize:
CODEBLOCK13
Error Handling
The CLI provides helpful error messages:
- - Invalid credentials → Check INLINECODE28
- Article not found → Suggests using
list to browse - Missing config → Shows config file location
- No results → Clear message
Standard Flags
- -
-v, --version - Show version - INLINECODE31 - Suppress non-error output
- INLINECODE32 - Enable debug output
- INLINECODE33 - Disable colored output
- INLINECODE34 - Miniflux server URL
- INLINECODE35 - Miniflux API key
Examples
Daily Workflow
CODEBLOCK14
Research Mode
CODEBLOCK15
Batch Processing
CODEBLOCK16
For complete help on any subcommand:
CODEBLOCK17
Miniflux 技能
通过命令行界面浏览、阅读和管理 Miniflux RSS/Atom 订阅文章。
快速开始
bash
列出未读文章（简洁格式）
uv run scripts/miniflux-cli.py list --status=unread --brief
获取文章详情
uv run scripts/miniflux-cli.py get 123
将文章标记为已读
uv run scripts/miniflux-cli.py mark-read 123 456
显示文章统计信息（字数、阅读时间）
uv run scripts/miniflux-cli.py stats --entry-id=123
配置
配置优先级（从高到低）：
- 1. 命令行参数：--url、--api-key
- 环境变量：MINIFLUXURL、MINIFLUXAPI_KEY
- 配置文件：~/.local/share/miniflux/config.json（首次运行时自动创建）
设置
bash
选项1：环境变量（推荐用于代理）
export MINIFLUX_URL=https://miniflux.example.org
export MINIFLUX
APIKEY=your-api-key
选项2：命令行参数（一次性，保存到配置）
uv run scripts/miniflux-cli.py --url=https://miniflux.example.org --api-key=xxx list
子命令
list - 列出文章
列出文章并支持可选筛选。
bash
未读文章（简洁）
uv run scripts/miniflux-cli.py list --status=unread --brief
来自特定订阅源并显示摘要
uv run scripts/miniflux-cli.py list --feed=42 --summary
搜索并限制数量
uv run scripts/miniflux-cli.py list --search=python --limit=10
星标文章
uv run scripts/miniflux-cli.py list --starred
参数：
- - --status={read,unread,removed} - 按状态筛选
- --feed=ID - 按订阅源ID筛选
- --category=ID - 按分类ID筛选
- --starred - 仅显示星标文章
- --search=QUERY - 搜索文章
- --limit=N - 最大条目数
- --offset=N - 跳过内容中前N个字符
- --content-limit=N - 每篇文章最大字符数
- -b, --brief - 仅显示标题
- -s, --summary - 标题+摘要
- -f, --full - 完整内容（默认）
- --json - JSON格式输出
- --plain - 每行一个条目
get - 按ID获取文章
获取单篇文章并控制内容显示。
bash
完整文章
uv run scripts/miniflux-cli.py get 123
前2000个字符
uv run scripts/miniflux-cli.py get 123 --limit=2000
从第1000个字符读到第2000个字符（分页）
uv run scripts/miniflux-cli.py get 123 --offset=1000 --limit=1000
内容被截断时，显示：[...已截断，共N个字符]
mark-read - 标记为已读
将一篇或多篇文章标记为已读。
bash
单篇文章
uv run scripts/miniflux-cli.py mark-read 123
多篇文章
uv run scripts/miniflux-cli.py mark-read 123 456 789
mark-unread - 标记为未读
将一篇或多篇文章标记为未读。
bash
uv run scripts/miniflux-cli.py mark-unread 123
feeds - 列出订阅源
列出所有已配置的订阅源。
bash
人类可读格式
uv run scripts/miniflux-cli.py feeds
JSON格式
uv run scripts/miniflux-cli.py feeds --json
categories - 列出分类
列出所有分类。
bash
uv run scripts/miniflux-cli.py categories
stats - 统计信息
显示未读计数或文章统计信息。
bash
文章统计信息（字数、字符数、阅读时间）
uv run scripts/miniflux-cli.py stats --entry-id=123
每个订阅源的全局未读计数
uv run scripts/miniflux-cli.py stats
refresh - 刷新订阅源
触发订阅源刷新。
bash
刷新所有订阅源
uv run scripts/miniflux-cli.py refresh --all
刷新特定订阅源
uv run scripts/miniflux-cli.py refresh --feed=42
search - 搜索文章
list --search 的便捷别名。
bash
uv run scripts/miniflux-cli.py search rust
uv run scripts/miniflux-cli.py search ai --status=unread --brief
输出格式
- - --brief / -b - 快速概览（标题+订阅源+日期）
- --summary / -s - 标题+内容预览（200个字符）
- --full / -f - 完整文章内容（默认）
- --json - 原始JSON输出，用于机器处理
- --plain - 每行一个条目（制表符分隔）
长文章处理
对于内容较大的文章（例如>5000字）：
- 1. 首先查看统计信息：
bash
uv run scripts/miniflux-cli.py stats --entry-id=123
显示字数、字符数、阅读时间。
- 2. 使用分页分块阅读：
bash
# 前5000个字符
uv run scripts/miniflux-cli.py get 123 --limit=5000
# 接下来5000个字符（第5000-10000个字符）
uv run scripts/miniflux-cli.py get 123 --offset=5000 --limit=5000
- 3. 用于摘要生成： 如果文章超过5000字，使用子代理阅读和总结：
bash
# 获取统计信息以确定字数
uv run scripts/miniflux-cli.py stats --entry-id=123
# 如果超过5000字，委托给子代理进行摘要生成
错误处理
CLI提供有用的错误信息：
- - 无效凭据 → 检查 MINIFLUXAPIKEY
- 文章未找到 → 建议使用 list 浏览
- 缺少配置 → 显示配置文件位置
- 无结果 → 清晰提示
标准参数
- - -v, --version - 显示版本
- -q, --quiet - 抑制非错误输出
- -d, --debug - 启用调试输出
- --no-color - 禁用彩色输出
- --url=URL - Miniflux服务器URL
- --api-key=KEY - Miniflux API密钥
示例
日常工作流程
bash
查看未读文章
uv run scripts/miniflux-cli.py list --status=unread --brief
阅读感兴趣的文章
uv run scripts/miniflux-cli.py get 456
标记为已读
uv run scripts/miniflux-cli.py mark-read 456
研究模式
bash
搜索特定主题
uv run scripts/miniflux-cli.py search 机器学习 --summary
获取完整文章内容
uv run scripts/miniflux-cli.py get 789
批量处理
bash
获取所有未读文章为JSON格式进行处理
uv run scripts/miniflux-cli.py list --status=unread --json
批量标记为已读
uv run scripts/miniflux-cli.py mark-read 123 456 789
获取任何子命令的完整帮助信息：
bash
uv run scripts/miniflux-cli.py <子命令> --help
