Iran Intelligence Radar

---
name: Iran Intelligence Radar
description: Monitor Persian-language X (Twitter) activity related to Iran, detect high-signal geopolitical events, translate posts, score escalation risk, and generate actionable intelligence reports with optional Telegram alerts and daily briefings.
version: "1.0"
author: OpenClaw Skills
skill_id: "3092da48-a837-4288-94d6-458c6ef0b3e0"
price_per_call: "$0.02"
capabilities:
  - Persian X/Twitter monitoring
  - Keyword signal detection
  - Engagement filtering and ranking
  - Translation to English, Arabic, Chinese
  - Escalation scoring (0-100)
  - Trending narrative detection
  - Telegram alert integration
  - Daily intelligence briefing generation
inputs:
  - user_id
  - query
  - since_hours (optional)
  - custom keywords (optional)
  - custom monitored accounts (optional)
outputs:
  - ranked tweets
  - multilingual translations
  - alert classification
  - escalation score and level
  - trending signals
  - markdown intelligence report
  - optional daily briefing
tools:
  - x_keyword_search
  - x_semantic_search
  - web_search
  - translate_text
  - send_alert
  - skillpay_billing
  - telegram_api
---

# Iran Intelligence Radar

## Overview
Iran Intelligence Radar is an OSINT-focused skill for detecting meaningful geopolitical signals from Persian-language discourse on X (Twitter). It scans configured keywords and accounts, filters and ranks high-engagement posts, translates content for multilingual analysis, computes escalation risk, and outputs a structured Markdown intelligence report.

This skill is designed for journalists, OSINT teams, geopolitical analysts, and monitoring operations that need a rapid understanding of Iranian online narratives.

## Capabilities

- Monitor Persian-language tweets linked to Iran-related security, policy, and protest narratives.
- Detect high-signal content using keyword matching, engagement thresholds, and relevance ranking.
- Translate Persian posts into:
  - English (`en`)
  - Arabic (`a...

# Persian X Radar - OSINT Intelligence Radar

Persian X Radar monitors high-signal Persian content on X, translates it to English/Arabic/Chinese, detects trend spikes, computes an Iran escalation score, and sends operational alerts.

## Core Capabilities

- Persian X search with engagement thresholds and fallback tools
- Translation to `en` / `ar` / `zh`
- Trending signal detection using keyword spike ratio (`current / historical_average`)
- Iran escalation scoring (`0-100`) with LOW/MEDIUM/HIGH/CRITICAL levels
- Automatic Telegram alerting when escalation is high
- Daily 24-hour Iran intelligence briefing generation
- SkillPay billing with cooldown-based double-charge protection

## Pricing

Persian X Radar costs `$0.02` per scan.

Each scan triggers SkillPay billing.

If balance is insufficient, a payment link is returned.

## Project Structure

```text
persian-x-radar-skill/
├── README.md
├── logs/
│   ├── alerts.log
│   ├── billing.log
│   ├── escalation.log
│   └── trending.log
├── prompts/
│   └── system_prompt.md
└── skills/
    └── persian_x_radar/
        ├── __init__.py
        ├── agent.py
        ├── alerts.py
        ├── billing.py
        ├── cache.py
        ├── config.yaml
        ├── daily_briefing.py
        ├── escalation.py
        ├── search.py
        ├── telegram_alert.py
        ├── translator.py
        └── trending.py
```

## Requirements

- Python 3.10+
- PyYAML

Install:

```bash
pip install pyyaml
```

## Run

```bash
python -m skills.persian_x_radar.agent
```

Python usage:

```python
from skills.persian_x_radar.agent import PersianXRadarAgent, ToolRegistry

agent = PersianXRadarAgent(
    config_path="skills/persian_x_radar/config.yaml",
    tools=ToolRegistry(
        x_keyword_search=my_x_keyword_search,
        x_semantic_search=my_x_semantic_search,
        web_search=my_web_search,
        translate_text=my_translate_text,
        send_alert=my_send_alert,
    ),
)

result = agent.run_scan(command="run persian radar", user_id="us...