skills.rest
ehsanghaffar
ehsanghaffarCOMMUNITY
Explore all skills by this author →
Website𝕏@ehsanghaffarGitHub

iran-finance-markets-monitor

Collects and validates Iranian FX, gold, and crypto market data into Persian reports.

7|Updated Sep 19, 2026
Search Tags:#web scraping#market monitoring#crypto prices#iran market#tgju#usdt toman#persian report
One-click install
npx skills add https://github.com/ehsanghaffar/skills --skill iran-finance-markets-monitor-ehsanghaffar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: iran-finance-markets-monitor
Source: https://github.com/ehsanghaffar/skills/tree/main/skills/iran-finance-markets-monitor
Command: npx skills add https://github.com/ehsanghaffar/skills --skill iran-finance-markets-monitor-ehsanghaffar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jdatetime, requests, beautifulsoup4, feedparser, and includes scripts (resource) and references (resource) components.

What problem does it solve? Gathering Iranian market data (free USD, EUR, AED, gold, Emami coin, USDT/Toman) alongside crypto prices requires scraping TGJU, calling multiple APIs, handling Persian digits, and converting Rial to Toman correctly. This Skill automates that collection with provenance tracking so no value is ever invented and every source failure is reported explicitly. ## Core Features & Use Cases - Multi-source collection: Fetches CoinGecko prices, Fear & Greed index, TGJU FX/gold tables, and cross-exchange USDT quotes from Nobitex, Wallex, and Bitpin with bounded retries. - Validation gates: Applies range checks, Jalali-date freshness rejection, Rial-to-Toman conversion exactly once, and 0.5% spread reconciliation across exchanges; failed values stay null with structured errors. - Persian report generation: Fills a bundled Persian template with Jalali dates, Tehran timestamps, up to three sourced headlines, and a neutral market summary. - Use Case: Ask for today's Iranian market snapshot and receive a Persian report showing USD/Toman, gold, BTC, and Fear & Greed, with any unavailable data marked as — and source failures listed. ## Quick Start Ask the assistant to collect today's Iranian market snapshot and write a neutral Persian report including USD, gold, USDT, BTC, and the Fear & Greed index.

Frequently Asked Questions about iran-finance-markets-monitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I collect Iranian market prices like USD/Toman and gold in Python?▼

Run the bundled iran_market_watcher.py script after installing requirements.txt. It scrapes TGJU tables for free USD, EUR, AED, 18K gold, and Emami coin, converts Rial to Toman, and emits a dated JSON snapshot with sources and errors.

How to scrape TGJU tables with Persian digits and labels?▼

Use normalize_digits to convert Persian and Arabic numerals to ASCII, then match rows by exact first-cell labels like دلار or طلای 18 عیار within a specific table index. Never use bare keyword matching, since table 14 contains multiple currencies.

Does the Iran market monitor work without network access?▼

Live collection requires network access and the installed dependencies. In offline environments you can still run the pytest suite and pure helpers like parse_number and rial_to_toman, but you must not claim live prices were collected.

Why are some values null in the market snapshot JSON?▼

Null values indicate a source failure, range rejection, or stale data; the skill never substitutes guessed or stale values. Each failure is recorded in the errors or warnings array with the source, type, and detail.

How is the USDT/Toman price validated across Iranian exchanges?▼

The watcher reads Nobitex, Wallex, and Bitpin quotes from TGJU table 33, requires each quote's buy/sell spread to be at most 0.5%, and rejects the result if cross-exchange dispersion exceeds 0.5%. Valid quotes are averaged and converted from Rial to Toman.

Related Skills

Explore More Finance & Accounting Skills→
tangzheng202202tangzheng202202
1

wechat-rss-collector

Collect WeChat public account articles via RSSHub and publish markdown to Feishu Docs.

Community
Intermediate
JansenAnalyticsJansenAnalytics
5

rss-digest

Automate RSS/Atom feed subscriptions, keyword filters, and Telegram digests.

Community
Intermediate
darkounus90darkounus90
1

technical-analyst

Analyze weekly price charts and generate a technical analysis report.

Community
Advanced
AuniikAuniik

dse-ai

Fetch Dhaka Stock Exchange data from dsebd.org via CLI with JSON/Markdown/TOON outputs.

Community
Advanced