Miniflux News

Use the bundled script to fetch entries, then format a clean list and optionally write summaries.

Setup (credentials)

This skill reads Miniflux credentials from a local config file by default.

Path:

Format:

{
  "url": "https://your-miniflux.example",
  "token": "<api-token>"
}

Create/update it using the script:

python3 skills/miniflux-news/scripts/miniflux.py configure \
  --url "https://your-miniflux.example" \
  --token "<api-token>"

You can override the config file (useful for CI):

export MINIFLUX_URL="https://your-miniflux.example"
export MINIFLUX_TOKEN="<api-token>"

Token scope: Miniflux API token with read access.

List latest unread items (default):

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 20

Filter by category (by name):

python3 skills/miniflux-news/scripts/miniflux.py entries --category "News" --limit 20

If you need machine-readable output:

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 50 --json

Return a tight bullet list: [id] title — feed + link.
Ask how many the user wants summarized (e.g., “summarize 3” or “summarize ids 123,124”).

Show the full article content stored in Miniflux (useful for reading or for better summaries):

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format text

If you want the raw HTML as stored by Miniflux:

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format html

This skill must never mark anything as read implicitly. Only do it when the user explicitly asks to mark specific ids as read.

Mark specific ids as read:

python3 skills/miniflux-news/scripts/miniflux.py mark-read 123 124 --confirm

Mark all unread entries in a category as read (still explicit, requires --confirm; includes a safety --limit):

python3 skills/miniflux-news/scripts/miniflux.py mark-read-category "News" --confirm --limit 500

Fetch full content for a specific entry id (machine-readable):

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --json

Summarization rules:

Prefer 3–6 bullets max.
Lead with the “so what” in 1 sentence.
If content is empty or truncated, say so and summarize from title + available snippet.
Don’t invent facts; quote key numbers/names if present.

If the script says missing credentials: set MINIFLUX_URL/MINIFLUX_TOKEN or create ~/.config/clawdbot/miniflux-news.json.
If you get HTTP 401: token is wrong/expired.
If you get HTTP 404: base URL is wrong (should be the Miniflux web root).