iran-intelligence-radar（伊朗情报雷达）

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 (ar) - Chinese (zh)

• Classify tweet-level alert intensity (LOW, MEDIUM, HIGH).
• Detect trend spikes using keyword volume ratio (current_count / historical_average).
• Compute an Iran escalation score (0-100) with severity levels:

- LOW (0-30) - MEDIUM (31-60) - HIGH (61-80) - CRITICAL (81-100)

• Trigger automatic Telegram alerts when escalation conditions are met.
• Generate daily 24-hour intelligence briefings.

Default high-priority keywords include:

• حمله
• موشک
• تحریم
• غنی سازی
• اعتراض
• زن زندگی آزادی
• هسته ای

Invocation

Use any of the following command patterns:

• run persian radar
• scan iran tweets
• monitor iran signals

Programmatic entrypoint:

from skills.persian_x_radar.agent import run_radar

result = run_radar(
    user_id="demo_user",
    query="run persian radar",
    since_hours=6,
)

Typical execution flow:

1. Billing and cooldown check
2. X search and fallback retrieval
3. Filtering and deduplication
4. Translation and per-item alert classification
5. Trending signal detection
6. Escalation scoring
7. Alert dispatch (Telegram/channel hooks)
8. Markdown report generation
9. Optional daily briefing assembly

Example Output

Intelligence Table (sample)

Radar Summary (sample)

• Escalation score: 72 (HIGH)
• Top signal: missile discussion spike
• Trending signals:

1. موشک spike detected 2. اعتراض volume increase

Pricing

• Skill ID: 3092da48-a837-4288-94d6-458c6ef0b3e0
• Price per call: $0.02
• Billing provider: SkillPay

Billing behavior:

• Each scan call is billable.
• Cooldown protection avoids duplicate charges within configured window.
• If balance is insufficient, the skill returns a payment link response:

{
  "status": "payment_required",
  "message": "Insufficient balance to run Persian X Radar.",
  "price": 0.02,
  "payment_link": "https://skillpay.me/pay/..."
}

Use Cases

• Real-time monitoring of missile, nuclear, sanctions, or protest narratives.
• Editorial intelligence support for breaking Iran-related developments.
• Geopolitical risk escalation tracking for operations/security teams.
• Multilingual situational awareness for non-Persian analysts.
• Daily strategic briefing generation from rolling social signal history.

Configuration

Primary configuration file:

• skills/persian_x_radar/config.yaml

Key sections:

• monitoring

- default_since_hours - heartbeat_minutes - keywords - accounts

• thresholds

- min_faves - min_retweets

• translation

- languages (en, ar, zh)

• trending

- spike_threshold - min_volume - keywords

• alerts

- channel and engagement thresholds

• telegram

- enabled - bot_token - chat_id

• billing

- skill_id - price_per_call - charge_cooldown_minutes

Common customization commands:

• Add keyword: add keyword "سپاه"
• Monitor account: monitor account @BBCPersian
• Change thresholds: change alert threshold retweets > 200

This skill is suitable for deployment in AI skill marketplaces and agent orchestration platforms requiring deterministic billing, structured outputs, and operational alerting.