miniflux

# Miniflux Skill

Manage Miniflux - Modern minimalist feed reader via REST API.

Use for listing feeds and entries, creating/removing subscriptions, searching articles, managing categories, and marking entries as read/unread.

## Setup

This skill requires Python and the Miniflux Python client.

```bash
# Install the miniflux Python package
uv pip install miniflux
```

## Configuration

Set the following environment variables:

```bash
export MINIFLUX_URL="https://your-miniflux-instance.com"
export MINIFLUX_TOKEN="your-api-token-here"
```

To get an API token:
1. Log in to your Miniflux instance
2. Go to Settings > API Keys
3. Click "Create a new API key"
4. Copy the token and set it in MINIFLUX_TOKEN

## Usage

### CLI Wrapper

```bash
# List all feeds
bash miniflux.sh feeds

# List categories
bash miniflux.sh categories

# Get unread entries
bash miniflux.sh entries --status unread

# Search entries
bash miniflux.sh entries --search "kubernetes"

# Create a new feed
bash miniflux.sh create-feed --url "https://example.com/feed.xml" --category 1

# Refresh all feeds
bash miniflux.sh refresh-all

# Mark entries as read
bash miniflux.sh mark-read --entry-ids 123,456

# Mark feed as read
bash miniflux.sh mark-feed-read --feed-id 42

# Toggle bookmark/star
bash miniflux.sh toggle-bookmark --entry-id 123

# Discover subscriptions from a website
bash miniflux.sh discover --url "https://example.org"

# Delete a feed
bash miniflux.sh delete-feed --feed-id 42

# Get feed details
bash miniflux.sh feed --feed-id 42

# Get counters (unread/read)
bash miniflux.sh counters

# Get current user info
bash miniflux.sh me

# Get specific entry
bash miniflux.sh entry --entry-id 123

# Create category
bash miniflux.sh create-category --title "Tech News"

# Delete category
bash miniflux.sh delete-category --category-id 5

# Update feed
bash miniflux.sh update-feed --feed-id 42 --title "New Title" --category-id 3
```

## Commands Reference

| Command | Description |
|---------|-----------...

# Miniflux Skill for OpenClaw

Manage Miniflux - Modern minimalist feed reader via REST API.

## Overview

This skill provides a CLI interface to Miniflux, allowing you to:
- List feeds and entries
- Create/remove/update subscriptions
- Search and read articles
- Manage categories
- Mark entries as read/unread
- Discover new subscriptions

## Installation

1. Install the Python Miniflux client:

```bash
python3 -m pip install --user --break-system-packages miniflux
```

Or using uv (recommended):

```bash
uv pip install --system miniflux
```

2. Set up environment variables:

```bash
export MINIFLUX_URL="https://reader.etereo.cloud"
export MINIFLUX_TOKEN="your-api-token-here"
```

To get an API token:
- Log in to your Miniflux instance
- Go to Settings > API Keys
- Click "Create a new API key"
- Copy the token

## Usage

### Basic Commands

```bash
# List all feeds
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh feeds

# List categories
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh categories

# Get unread entries (last 10)
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh entries --status unread --limit 10

# Search for articles
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh entries --search "kubernetes"

# Get current user info
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh me

# Get counters
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh counters
```

### Feed Management

```bash
# Create a new feed
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh create-feed --url "https://example.com/feed.xml" --category 1

# Update a feed
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh update-feed --feed-id 42 --title "New Title" --category 3

# Delete a feed
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh delete-feed --feed-id 42

# Refresh all feeds
bash /home/moltbot/clawd/skills/miniflux/scripts/miniflux.sh refresh-all

# Refresh a specific feed
bash /home...