farsi-tools

{
  "name": "farsi-tools",
  "description": "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.",
  "version": "1.0.0",
  "url": "https://farsi-tools.johnaio281.workers.dev",
  "protocolVersion": "0.3.0",
  "preferredTransport": "JSONRPC",
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "provider": {
    "organization": "Hermes Agent",
    "url": "https://farsi-tools.johnaio281.workers.dev"
  },
  "payments": [
    {
      "rail": "x402",
      "network": "eip155:8453",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "assetSymbol": "USDC",
      "payTo": "0x326F9DBB7027F5aB8be9956353dFF62b6a05Dc29"
    },
    {
      "rail": "mpp",
      "network": "eip155:4217",
      "asset": "0x20c000000000000000000000b9537d11c60E8b50",
      "assetSymbol": "USDC",
      "payTo": "0x326F9DBB7027F5aB8be9956353dFF62b6a05Dc29"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "skills": [
    {
      "id": "normalize",
      "name": "normalize",
      "description": "Normalize Persian (Farsi) text: convert Arabic letter variants (\u064a, \u0643) to their Persian forms, unify ZWNJ and spacing, and map Arabic-Indic digits to Persian digits. Use it before indexing, searching or comparing Persian text so that lookalike spellings match. Returns the normalized string.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/normalize"
      ]
    },
    {
      "id": "transliterate",
      "name": "transliterate",
      "description": "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 build slugs for Persian titles, or to render Persian names in a Latin-only system. Returns the Latin transliteration and, when asked, the slug.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/transliterate"
      ]
    },
    {
      "id": "stats",
      "name": "stats",
      "description": "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 limit, or report text statistics for Persian content. Returns a stats object.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/stats"
      ]
    },
    {
      "id": "digits",
      "name": "digits",
      "description": "Convert the digits inside a string between Persian (\u06f0-\u06f9), Arabic-Indic (\u0660-\u0669) and ASCII (0-9) numeral systems, leaving the rest of the text untouched. Use it to make Persian text machine-readable or to render an ASCII number in Persian script. Returns the converted string.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/digits"
      ]
    },
    {
      "id": "number-to-words",
      "name": "number-to-words",
      "description": "Write an integer out in Persian words (\u0639\u062f\u062f \u0628\u0647 \u062d\u0631\u0648\u0641), for example 1234 as \u0647\u0632\u0627\u0631 \u0648 \u062f\u0648\u06cc\u0633\u062a \u0648 \u0633\u06cc \u0648 \u0686\u0647\u0627\u0631. Use it for Persian invoices, cheque amounts, legal and official forms, and display. Returns the number spelled in Persian words.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/number-to-words"
      ]
    },
    {
      "id": "gregorian-to-jalali",
      "name": "gregorian-to-jalali",
      "description": "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, to schedule work in the Iranian calendar, or to convert a Gregorian deadline into a Jalali date. Returns the Jalali year, month, day and month name.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/gregorian-to-jalali"
      ]
    },
    {
      "id": "jalali-to-gregorian",
      "name": "jalali-to-gregorian",
      "description": "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 8601 date, to check whether a Jalali date is today, or to compare an Iranian deadline with a Western one. Returns the Gregorian year, month, day and weekday.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/jalali-to-gregorian"
      ]
    },
    {
      "id": "validate-national-id",
      "name": "validate-national-id",
      "description": "Validate an Iranian national ID (\u06a9\u062f \u0645\u0644\u06cc, code melli) by recomputing its check digit. Use it before accepting an identity number from a form, a customer, or an API payload. Returns whether the number is valid, and the parsed digits.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-national-id"
      ]
    },
    {
      "id": "validate-sheba",
      "name": "validate-sheba",
      "description": "Validate an Iranian IBAN, called Sheba (\u0634\u0628\u0627), with the ISO 13616 mod-97 check, and return the bank code. Use it before sending or crediting an Iranian bank transfer. Returns validity, the normalized IBAN and the bank identifier.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-sheba"
      ]
    },
    {
      "id": "validate-mobile",
      "name": "validate-mobile",
      "description": "Validate and normalize an Iranian mobile phone number, checking the operator prefix (MCI, Irancell, Rightel, Shatel) and the national format 09xxxxxxxxx. Use it to verify a phone number on a sign-up form or before sending an SMS. Returns validity, the normalized number and the operator.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-mobile"
      ]
    },
    {
      "id": "keywords",
      "name": "keywords",
      "description": "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 tag list, or a topic summary for a Persian document. Returns the ranked keywords.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/keywords"
      ]
    },
    {
      "id": "sentences",
      "name": "sentences",
      "description": "Split Persian text into sentences, handling the Persian question mark \u061f, the exclamation mark, ellipsis \u2026 and abbreviation boundaries. Use it to chunk Persian text for summarization, translation or per-sentence processing. Returns the list of sentences.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/sentences"
      ]
    },
    {
      "id": "similarity",
      "name": "similarity",
      "description": "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 rank one Persian string against another. Returns the similarity score.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/similarity"
      ]
    },
    {
      "id": "strip-html",
      "name": "strip-html",
      "description": "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 agent or an index. Returns the plain text.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/strip-html"
      ]
    },
    {
      "id": "fix-rtl",
      "name": "fix-rtl",
      "description": "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 order or shows stray markers. Returns the cleaned string.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/fix-rtl"
      ]
    },
    {
      "id": "validate-bank-card",
      "name": "validate-bank-card",
      "description": "Validate an Iranian bank card number, called a PAN (\u06a9\u0627\u0631\u062a \u0628\u0627\u0646\u06a9\u06cc), with the Luhn check digit, and return the issuing bank. Use it before charging a card or accepting card details from a customer. Returns validity, the masked number and the bank name.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-bank-card"
      ]
    },
    {
      "id": "validate-company-id",
      "name": "validate-company-id",
      "description": "Validate an Iranian company national ID (\u0634\u0646\u0627\u0633\u0647 \u0645\u0644\u06cc \u0627\u0634\u062e\u0627\u0635 \u062d\u0642\u0648\u0642\u06cc, the 11-digit legal-entity identifier) by recomputing its check digit. Use it when onboarding a business customer or validating an Iranian legal entity. Returns validity and the parsed digits.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-company-id"
      ]
    },
    {
      "id": "validate-economic-code",
      "name": "validate-economic-code",
      "description": "Validate an Iranian economic code (\u06a9\u062f \u0627\u0642\u062a\u0635\u0627\u062f\u06cc, the 12-digit taxpayer identifier) by recomputing its check digit. Use it when validating the tax identifier on an Iranian invoice or a supplier record. Returns validity and the parsed digits.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-economic-code"
      ]
    },
    {
      "id": "validate-postal-code",
      "name": "validate-postal-code",
      "description": "Validate an Iranian postal code (\u06a9\u062f \u067e\u0633\u062a\u06cc, the 10-digit code) by recomputing its check digit. Use it before using a postal code for delivery or address validation. Returns validity, the normalized code and its province.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-postal-code"
      ]
    },
    {
      "id": "validate-landline",
      "name": "validate-landline",
      "description": "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-line contact or to route a support request to the right region. Returns validity, the normalized number, the area code and the city.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/validate-landline"
      ]
    },
    {
      "id": "iran-province",
      "name": "iran-province",
      "description": "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 context to a user, or to normalize a location field. Returns the province, its capital and its cities.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/iran-province"
      ]
    },
    {
      "id": "iran-city",
      "name": "iran-city",
      "description": "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. Returns the city and its province.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/iran-city"
      ]
    },
    {
      "id": "iran-provinces",
      "name": "iran-provinces",
      "description": "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 name. Returns every province.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/iran-provinces"
      ]
    },
    {
      "id": "iran-holidays",
      "name": "iran-holidays",
      "description": "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 schedules around Iranian holidays, or to flag non-working days. Returns the holiday list.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/iran-holidays"
      ]
    },
    {
      "id": "iran-holiday-check",
      "name": "iran-holiday-check",
      "description": "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 sending a deadline-sensitive action on an Iranian working day. Returns whether it is a holiday and which one.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/iran-holiday-check"
      ]
    },
    {
      "id": "amount-to-words",
      "name": "amount-to-words",
      "description": "Write an amount of Iranian rial or toman out in Persian words (\u0645\u0628\u0644\u063a \u0628\u0647 \u062d\u0631\u0648\u0641), as required on Iranian cheques, invoices and contracts. Use it to render a payable amount for a Persian-speaking payer. Returns the amount spelled in Persian words with its unit.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/amount-to-words"
      ]
    },
    {
      "id": "rial-toman",
      "name": "rial-toman",
      "description": "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 other. Returns the converted amount.",
      "tags": [
        "paid",
        "persian",
        "iran"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/rial-toman"
      ]
    },
    {
      "id": "cleanup-50",
      "name": "cleanup-50",
      "description": "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 kaf become their Persian forms, the ZWNJ half-space is normalised, digits are unified to ASCII, and whitespace and line endings are cleaned. Optionally appends a Latin transliteration column. Send the file base64-encoded in content_b64; the file never leaves this worker's origin beyond the payment check.",
      "tags": [
        "paid",
        "persian",
        "farsi",
        "csv",
        "cleanup"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/cleanup-50"
      ]
    },
    {
      "id": "cleanup-500",
      "name": "cleanup-500",
      "description": "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 kaf become their Persian forms, the ZWNJ half-space is normalised, digits are unified to ASCII, and whitespace and line endings are cleaned. Optionally appends a Latin transliteration column. Send the file base64-encoded in content_b64; the file never leaves this worker's origin beyond the payment check.",
      "tags": [
        "paid",
        "persian",
        "farsi",
        "csv",
        "cleanup"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/cleanup-500"
      ]
    },
    {
      "id": "cleanup-5000",
      "name": "cleanup-5000",
      "description": "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 kaf become their Persian forms, the ZWNJ half-space is normalised, digits are unified to ASCII, and whitespace and line endings are cleaned. Optionally appends a Latin transliteration column. Send the file base64-encoded in content_b64; the file never leaves this worker's origin beyond the payment check.",
      "tags": [
        "paid",
        "persian",
        "farsi",
        "csv",
        "cleanup"
      ],
      "examples": [
        "https://farsi-tools.johnaio281.workers.dev/api/cleanup-5000"
      ]
    }
  ],
  "documentation": {
    "openapi": "https://farsi-tools.johnaio281.workers.dev/openapi.json",
    "x402": "https://farsi-tools.johnaio281.workers.dev/.well-known/x402",
    "mcp": "https://farsi-tools.johnaio281.workers.dev/mcp",
    "skill": "https://farsi-tools.johnaio281.workers.dev/.well-known/skill.md",
    "llms": "https://farsi-tools.johnaio281.workers.dev/llms.txt"
  },
  "securitySchemes": {}
}