名称： miniflux
描述： "浏览、阅读和管理 Miniflux 订阅源文章。当 Claude 需要通过 Miniflux 处理 RSS/Atom 订阅源时使用——列出未读/新文章、阅读文章内容、将文章标记为已读、管理订阅源/分类。提供灵活的 CLI 访问，支持多种输出格式（标题、摘要、完整内容）。"
元数据： {"clawdbot":{"emoji":"📣","requires":{"bins":["uv"]}}}

Miniflux 技能

通过命令行界面浏览、阅读和管理 Miniflux RSS/Atom 订阅源文章。

快速开始

# 列出未读文章（简洁格式）
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
2. 环境变量：MINIFLUX_URL、MINIFLUX_API_KEY
3. 配置文件：~/.local/share/miniflux/config.json（首次运行时自动创建）

设置

# 选项 1：环境变量（推荐用于代理）
export MINIFLUX_URL="https://miniflux.example.org"
export MINIFLUX_API_KEY="your-api-key"

# 选项 2：命令行参数（一次性使用，会保存到配置）
uv run scripts/miniflux-cli.py --url="https://miniflux.example.org" --api-key="xxx" list

子命令

list - 列出文章

列出文章，支持可选过滤。

# 未读文章（简洁）
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 获取文章

获取单篇文章，支持内容控制。

# 完整文章
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

当内容被截断时，会显示：[...truncated, total: N chars]

mark-read - 标记为已读

标记一篇或多篇文章为已读。

# 单篇文章
uv run scripts/miniflux-cli.py mark-read 123

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

mark-unread - 标记为未读

标记一篇或多篇文章为未读。

uv run scripts/miniflux-cli.py mark-unread 123

feeds - 列出订阅源

列出所有已配置的订阅源。

# 人类可读格式
uv run scripts/miniflux-cli.py feeds

# JSON 格式
uv run scripts/miniflux-cli.py feeds --json

categories - 列出分类

列出所有分类。

uv run scripts/miniflux-cli.py categories

stats - 统计信息

显示未读计数或文章统计信息。

# 文章统计信息（字数、字符数、阅读时间）
uv run scripts/miniflux-cli.py stats --entry-id=123

# 全局各订阅源未读计数
uv run scripts/miniflux-cli.py stats

refresh - 刷新订阅源

触发订阅源刷新。

# 刷新所有订阅源
uv run scripts/miniflux-cli.py refresh --all

# 刷新特定订阅源
uv run scripts/miniflux-cli.py refresh --feed=42

search - 搜索文章

list --search 的便捷别名。

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 提供有用的错误信息：

• 凭据无效 → 检查 MINIFLUX_API_KEY
• 文章未找到 → 建议使用 list 浏览
• 缺少配置 → 显示配置文件位置
• 无结果 → 显示明确信息

标准参数

• -v, --version - 显示版本
• -q, --quiet - 抑制非错误输出
• -d, --debug - 启用调试输出
• --no-color - 禁用彩色输出
• --url=URL - Miniflux 服务器 URL
• --api-key=KEY - Miniflux API 密钥

示例

日常工作流

# 查看未读内容
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

研究模式

# 搜索特定主题
uv run scripts/miniflux-cli.py search "machine learning" --summary

# 获取完整文章内容
uv run scripts/miniflux-cli.py get 789

批量处理

# 获取所有未读文章为 JSON 格式以便处理
uv run scripts/miniflux-cli.py list --status=unread --json

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

获取任何子命令的完整帮助：

uv run scripts/miniflux-cli.py <subcommand> --help