Goal: push the newest posts about your topic into Telegram.
- Python 3.10+ recommended.
pip install -r requirements.txt- Copy
.env.example→.envand fill tokens. - Edit
sources.yaml(enable/disable sources, add users/feeds/keywords). - Run:
python main.py
- Twitter/X: Requires a paid API v2 token. Set
TWITTER_BEARER_TOKENand enable insources.yaml. - Facebook: Use a Page access token (long-lived) if possible. Put it in
FB_ACCESS_TOKENand enable. - Truth Social: There is no stable public API. If your account/server is Mastodon-compatible and you have an access token, set
MASTODON_BASE_URLandMASTODON_ACCESS_TOKENand try enabling. This may or may not work. - Reuters/Bloomberg/aggregators: Use their RSS feeds with keyword filters. Add the exact RSS URLs you need.
Uses a SQLite DB (data.db) to store seen IDs and since_ids (per source). Safe to restart.
Respect each platform's Terms of Service and developer policies. This repo avoids scraping.