據 AlphaMoat 統計,截至 2026-09,Miniflux 累計下載 3,130 次、獲 2 個星標,在全部 5,078 個 AI 技能中排名第 3,637 位,在「知識管理」分類(442 個)中排名第 310 位。

累計安裝

232

累計下載

3130

星標

全站排名

#3,637

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

平台	累計安裝	累計下載	星標	評論
ClawHub ↗	97	2953	2	-
SkillHub ↗	232	3130	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 的文章，給我摘要

月度資料趨勢

累計下載3130

星標2

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份	累計下載	環比	星標
2026-09	3130	—	2
2026-08	2866	+2.4%	2
2026-07	2798	+7.3%	2
2026-06	2607	+4.7%	2
2026-05	2491	—	2
2026-03	2223	—	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
```