the-old-reader

name	the-old-reader
description	Fetches news articles from The Old Reader service. Use this skill to log in to your The Old Reader account and retrieve news from your subscriptions.

The Old Reader - RSS News Reader

This skill allows you to interact with The Old Reader API to fetch news articles from your subscriptions.

Core Tool

The primary tool for this skill is the the-old-reader-client.py Python script located in the scripts/ directory.

1. Login

Before you can use this skill, you need to log in to your The Old Reader account. This will store an authentication token on your local machine at ~/.the-old-reader-token.

Usage:

python scripts/the-old-reader-client.py login --email YOUR_EMAIL --password YOUR_PASSWORD

Replace YOUR_EMAIL and YOUR_PASSWORD with your The Old Reader credentials.

2. List Subscriptions

Once you are logged in, you can list your subscriptions. This will give you a list of all your feeds and their stream_ids, which you will need to fetch articles.

Usage:

python scripts/the-old-reader-client.py subscriptions

3. Fetch Items

After you have the stream_id for a subscription, you can fetch its items (articles).

Usage:

python scripts/the-old-reader-client.py items --stream-id STREAM_ID

Replace STREAM_ID with the id from the output of the subscriptions command (e.g., feed/1234567890abcdef).

You can also specify the number of items to fetch with the --limit flag and fetch only unread items with the --unread flag.

Example:

python scripts/the-old-reader-client.py items --stream-id feed/1234567890abcdef --limit 10 --unread

API Reference

For more details on The Old Reader API, refer to the API Reference.