Geopolitical Analyst Intelligence Framework
Analyzes any geopolitical situation using live data from 5 public APIs and 39 analytical modules. No API keys or credentials required.
What This Skill Does
- 39 analytical modules — game theory, escalation dynamics, historical patterns, sanctions analysis
- 9-step intelligence workflow — data → bias → actors → economics → networks → patterns → info warfare → red team → scenarios
- 5 live data sources — GDELT, ACLED, ReliefWeb, Frankfurter, UN Sanctions (all public, no keys)
- Multi-perspective scenarios — base case, upside, downside, catastrophic
- Confidence scoring — explicit uncertainty tracking
Usage
Setup (one time)
pip install -r requirements.txt
Interactive Mode
python3 interactive_monitor.py
Then type any country or region: Gaza, Ukraine, Taiwan, South China Sea
Command Line
python3 interactive_monitor.py "South China Sea" FULL
python3 interactive_monitor.py Ukraine BRIEF
Python API
from geopolitical_analyst_agent import run_analysis
result = run_analysis(
country="Ukraine",
keywords=["Ukraine", "Russia", "military"],
depth="FULL"
)
Files Included
| File | Purpose |
|---|---|
geopolitical_analyst_agent.py |
Core analysis engine |
interactive_monitor.py |
Interactive CLI interface |
automated_monitor.py |
Scheduled monitoring |
data_fetchers.py |
Live API data fetching |
data_sources.py |
API source definitions |
modules_loader.py |
39 analytical modules loader |
requirements.txt |
Python dependencies (requests, python-dateutil) |
references/ |
39 analytical module definitions |
Dependencies
requests>=2.28.0 — HTTP requests (standard library)python-dateutil>=2.8.2 — Date parsing (standard library)
Both are widely-used, well-maintained packages.
Data Sources (All Public, No Keys)
| API | Rate Limit | Data |
|---|---|---|
| GDELT | 250/day | News articles, sentiment |
| ACLED | 1,000/day | Conflict events, casualties |
| ReliefWeb | 100/day | Humanitarian data |
| Frankfurter | Unlimited | Currency rates |
| UN OFAC | Unlimited | Sanctions regimes |
Security
- ✅ No API keys or credentials required
- ✅ All data sources are public APIs
- ✅ No data sent to external servers
- ✅ MIT licensed, fully open source
- ✅ Local processing only
- ✅ No system file modifications