Skip to content

arc-claw-bot/openclaw-feeds

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Feeds

RSS news aggregator skill. Fetches headlines from curated feeds across three categories — news, games, finance. Concurrent fetching, structured JSON output. No API key needed.

GitHub Version License


How It Works

  1. Pick a category — news, games, or finance
  2. Concurrent feed fetching — all RSS feeds for that category fetched in parallel (15s timeout per feed)
  3. Streamed output — results print as a JSON array, one element per entry

One call returns all current entries from every feed in the selected category.


Install

1. Clone

git clone https://github.com/arc-claw-bot/openclaw-feeds.git ~/.openclaw/skills/feeds

2. Install feedparser

feedparser is the only dependency.

pip install --user feedparser

# Or if you use pip3 explicitly
pip3 install --user feedparser

Verify it's importable:

python3 -c "import feedparser; print('ok')"

3. Run

python3 ~/.openclaw/skills/feeds/scripts/feeds.py --category news

Categories

news — General news (21 feeds)

Tech, science, culture, essays. Sources include Ars Technica, Wired, TechCrunch, The Verge, NYT, Heise, Quanta Magazine, Aeon, Nautilus, and more.

python3 scripts/feeds.py --category news

games — Gaming news (10 feeds)

German and US gaming press. Sources include GameStar, GamesGlobal, PC Gamer, Polygon, Kotaku, IGN, Rock Paper Shotgun, GamesIndustry.biz.

python3 scripts/feeds.py --category games

finance — Finance & markets (26 feeds)

Markets, business, economy, crypto, central banks. Sources include Bloomberg, WSJ, FT, CNBC, MarketWatch, Seeking Alpha, The Economist, Forbes, CoinDesk, Fed, ECB.

python3 scripts/feeds.py --category finance

Output Format

Streamed JSON array — first element is metadata, rest are entries:

[{"category": "news", "total_entries": 142, "sources": ["aeon.co", "arstechnica.com", ...], "fetched_at": "2026-01-31 22:00:00"}
,{"title": "Headline Here", "url": "https://...", "source": "arstechnica.com", "date": "Fri, 31 Jan 2026 ...", "summary": "Brief summary text..."}
,{"title": "Another Headline", "url": "https://...", "source": "wired.com", "date": "...", "summary": "..."}
]

Entry Fields

Field Description
title Headline text
url Link to full article
source Domain name of the feed source
date Publication date (as provided by the feed)
summary Brief summary/description (HTML stripped, max 500 chars)

CLI Reference

Flag Description
-c, --category Feed category: news, games, or finance (required)

FAQ & Troubleshooting

Q: Do I need an API key?

No. This skill reads public RSS feeds directly.

Q: Why are some entries missing summaries?

Some feeds don't include summary/description fields. The entry will still have title, URL, and source.

Q: Can I add my own feeds?

Edit scripts/lists.py — three lists: NEWS_FEEDS, GAMES_FEEDS, FINANCE_FEEDS.

Error: "feedparser is required but not installed"

pip install --user feedparser
# Then verify: python3 -c "import feedparser; print('ok')"

License

MIT


Links

  • GitHub — Source code & issues

About

RSS feed aggregator and content processor for OpenClaw agents. Multi-source news and data feeds with smart filtering and summarization.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors