功能描述

Monitor Persian-language X (Twitter) activity related to Iran, detect high-signal geopolitical events, translate posts, score escalation risk, and generate a...

使用说明 (SKILL.md)

Iran Intelligence Radar

Name: Iran Intelligence Radar (Persian X Monitor)
Author: arthuronai

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:

Billing and cooldown check
X search and fallback retrieval
Filtering and deduplication
Translation and per-item alert classification
Trending signal detection
Escalation scoring
Alert dispatch (Telegram/channel hooks)
Markdown report generation
Optional daily briefing assembly

Example Output

Intelligence Table (sample)

#	Author	Time	Persian	English	Arabic	Chinese	Engagement	Link	Alert
1	@user123	2h ago	بحث درباره موشک...	Discussion about missiles...	نقاش حول الصواريخ...	关于导弹的讨论...	530 likes / 120 RT	https://x.com/...	HIGH
2	@iran_watch	3h ago	گزارش هایی از اعتراض...	Reports of protests...	تقارير عن احتجاجات...	有关抗议的报告...	180 likes / 42 RT	https://x.com/...	MEDIUM

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.\r

安全使用建议

Key things to check before installing or running: - Credentials: The skill expects Telegram bot_token/chat_id in skills/persian_x_radar/config.yaml (placeholders are present). Do NOT store real credentials in a checked-in config file; prefer the platform's secret store. The skill will call api.telegram.org and a SkillPay endpoint. - External network calls: billing.py contacts https://skillpay.me/api/v1 by default (overridable via SKILLPAY_BASE_URL) and telegram_alert.py posts to the Telegram API. If you run this in your environment, those external services will receive data (e.g., user_id and billing requests). Review privacy implications. - Tools integration: The code expects the host to supply search/translate functions (ToolRegistry). If you do not provide real X search/translate tools, the skill will use deterministic mock data. Confirm how you'll supply these connectors and their credentials (Twitter/X API or other crawlers). - Files written to disk: The skill writes logs and JSON history files under the project root/logs and skill folders. Ensure the runtime directory is appropriate and that logs/history will not leak sensitive data. - Prompt content: The skill ships a system prompt file which affects agent behavior. Review prompts/system_prompt.md to ensure it does not contain instructions you do not want the agent to follow. - Operational & legal caution: This skill monitors politically sensitive content related to Iran. Ensure you have legal/ethical authority to collect/process this data and consider operational security for running monitoring tools. If you decide to proceed: run the skill in an isolated/sandboxed environment, remove or replace placeholder tokens in config.yaml with platform-managed secrets, and provide vetted connector implementations for X search and translation rather than embedding credentials in repository files.

功能分析

Type: OpenClaw Skill Name: iran-intelligence-radar Version: 1.0.0 The Iran Intelligence Radar is a well-structured OSINT tool designed to monitor Persian-language activity on X (Twitter) for geopolitical events. It features automated keyword detection, escalation scoring, multi-language translation, and Telegram alerting. The code logic in agent.py and search.py is consistent with the stated purpose in SKILL.md. While it includes network capabilities for billing (skillpay.me) and notifications (api.telegram.org), these are transparently documented and used for their intended functions. No evidence of data exfiltration, malicious execution, or prompt injection was found.

能力评估

ℹ Purpose & Capability

Name, description, and code match: the package implements Persian X/Twitter search, translation, trending detection, escalation scoring, Telegram alerts, and billing. Minor inconsistency: SKILL.md/tools list includes 'skillpay_billing' and 'telegram_api' as external tools, but the code implements billing internally (billing.py) and calls telegram via telegram_alert.py (it does not accept a 'telegram_api' tool function). The agent expects host-provided search/translate tool functions (ToolRegistry) — which is coherent but should be noted: without those tools the skill falls back to deterministic mock data.

ℹ Instruction Scope

SKILL.md and prompts/system_prompt.md describe scanning, translating, scoring, and alerting — and the code follows that flow. The runtime will perform outbound HTTP calls (SkillPay billing and Telegram API) and write logs/state files to disk. The pre-scan detected a 'system-prompt-override' pattern (the skill ships a system_prompt.md to drive behavior), which is expected for an agent but is something to review because system prompts can alter agent behavior.

✓ Install Mechanism

No install spec; code is instruction + Python files with a minimal requirements.txt (pyyaml, requests, python-dateutil). No network-download/install step in the manifest. Risk from install is low, but running the code will write files and make network calls.

⚠ Credentials

The registry metadata declares no required environment variables, but the shipped config.yaml expects sensitive values (telegram.bot_token, telegram.chat_id) to be placed in the skill config file. Billing code also honors SKILLPAY_BASE_URL via environment. The mismatch (no declared secrets vs. actual config requiring secrets) is concerning: it encourages putting credentials in a repo file instead of a secured platform secret, and the skill will transmit user_id and billing requests to external endpoints.

ℹ Persistence & Privilege

always:false (good). The skill creates/writes logs and state files (logs/, charge_cache.json, trending_history.json, daily_history.json) under the project root and skill directories. This is expected for local persistence, but it means the skill will store histories and potentially sensitive outputs on disk — check where these files will live in your environment.

版本历史

v1.0.0

Initial release of Iran Intelligence Radar. - Monitors Persian-language X (Twitter) activity for Iran-related geopolitical signals. - Detects, ranks, and translates high-engagement tweets with focus on security, policy, and protest keywords. - Calculates escalation risk scores (0–100) and classifies alert levels (LOW to CRITICAL). - Supports Telegram alert integration and generates daily intelligence briefings. - Provides multilingual translations (English, Arabic, Chinese) and outputs structured Markdown intelligence reports. - Skill is billed per scan ($0.02) with cooldown and optional payment link on insufficient balance.

元数据

Slug iran-intelligence-radar

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题