# Opml Reader

> 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).

- Skill: `majiayu000/opml-reader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/opml-reader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/opml-reader/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/opml-reader

---


# 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
1. Create a venv and install dependency:

```bash
python3 -m venv ~/Code/sandbox/.venv-opml-reader
~/Code/sandbox/.venv-opml-reader/bin/pip install feedparser
```

2. Store an OPML file:

```bash
~/Code/sandbox/.venv-opml-reader/bin/python scripts/opml_reader.py store \
  "https://example.com/feeds.opml" \
  "~/Code/Files/feeds.opml"
```

3. Fetch latest posts:

```bash
~/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.