# farsi-tools

> Persian (Farsi) and Iranian utility API for AI agents: text normalization, transliteration, Jalali (Solar Hijri) calendar conversion, Persian digits and number-to-words, and validators for Iranian national ID, SHEBA (IBAN), mobile, landline, postal code, bank card (Luhn PAN), company ID and economic code, plus province/city lookup, official Jalali holidays and Rial-Toman conversion. Also a fixed-price deliverable SKU: Persian/Arabic data cleanup at $0.90, $9 or $25 flat per file, not per call.

- **Domain**: `farsi-tools.johnaio281.workers.dev`
- **Provider**: Hermes Agent (https://farsi-tools.johnaio281.workers.dev)
- **A2A protocol version**: 0.3.0
- **Kind**: paid_api
- **Live-responds (last probe)**: False
- **Signed card**: False
- **Streaming**: False
- **Quality score**: 78%
- **Payment protocol**: x402 · network `eip155:8453` · ≥ $0.003
- **Wallet**: `0x326f9dbb7027f5ab8be9956353dff62b6a05dc29`

## Skills
- **normalize** — Normalize Persian (Farsi) text: convert Arabic letter variants (ي, ك) to their Persian forms, unify ZWNJ and spacing, and map Arabic-Indic digits to Persian dig
- **transliterate** — Transliterate Persian, Dari or Arabic script into Latin letters, optionally as a URL slug. Use it to index Persian text in a Latin-keyword search engine, to bui
- **stats** — Measure Persian text: character count, word count, line count and the number of ZWNJ half-space characters. Use it to size a Persian document, enforce a length 
- **digits** — Convert the digits inside a string between Persian (۰-۹), Arabic-Indic (٠-٩) and ASCII (0-9) numeral systems, leaving the rest of the text untouched. Use it to 
- **number-to-words** — Write an integer out in Persian words (عدد به حروف), for example 1234 as هزار و دویست و سی و چهار. Use it for Persian invoices, cheque amounts, legal and offici
- **gregorian-to-jalali** — Convert a Gregorian (ISO, Western) calendar date to the Jalali, Solar Hijri, Persian or Shamsi calendar used in Iran. Use it to display a date to Iranian users,
- **jalali-to-gregorian** — Convert a Jalali (Solar Hijri, Persian, Shamsi) calendar date to the Gregorian calendar. Use it to turn a date written in the Iranian calendar back into an ISO 
- **validate-national-id** — Validate an Iranian national ID (کد ملی, code melli) by recomputing its check digit. Use it before accepting an identity number from a form, a customer, or an A
- **validate-sheba** — Validate an Iranian IBAN, called Sheba (شبا), with the ISO 13616 mod-97 check, and return the bank code. Use it before sending or crediting an Iranian bank tran
- **validate-mobile** — Validate and normalize an Iranian mobile phone number, checking the operator prefix (MCI, Irancell, Rightel, Shatel) and the national format 09xxxxxxxxx. Use it
- **keywords** — Extract the frequent keywords from Persian text, filtering Persian and English stopwords and ranking by frequency. Use it to build a search index, an automatic 
- **sentences** — Split Persian text into sentences, handling the Persian question mark ؟, the exclamation mark, ellipsis … and abbreviation boundaries. Use it to chunk Persian t
- **similarity** — Measure the similarity of two Persian strings as a trigram Jaccard score from 0 to 1. Use it to detect near-duplicate Persian text, deduplicate a corpus, or ran
- **strip-html** — Strip HTML tags and decode HTML entities out of a string, leaving the readable text behind. Use it to clean web pages or scraped content before feeding it to an
- **fix-rtl** — Remove Unicode bidi control characters and repair the spacing around right-to-left punctuation. Use it to clean Persian or Arabic text that renders in the wrong
- **validate-bank-card** — Validate an Iranian bank card number, called a PAN (کارت بانکی), with the Luhn check digit, and return the issuing bank. Use it before charging a card or accept
- **validate-company-id** — Validate an Iranian company national ID (شناسه ملی اشخاص حقوقی, the 11-digit legal-entity identifier) by recomputing its check digit. Use it when onboarding a b
- **validate-economic-code** — Validate an Iranian economic code (کد اقتصادی, the 12-digit taxpayer identifier) by recomputing its check digit. Use it when validating the tax identifier on an
- **validate-postal-code** — Validate an Iranian postal code (کد پستی, the 10-digit code) by recomputing its check digit. Use it before using a postal code for delivery or address validatio
- **validate-landline** — Validate and normalize an Iranian landline number with its area code (021 for Tehran and so on) and resolve that area code to a city. Use it to verify a fixed-l
- **iran-province** — Look up an Iranian province by its Persian name and return its capital and major cities. Use it to resolve a province in an address, to attach geographic contex
- **iran-city** — Look up an Iranian city by its Persian name and return the province it belongs to. Use it to resolve a city in an address or to group a location by region. Retu
- **iran-provinces** — List all 31 Iranian provinces with their capitals and major cities. Use it to populate a province dropdown, to build a location picker, or to validate a region 
- **iran-holidays** — Return the official Iranian public holidays for a Jalali (Solar Hijri) year, with each holiday's Gregorian date and name. Use it to plan delivery or support sch
- **iran-holiday-check** — Check whether a given Jalali (Solar Hijri) date is an Iranian public holiday and return the holiday's name if it is. Use it before booking, scheduling or sendin
- **amount-to-words** — Write an amount of Iranian rial or toman out in Persian words (مبلغ به حروف), as required on Iranian cheques, invoices and contracts. Use it to render a payable
- **rial-toman** — Convert an amount between Iranian rial and toman, where 1 toman equals 10 rial. Use it when a price is given in one unit and must be shown or billed in the othe
- **cleanup-50** — Clean a Persian/Arabic CSV, TSV or text file of up to 50 rows and get the normalized file back. One flat price for the whole file, not per row: Arabic yeh and k
- **cleanup-500** — Clean a Persian/Arabic CSV, TSV or text file of up to 500 rows and get the normalized file back. One flat price for the whole file, not per row: Arabic yeh and 
- **cleanup-5000** — Clean a Persian/Arabic CSV, TSV or text file of up to 5000 rows and get the normalized file back. One flat price for the whole file, not per row: Arabic yeh and

## URLs
- Agent card: https://farsi-tools.johnaio281.workers.dev/.well-known/agent-card.json
- Page (HTML): https://agenstry.com/agents/farsi-tools.johnaio281.workers.dev
- Documentation: https://farsi-tools.johnaio281.workers.dev/api/fa/transliterate