Query headlines and articles from a self-hosted FreshRSS instance. Use when the user asks for RSS news, latest headlines, feed updates, or wants to browse articles from their FreshRSS reader. Supports filtering by category, time range, and count.
Query headlines from a self-hosted FreshRSS instance via the Google Reader compatible API.
Set these environment variables:
export FRESHRSS_URL="https://your-freshrss-instance.com"
export FRESHRSS_USER="your-username"
export FRESHRSS_API_PASSWORD="your-api-password"
API password is set in FreshRSS → Settings → Profile → API Management.
{baseDir}/scripts/freshrss.sh headlines --count 10
{baseDir}/scripts/freshrss.sh headlines --hours 2
{baseDir}/scripts/freshrss.sh headlines --category "Technology" --count 15
{baseDir}/scripts/freshrss.sh headlines --unread --count 20
{baseDir}/scripts/freshrss.sh headlines --category "News" --hours 4 --count 10 --unread
{baseDir}/scripts/freshrss.sh categories
{baseDir}/scripts/freshrss.sh feeds
Headlines are formatted as:
[date] [source] Title
URL
Categories: cat1, cat2
--hours for relative time (e.g., last 2 hours)categories command first to see available category names