A curated registry of blockchain protocol RSS feeds.
scripts/protocols.ts is the source of truth. It defines ~30 protocols with typed feed sources:
- Blog - Official protocol blogs
- Releases - GitHub release feeds (auto-generated from
org/repo) - Forum - Development/research forums (Discourse)
- Governance - Governance forums and proposals
- Security - Security research and audits
- Research - Academic/technical research
feeds.opml is generated from the registry and can be imported into any RSS reader (Inoreader, Feedly, etc.).
Resolves feeds from the protocol registry, diffs against current OPML, and optionally uses Brave Search to find feeds for protocols with missing URLs.
bun run discover-feeds # registry resolution + diff report
bun run discover-feeds -- --verify # + verify each feed URL is alive
bun run discover-feeds -- --verify --write # + write feeds.opmlShortcut to regenerate feeds.opml from the registry:
bun run generate-opmlChecks all feeds in feeds.opml for availability and staleness:
bun run check-feedsAuto-detect RSS feeds from a protocol's homepage:
bun run probe-feeds -- https://ethereum.org https://uniswap.orgTwo GitHub Actions workflows run weekly (Monday 09:00 UTC):
- Feed Health Check - Checks feed availability, auto-removes dead feeds via PR
- Feed Discovery - Resolves registry, verifies feeds, updates OPML via PR
Results are posted as GitHub Issues with labels feed-health and feed-discovery.
bun install
cp .env.example .env # Set BRAVE_SEARCH_API_KEY for Brave Search complement| Variable | Where | Purpose |
|---|---|---|
BRAVE_SEARCH_API_KEY |
GitHub Secrets | Brave Search complement in feed discovery |