据 AlphaMoat 统计,截至 2026-09,Miniflux 累计下载 3,130 次、获 2 个星标,在全部 5,078 个 AI 技能中排名第 3,637 位,在「知识管理」分类(442 个)中排名第 310 位。

累计安装

232

累计下载

3,130

星标

全站排名

#3,637

全站前 72% · 「知识管理」前 71%

平台	累计安装	累计下载	星标	评论
ClawHub ↗	97	2,953	2	-
SkillHub ↗	232	3,130	2	—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

该技能通过 uv 运行的 Python CLI 管理 Miniflux 服务器上的 RSS/Atom 订阅文章：list 列出文章（按状态/订阅源/分类/星标/关键词过滤）、get 按 ID 读取全文（支持 --offset/--limit 分页读取长文）、mark-read/mark-unread 批量标记已读未读、feeds/categories 列出订阅源与分类、stats 查看字数与阅读时长统计、refresh 刷新订阅、search 搜索。输出格式有 brief/summary/full/json/plain 五种；配置优先级为 CLI 参数 > 环境变量（MINIFLUX_URL/MINIFLUX_API_KEY）> 配置文件。

资料发布于 2026-10-27

可以用来做什么

快速浏览未读文章标题，再挑感兴趣的读取全文并标记已读
用 --offset/--limit 分页读取超长文章，或先看 stats 的字数与阅读时长
把全部未读文章以 JSON 导出做批量处理

什么时候用

当需要通过 Miniflux 浏览、搜索或管理 RSS/Atom 订阅文章时
当需要列出未读、读取内容、标记已读或管理订阅源/分类时
当需要灵活输出格式（标题、摘要、全文、JSON）的 CLI 访问时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

看看我有哪些未读文章，只要标题列表

把 123 这篇文章读完然后标记为已读

搜索订阅里关于 machine learning 的文章，给我摘要

月度数据趋势

累计下载3,130

星标2

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份	累计下载	环比	星标
2026-09	3,130	—	2
2026-08	2,866	+2.4%	2
2026-07	2,798	+7.3%	2
2026-06	2,607	+4.7%	2
2026-05	2,491	—	2
2026-03	2,223	—	1

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

6.3 KB · ClawHub v0.1.0

---
name: miniflux
description: "Browse, read, and manage Miniflux feed articles. Use when Claude needs to work with RSS/atom feeds via Miniflux - listing unread/new articles, reading article content, marking articles as read, and managing feeds/categories. Provides CLI access with flexible output formats (headlines, summaries, full content)."
metadata: {"clawdbot":{"emoji":"📣","requires":{"bins":["uv"]}}}
---

# Miniflux Skill

Browse, read, and manage Miniflux RSS/atom feed articles through a CLI.

展开全部(共 262 行)

## Quick Start

```bash
# List unread articles (brief format)
uv run scripts/miniflux-cli.py list --status=unread --brief

# Get article details
uv run scripts/miniflux-cli.py get 123

# Mark articles as read
uv run scripts/miniflux-cli.py mark-read 123 456

# Show article statistics (word count, reading time)
uv run scripts/miniflux-cli.py stats --entry-id=123
```

## Configuration

Configuration precedence (highest to lowest):
1. **CLI flags**: `--url`, `--api-key`
2. **Environment variables**: `MINIFLUX_URL`, `MINIFLUX_API_KEY`
3. **Config file**: `~/.local/share/miniflux/config.json` (auto-created on first run)

### Setup

```bash
# Option 1: Environment variables (recommended for agents)
export MINIFLUX_URL="https://miniflux.example.org"
export MINIFLUX_API_KEY="your-api-key"

# Option 2: CLI flags (one-time, saves to config)
uv run scripts/miniflux-cli.py --url="https://miniflux.example.org" --api-key="xxx" list
```

## Subcommands

### list - List Articles

List articles with optional filtering.

```bash
# Unread articles (brief)
uv run scripts/miniflux-cli.py list --status=unread --brief

# From specific feed with summary
uv run scripts/miniflux-cli.py list --feed=42 --summary

# Search with limit
uv run scripts/miniflux-cli.py list --search="python" --limit=10

# Starred articles
uv run scripts/miniflux-cli.py list --starred
```

**Flags:**
- `--status={read,unread,removed}` - Filter by status
- `--feed=ID` - Filter by feed ID
- `--category=ID` - Filter by category ID
- `--starred` - Show only starred
- `--search=QUERY` - Search articles
- `--limit=N` - Max number of entries
- `--offset=N` - Skip first N chars in content
- `--content-limit=N` - Max characters per article
- `-b, --brief` - Titles only
- `-s, --summary` - Title + excerpt
- `-f, --full` - Full content (default)
- `--json` - JSON output
- `--plain` - Single-line per entry

### get - Get Article by ID

Fetch a single article with content control.

```bash
# Full article
uv run scripts/miniflux-cli.py get 123

# First 2000 characters
uv run scripts/miniflux-cli.py get 123 --limit=2000

# Read from character 1000 to 2000 (pagination)
uv run scripts/miniflux-cli.py get 123 --offset=1000 --limit=1000
```

When content is truncated, shows: `[...truncated, total: N chars]`

### mark-read - Mark as Read

Mark one or more articles as read.

```bash
# Single article
uv run scripts/miniflux-cli.py mark-read 123

# Multiple articles
uv run scripts/miniflux-cli.py mark-read 123 456 789
```

### mark-unread - Mark as Unread

Mark one or more articles as unread.

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

### feeds - List Feeds

List all configured feeds.

```bash
# Human-readable
uv run scripts/miniflux-cli.py feeds

# JSON format
uv run scripts/miniflux-cli.py feeds --json
```

### categories - List Categories

List all categories.

```bash
uv run scripts/miniflux-cli.py categories
```

### stats - Statistics

Show unread counts or article statistics.

```bash
# Article statistics (word count, character count, reading time)
uv run scripts/miniflux-cli.py stats --entry-id=123

# Global unread counts per feed
uv run scripts/miniflux-cli.py stats
```

### refresh - Refresh Feeds

Trigger feed refresh.

```bash
# Refresh all feeds
uv run scripts/miniflux-cli.py refresh --all

# Refresh specific feed
uv run scripts/miniflux-cli.py refresh --feed=42
```

### search - Search Articles

Convenient alias for `list --search`.

```bash
uv run scripts/miniflux-cli.py search "rust"
uv run scripts/miniflux-cli.py search "ai" --status=unread --brief
```

## Output Formats

- `--brief` / `-b` - Quick overview (titles + feed + date)
- `--summary` / `-s` - Title + content preview (200 chars)
- `--full` / `-f` - Complete article content (default)
- `--json` - Raw JSON output for machine processing
- `--plain` - Single-line per entry (tab-separated)

## Long Article Handling

For articles with large content (e.g., >5k words):

1. **Check statistics first:**
   ```bash
   uv run scripts/miniflux-cli.py stats --entry-id=123
   ```
   Shows word count, character count, reading time.

2. **Use pagination to read in chunks:**
   ```bash
   # First 5000 chars
   uv run scripts/miniflux-cli.py get 123 --limit=5000

   # Next 5000 chars (chars 5000-10000)
   uv run scripts/miniflux-cli.py get 123 --offset=5000 --limit=5000
   ```

3. **For summarization:** If article is >5000 words, use a subagent to read and summarize:
   ```bash
   # Get stats to determine word count
   uv run scripts/miniflux-cli.py stats --entry-id=123

   # If >5000 words, delegate to subagent for summarization
   ```

## Error Handling

The CLI provides helpful error messages:

- **Invalid credentials** → Check `MINIFLUX_API_KEY`
- **Article not found** → Suggests using `list` to browse
- **Missing config** → Shows config file location
- **No results** → Clear message

## Standard Flags

- `-v, --version` - Show version
- `-q, --quiet` - Suppress non-error output
- `-d, --debug` - Enable debug output
- `--no-color` - Disable colored output
- `--url=URL` - Miniflux server URL
- `--api-key=KEY` - Miniflux API key

## Examples

### Daily Workflow

```bash
# Check what's unread
uv run scripts/miniflux-cli.py list --status=unread --brief

# Read interesting articles
uv run scripts/miniflux-cli.py get 456

# Mark as read
uv run scripts/miniflux-cli.py mark-read 456
```

### Research Mode

```bash
# Search for specific topics
uv run scripts/miniflux-cli.py search "machine learning" --summary

# Get full article content
uv run scripts/miniflux-cli.py get 789
```

### Batch Processing

```bash
# Get all unread as JSON for processing
uv run scripts/miniflux-cli.py list --status=unread --json

# Mark multiple as read
uv run scripts/miniflux-cli.py mark-read 123 456 789
```

For complete help on any subcommand:
```bash
uv run scripts/miniflux-cli.py <subcommand> --help
```