miniflux-news

# 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. ### Config file (recommended) Path: - `~/.config/clawdbot/miniflux-news.json` Format: ```json { "url": "https://your-miniflux.example", "token": "<api-token>" } ``` Create/update it using the script: ```bash python3 skills/miniflux-news/scripts/miniflux.py configure \ --url "https://your-miniflux.example" \ --token "<api-token>" ``` ### Environment variables (override) You can override the config file (useful for CI): ```bash export MINIFLUX_URL="https://your-miniflux.example" export MINIFLUX_TOKEN="<api-token>" ``` Token scope: Miniflux API token with read access. ## Fetch latest entries List latest unread items (default): ```bash python3 skills/miniflux-news/scripts/miniflux.py entries --limit 20 ``` Filter by category (by name): ```bash python3 skills/miniflux-news/scripts/miniflux.py entries --category "News" --limit 20 ``` If you need machine-readable output: ```bash python3 skills/miniflux-news/scripts/miniflux.py entries --limit 50 --json ``` ### Response formatting - 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”). ## View full content Show the full article content stored in Miniflux (useful for reading or for better summaries): ```bash python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format text ``` If you want the raw HTML as stored by Miniflux: ```bash python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format html ``` ## Categories List categories: ```bash python3 skills/miniflux-news/scripts/miniflux.py categories ``` ## Mark entries as read (explicit only) 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: ```bash 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`): ```bash python3 skills/miniflux-news/scripts/miniflux.py mark-read-category "News" --confirm --limit 500 ``` ## Summarize entries Fetch full content for a specific entry id (machine-readable): ```bash 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. ## Troubleshooting - 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).