News Subscriptions Guide

News Subscriptions Guide

This guide covers the News Subscription system for automated research monitoring and news tracking.

Table of Contents

• Overview
• Creating Subscriptions
• Managing Subscriptions
• Update Frequency
• Subscription History
• Scheduler
• Notifications
• API Reference

Overview

News Subscriptions allow you to:

• Monitor topics with automatic periodic research
• Track search queries as living news feeds
• Get notifications when new content is found
• Organize subscriptions into folders

Access subscriptions at: http://localhost:5000/news/subscriptions

Subscription Types

Creating Subscriptions

From the Web UI

1. Navigate to News → Subscriptions
2. Click New Subscription
3. Configure your subscription:

Basic Settings

Research Settings

Submit Options

• Create & Run Now - Save and immediately execute
• Test Run - Test configuration without saving
• Create Subscription - Save for scheduled execution

From Research Results

When viewing research results, click Subscribe to create a subscription based on that query.

Managing Subscriptions

Dashboard Overview

The subscriptions dashboard shows:

Subscription Actions

Filtering & Search

• Search - Filter by name or query text
• Status - Show active, paused, or all
• Frequency - Filter by update interval
• Folder - Filter by organization folder

Folders

Organize subscriptions into folders:

1. Click Manage Folders
2. Create folders with names
3. Assign subscriptions to folders
4. Filter view by folder

Update Frequency

Preset Intervals

Custom Intervals

Set any interval between 1 hour and 30 days (in minutes).

Jitter

A small random delay (up to 5 minutes) is added to prevent all subscriptions from running simultaneously.

Subscription History

View the research history for any subscription:

1. Click on a subscription
2. Select View History

History Details

Click on any research run to view full results.

Scheduler

The scheduler runs subscriptions automatically in the background.

Scheduler Status

The status bar shows:

• Whether scheduler is running
• Number of active jobs
• Whether your subscriptions are tracked

Starting the Scheduler

The scheduler starts automatically when you log in. Your session remains active for 48 hours.

Manual Control

• Run Now - Execute any subscription immediately
• Pause - Stop a subscription temporarily
• Resume - Restart a paused subscription

Error Handling

If a subscription fails:

1. It retries with exponential backoff
2. After 10 consecutive failures, it's automatically disabled
3. You receive a notification about the error
4. You can manually resume it anytime

Notifications

Get notified when subscriptions update or encounter errors.

Notification Events

Setup

Configure notifications in Settings → Notifications:

1. Add notification service URLs (Discord, Slack, Email, etc.)
2. Enable subscription notifications
3. Test your configuration

See NOTIFICATIONS.md for supported services.

API Reference

Subscription Endpoints

Folder Endpoints

Scheduler Endpoints

Example: Create Subscription

import requests

response = requests.post(
    "http://localhost:5000/news/api/subscriptions",
    json={
        "query": "AI safety news",
        "name": "AI Safety Updates",
        "refresh_minutes": 1440,  # Daily
        "model_provider": "ollama",
        "search_engine": "auto",
        "iterations": 3
    },
    cookies={"session": your_session_cookie}
)

Troubleshooting

Subscription Not Updating

1. Check scheduler status (should be "Running")
2. Verify subscription is not paused
3. Check for errors in subscription history
4. Try "Run Now" to test manually

Too Many Updates

• Increase the update frequency (e.g., daily instead of hourly)
• Pause subscriptions you don't need actively

Missing Notifications

1. Verify notification service is configured
2. Test notification URL in settings
3. Check subscription notification events are enabled

Scheduler Not Starting

• Log out and log back in
• Check browser console for errors
• Verify server is running

See Also

• NOTIFICATIONS.md - Notification service setup
• API Quickstart - API authentication
• Features - Feature overview