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
# Using agent-browser
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 # Get the IPA output
# Using WebFetch
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).
1---2name: ipa-translator3description: 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.4---56# IPA Translator — Agent Interface78Translate text to International Phonetic Alphabet (IPA) via a web interface.910## Prerequisites1112**Required Tooling**1314To use this, you must use a browser-based tool like [agent-browser](https://github.com/anthropics/claude-code) or a headless engine (Playwright/Puppeteer) that executes JavaScript.1516**Do not use curl or HTTP tools** — the page runs entirely in the browser (client-side JS fetches IPA databases and processes text).1718## Base URL1920[https://toolbox.lotusfa.com/ipa/agent.html](https://toolbox.lotusfa.com/ipa/agent.html)2122## How to Use2324Navigate to the URL with query parameters. The page runs entirely in the browser — JavaScript fetches the IPA database and processes the text client-side.2526```27https://toolbox.lotusfa.com/ipa/agent.html?language=<code>&input=<text>[&format=<format>][&variant=<variant>][&displayFormat=<format>]28```2930| Param | Required | Description |31|-------|----------|-------------|32| `language` | Yes | Language code (see list below) |33| `input` | Yes | Text to translate (URL-encode non-ASCII characters) |34| `format` | No | Output format key (Jyutping, Pinyin, etc). Omit for raw IPA |35| `variant` | No | Language variant. Uses default when omitted |36| `displayFormat` | No | Display mode: `normal` (text+IPA, default), `ipa` (IPA only), `json`, `csv` |3738## Browser Usage3940```bash41# Using agent-browser42agent-browser open "https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&format=Jyutping&input=%E4%BD%A0%E5%A5%BD"43agent-browser wait --load networkidle44agent-browser get text pre # Get the IPA output4546# Using WebFetch47WebFetch url="https://toolbox.lotusfa.com/ipa/agent.html?language=german&input=Hallo Welt" prompt="Extract the plain text IPA output from the page"48```4950## Supported Languages5152| Code | Variants | Formats |53|------|----------|---------|54| cantonese | — | IPA_org, IPA_num, Jyutping, Guangzhou, Academy, Yale, Liu |55| mandarin | hant, hans | IPA_org, IPA_num, Pinyin_num, Pinyin, Zhuyin |56| english | US, UK | — |57| french | FR, QC | — |58| spanish | ES, MX | — |59| vietnamese | C, N, S | IPA_org, IPA_num, tone_simple |60| japanese | — | — |61| korean | — | — |62| khmer | — | — |63| arabic | — | — |64| esperanto | — | — |65| persian | — | — |66| finnish | — | — |67| german | — | — |68| icelandic | — | — |69| jamaican | — | — |70| malay | — | — |71| norwegian | — | — |72| odia | — | — |73| portuguese | — | — |74| romanian | — | — |75| swahili | — | — |76| swedish | — | — |77| dutch | — | — |7879## Examples8081- [Cantonese → Jyutping](https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&format=Jyutping&input=%E4%BD%A0%E5%A5%BD)82- [Mandarin → Pinyin](https://toolbox.lotusfa.com/ipa/agent.html?language=mandarin&variant=hans&format=Pinyin&input=%E4%BD%A0%E5%A5%BD)83- [German IPA](https://toolbox.lotusfa.com/ipa/agent.html?language=german&input=Hallo%20Welt)84- [Vietnamese (Southern)](https://toolbox.lotusfa.com/ipa/agent.html?language=vietnamese&variant=S&format=tone_simple&input=Xin%20chao)85- [Korean](https://toolbox.lotusfa.com/ipa/agent.html?language=korean&input=%EC%95%88%EB%85%95%ED%95%98%EC%84%B8%EC%9A%94)86- [Japanese](https://toolbox.lotusfa.com/ipa/agent.html?language=japanese&input=%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF)87- [IPA only (no text)](https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&input=%E6%AC%A2%E8%BF%8E&displayFormat=ipa)88- [JSON output](https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&input=%E6%AC%A2%E8%BF%8E&displayFormat=json)8990## Output9192The page renders plain text in a `<pre>` element. No extra UI, no HTML wrapping. Errors appear as plain text starting with "Error:" or "Unknown".9394| displayFormat | Output |95|---------------|--------|96| `normal` (default) | Text with IPA, e.g. `( 歡 fu:n˥ ) ( 迎 jɪŋ˨˩ )` |97| `ipa` | IPA only, e.g. `fu:n˥ jɪŋ˨˩` |98| `json` | JSON array of `{word, ipa, formatted}` objects |99| `csv` | CSV with `word`, `ipa`, `formatted` columns |100101## Notes102103- Visit [without parameters](https://toolbox.lotusfa.com/ipa/agent.html) to see the full documentation page with language table.104- Non-ASCII input must be URL-encoded (e.g., `你好` → `%E4%BD%A0%E5%A5%BD`).
lotusfa