Skip to main content

Quick Start

Short task-oriented paths to first success. Not sure where to start? Pick your role and goal in the cookbook.

HTML page → RSS in 30 seconds​

pip install newsworker
newsworker extract "https://www.eib.org/en/index.htm" --format rss

Save it to a file:

newsworker extract "https://example.com/news" --format rss --output feed.xml

Discover feeds a site already publishes​

newsworker scan "https://www.dta.gov.au/news/" --format opml --output feeds.opml

Analyze once, extract fast​

newsworker analyze "https://example.com/news" -o example.yaml
newsworker extract "https://example.com/news" --spec example.yaml --format rss

Serve a page as a live feed​

newsworker serve --port 8787

Then subscribe in a reader:

http://127.0.0.1:8787/feed?url=https%3A%2F%2Fexample.com%2Fnews&format=atom

Use it from Python​

from newsworker.service import FeedService
from newsworker.formats import format_feed

service = FeedService()
feed = service.get_feed("https://www.eib.org/en/index.htm")
print(format_feed(feed, fmt="rss"))

Next steps​