Research-only pipeline that tracks public political and policy event evidence for US equity research.
English | 简体中文
Experimental. Use at your own risk. This project is not financial advice and does not guarantee any trading result. Its outputs are research evidence, not trading instructions.
PoliticalEventTrackingResearch ingests public political and policy sources, such as free RSS feeds and official disclosures, and builds traceable research artifacts: source items, extracted events, watchlist matches, and event-study inputs. It reads only public sources and writes CSV and JSON output, so a researcher can reproduce an evidence trail for US equity context. It is aimed at research and engineering review, not at live trading.
It does not place broker orders. It does not mutate live allocations. It does not produce automatic trading instructions, and its reports are not recommendations.
Requires Python 3.11 or newer.
python -m pip install -e '.[test]'
python -m pytest -qExplore the command-line entry points (each supports --help):
petr-fetch-rss-sources --help
petr-import-official-events --help
petr-build-tracker --helpThe pipeline is configured through input files rather than environment
variables. Copy the matching file from examples/ and edit it.
| File | Required | Purpose |
|---|---|---|
config/free_rss_feeds.csv |
No | Default public RSS feed list. |
config/core_us_equity_aliases.csv |
No | Symbol and name aliases used when matching sources to tickers. |
examples/*.csv |
No | Sample inputs for local runs. |
src/ library code and command implementations
scripts/ command-line helpers
config/ default feed and alias tables
examples/ sample inputs
docs/ design notes and output contracts
tests/ unit and contract tests
See CONTRIBUTING.md.
See SECURITY.md. Do not open a public issue for a vulnerability. Keep credentials, private data, and external service tokens out of Git and logs.
MIT. See LICENSE.