← Back to Skills Marketplace
Geopolitical Analyst
by
Nima Ansari
· GitHub ↗
· v0.1.2
· MIT-0
176
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install geopolitical-analyst-skill
Description
Live geopolitical intelligence analysis with 39 analytical modules and real-time data integration. No API keys required.
README (SKILL.md)
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
Usage Guidance
Do not install or enable this skill for full use until you verify its code and provenance. Specific steps:
- Verify file consistency: SKILL.md lists many scripts (interactive_monitor.py, geopolitical_analyst_agent.py, etc.) that are missing from the manifest. Ask the publisher why those files are absent or retrieve the claimed repository to confirm the real contents.
- Inspect code: review scripts/fetch_intelligence.py and any other code for hardcoded endpoints, unknown domains, POST requests, or calls to non-listed servers. Search for suspicious patterns: requests.post to unfamiliar hosts, use of subprocess/exec, eval/compile, base64-embedded payloads, or attempts to read ~/.ssh, cloud SDK config, or environment variables.
- Confirm API requirements: check the actual public APIs (ACLED, GDELT, ReliefWeb, Frankfurter, UN OFAC) for any registration or token requirements for the endpoints the code uses; the 'no API keys required' claim may be false for some uses.
- Run in a sandbox: if you want to test, run the code in an isolated VM or container with network monitoring, and observe outbound connections on first run.
- Verify provenance: the SKILL.md references a GitHub repo; fetch that repo separately and compare contents and commit history to ensure the package wasn't tampered with.
- Prefer caution with autonomous invocation: until you audit the code, avoid enabling autonomous execution or broad permissions that would let the skill run without your review.
If you can provide the full contents of scripts/fetch_intelligence.py and any other code files, I can do a focused review to identify any explicit exfiltration or suspicious behavior and raise confidence in this assessment.
Capability Assessment
Purpose & Capability
SKILL.md claims a full analysis engine (geopolitical_analyst_agent.py, interactive_monitor.py, automated_monitor.py, modules loader, etc.) and live integration with five public APIs with 'no API keys required.' The actual manifest does NOT contain those claimed executable files — only references, docs, requirements.txt, and scripts/fetch_intelligence.py. That mismatch is incoherent. Also, one of the named sources (ACLED / some UN data offerings) historically can require registration/API tokens for certain endpoints — the blanket 'no keys required' claim is possibly inaccurate.
Instruction Scope
Runtime instructions tell the agent/user to run specific scripts (interactive_monitor.py, geopolitical_analyst_agent.py) and describe local-only processing and 'no data sent to external servers.' Because those scripts are not present in the manifest, the instructions reference files that don't exist here. The included fetch script (and any missing modules) may still make network calls; the SKILL.md's claim 'No data sent to external servers' conflicts with the declared behavior of fetching live data from public APIs and with the presence of a fetch_intelligence.py file — the actual network endpoints used must be audited.
Install Mechanism
No install spec is provided (instruction-only), and a requirements.txt lists only common Python packages (requests, python-dateutil). This is low-install-risk, but because code files exist they will be installed/run by the user environment after pip installs — review is still recommended.
Credentials
The skill declares no required environment variables or credentials, which aligns with its 'public APIs, no keys' claim. However, that claim may be inaccurate (some public data providers limit access or require tokens for bulk API use). Also, without inspecting the fetch script and any missing modules, we cannot confirm the code doesn't read environment variables or local config files — the manifest absence of many referenced files increases uncertainty.
Persistence & Privilege
The skill does not request always:true or any system-level config paths and is user-invocable only. That scope is appropriate. The main risk is standard: code may perform network I/O when invoked. Autonomous invocation is allowed by default on the platform but is not by itself a new red flag here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install geopolitical-analyst-skill - After installation, invoke the skill by name or use
/geopolitical-analyst-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.2
Version 1.1.0 introduces a simplified and more concise documentation experience.
- Streamlined the SKILL.md to focus on key features, usage, and public data sources.
- Clarified that no API keys or credentials are ever required.
- Provided quick-start setup and usage instructions for CLI and Python API.
- Summarized security assurances, dependencies, and included files.
- Removed redundant details, reducing document length and complexity.
v0.1.1
Initial public release with production-ready framework for systematic geopolitical intelligence analysis.
- Introduced skill manifest (SKILL.md) with full API, security, and installation details
- Added 39 analytical modules organized for structured geopolitical assessment
- Integrated 5 live, public data sources: GDELT, ACLED, ReliefWeb, Frankfurter, UN OFAC
- Documented installation steps, dependencies, autonomous operation, and risk assessment
- Included detailed README and reference documentation for immediate use and review
v0.1.0
- Initial release of the Geopolitical Analyst skill.
- Provides a systematic, professional framework for analyzing geopolitical events, conflicts, and scenarios.
- Integrates live data sources (GDELT, ACLED, ReliefWeb, etc.) for real-time analysis.
- Features a 9-step intelligence workflow and 39 analytical modules across foundational, strategic, and specialized domains.
- Generates probability-weighted scenarios, identifies intelligence gaps, and provides confidence-scored assessments.
- Includes CLI and Python API interfaces, error handling, and detailed documentation.
Metadata
Frequently Asked Questions
What is Geopolitical Analyst?
Live geopolitical intelligence analysis with 39 analytical modules and real-time data integration. No API keys required. It is an AI Agent Skill for Claude Code / OpenClaw, with 176 downloads so far.
How do I install Geopolitical Analyst?
Run "/install geopolitical-analyst-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Geopolitical Analyst free?
Yes, Geopolitical Analyst is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Geopolitical Analyst support?
Geopolitical Analyst is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Geopolitical Analyst?
It is built and maintained by Nima Ansari (@nimaansari); the current version is v0.1.2.
More Skills