| name | ipa-translator |
| description | Translate text to International Phonetic Alphabet (IPA) and romanization formats for 24 languages including Cantonese, Mandarin, English, Japanese, Korean, Vietnamese and more. Use when the user asks for IPA transcription, phonetic notation, Pinyin, Jyutping, or any language-to-IPA conversion. |
IPA Translator — Agent Interface
Translate text to International Phonetic Alphabet (IPA) via a web interface.
Prerequisites
Required Tooling
To use this, you must use a browser-based tool like agent-browser or a headless engine (Playwright/Puppeteer) that executes JavaScript.
Do not use curl or HTTP tools — the page runs entirely in the browser (client-side JS fetches IPA databases and processes text).
Base URL
https://toolbox.lotusfa.com/ipa/agent.html
How to Use
Navigate to the URL with query parameters. The page runs entirely in the browser — JavaScript fetches the IPA database and processes the text client-side.
https://toolbox.lotusfa.com/ipa/agent.html?language=<code>&input=<text>[&format=<format>][&variant=<variant>][&displayFormat=<format>]
| Param | Required | Description |
|---|
language | Yes | Language code (see list below) |
input | Yes | Text to translate (URL-encode non-ASCII characters) |
format | No | Output format key (Jyutping, Pinyin, etc). Omit for raw IPA |
variant | No | Language variant. Uses default when omitted |
displayFormat | No | Display mode: normal (text+IPA, default), ipa (IPA only), json, csv |
Browser Usage
agent-browser open "https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&format=Jyutping&input=%E4%BD%A0%E5%A5%BD"
agent-browser wait --load networkidle
agent-browser get text pre
WebFetch url="https://toolbox.lotusfa.com/ipa/agent.html?language=german&input=Hallo Welt" prompt="Extract the plain text IPA output from the page"
Supported Languages
| Code | Variants | Formats |
|---|
| cantonese | — | IPA_org, IPA_num, Jyutping, Guangzhou, Academy, Yale, Liu |
| mandarin | hant, hans | IPA_org, IPA_num, Pinyin_num, Pinyin, Zhuyin |
| english | US, UK | — |
| french | FR, QC | — |
| spanish | ES, MX | — |
| vietnamese | C, N, S | IPA_org, IPA_num, tone_simple |
| japanese | — | — |
| korean | — | — |
| khmer | — | — |
| arabic | — | — |
| esperanto | — | — |
| persian | — | — |
| finnish | — | — |
| german | — | — |
| icelandic | — | — |
| jamaican | — | — |
| malay | — | — |
| norwegian | — | — |
| odia | — | — |
| portuguese | — | — |
| romanian | — | — |
| swahili | — | — |
| swedish | — | — |
| dutch | — | — |
Examples
Output
The page renders plain text in a <pre> element. No extra UI, no HTML wrapping. Errors appear as plain text starting with "Error:" or "Unknown".
| displayFormat | Output |
|---|
normal (default) | Text with IPA, e.g. ( 歡 fu:n˥ ) ( 迎 jɪŋ˨˩ ) |
ipa | IPA only, e.g. fu:n˥ jɪŋ˨˩ |
json | JSON array of {word, ipa, formatted} objects |
csv | CSV with word, ipa, formatted columns |
Notes
- Visit without parameters to see the full documentation page with language table.
- Non-ASCII input must be URL-encoded (e.g.,
你好 → %E4%BD%A0%E5%A5%BD).
