| name | opml-reader |
| description | Store OPML files and fetch latest posts across RSS/Atom feeds. Use when a user provides an OPML URL or file path, wants it saved under ~/Code/Files, or wants the newest entries aggregated across feeds (with optional JSON/TSV output, dedupe, and concurrency controls). |
OPML Reader
Overview
Use scripts/opml_reader.py to (1) store OPML from a URL and (2) list the latest posts across all feeds in the OPML. Output timestamps are ISO-8601 in UTC.
Quick Start
- Create a venv and install dependency:
python3 -m venv ~/Code/sandbox/.venv-opml-reader
~/Code/sandbox/.venv-opml-reader/bin/pip install feedparser
- Store an OPML file:
~/Code/sandbox/.venv-opml-reader/bin/python scripts/opml_reader.py store \
"https://example.com/feeds.opml" \
"~/Code/Files/feeds.opml"
- Fetch latest posts:
~/Code/sandbox/.venv-opml-reader/bin/python scripts/opml_reader.py latest \
"~/Code/Files/feeds.opml" \
--limit 5
Workflow
- If the user supplies an OPML URL, store it under
~/Code/Files using store.
- If the OPML file already exists, reuse it unless the user explicitly asks to overwrite.
- Run
latest to aggregate posts and return the newest entries across feeds.
- Report partial results if some feeds fail (network timeouts are expected on large lists).
Output Options
- Default output:
text lines formatted as index. title | feed | date | link.
- Use
--format json or --format tsv if the user needs machine-readable output.
- Dedupe is on by default. Use
--no-dedupe if the user wants raw results.
- Adjust
--workers and --timeout for large or slow feed lists.
Resources
scripts/
scripts/opml_reader.py: Store OPML files and list latest posts across RSS/Atom feeds.
