miniflux-news
Fetch and triage the latest unread RSS/news entries from a Miniflux instance via its REST API using an API token. Use when the user asks to get the latest Miniflux unread items, list recent entries with titles/links, or generate short summaries of specific Miniflux entries. Includes a bundled script to query Miniflux (/v1/entries and /v1/entries/{id}) using credentials from ~/.config/clawdbot/miniflux-news.json (or MINIFLUX_URL and MINIFLUX_TOKEN overrides).
Why use this skill?
Fetch, summarize, and manage your Miniflux RSS news feeds directly through your OpenClaw agent. Streamline your reading workflow with intelligent summaries.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/hartlco/miniflux-newsWhat This Skill Does
The Miniflux News skill provides an intelligent interface for your personal RSS feed aggregator, Miniflux. It enables an OpenClaw agent to interact directly with your server via the REST API, allowing you to fetch, organize, and process news without manually opening your browser. The skill handles the complexity of API authentication and data retrieval, converting raw JSON feed data into human-readable summaries or concise lists. By maintaining a local configuration file for secure credential storage, the agent can perform these tasks autonomously while respecting your privacy.
Installation
To add this capability to your agent, execute the installation command: clawhub install openclaw/skills/skills/hartlco/miniflux-news. After installation, you must initialize your credentials. It is recommended to use the built-in configuration helper: python3 skills/miniflux-news/scripts/miniflux.py configure --url "https://your-miniflux.example" --token "<api-token>". This creates a configuration file at ~/.config/clawdbot/miniflux-news.json. Alternatively, for ephemeral environments like CI pipelines, you can set the MINIFLUX_URL and MINIFLUX_TOKEN environment variables directly.
Use Cases
- Curated Briefings: Have the agent filter your unread news items by category and provide a summarized executive briefing of the most relevant stories.
- Content Processing: Quickly transform full-length articles into punchy, bulleted summaries that highlight the core "so what" of the piece.
- Inbox Management: Maintain a clean reading list by selectively marking specific IDs or entire categories as read once you have processed the information.
- Automated Research: Trigger the agent to poll specific categories during your morning routine to stay updated on niche tech developments or industry shifts.
Example Prompts
- "What is new in my 'Technology' category today? List the latest 10 items."
- "Summarize the top 3 unread articles from my news feed, focusing on key takeaways."
- "Mark entries 452 and 453 as read after summarizing them for me."
Tips & Limitations
- Safety First: The skill is designed with safety in mind; it will never mark items as read unless you explicitly invoke the
mark-readcommand with the--confirmflag. - Context Handling: If an article snippet is truncated, the agent is trained to rely on the title and existing metadata to provide a best-effort summary rather than hallucinating content.
- Data Privacy: All interactions happen directly between your agent and your private Miniflux instance. Ensure your API token is treated as a sensitive secret.
- Efficiency: Use the
--jsonflag when integrating with other agent tools to ensure the output remains structured and easy for secondary scripts to parse.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-hartlco-miniflux-news": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api