# Ipa Translator

> 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.

- Skill: `lotusfa/ipa-translator` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lotusfa/ipa-translator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lotusfa/ipa-translator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lotusfa (https://skillmd.com/u/lotusfa)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lotusfa/ipa-translator

---


# 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](https://github.com/anthropics/claude-code) 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](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

```bash
# 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

- [Cantonese → Jyutping](https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&format=Jyutping&input=%E4%BD%A0%E5%A5%BD)
- [Mandarin → Pinyin](https://toolbox.lotusfa.com/ipa/agent.html?language=mandarin&variant=hans&format=Pinyin&input=%E4%BD%A0%E5%A5%BD)
- [German IPA](https://toolbox.lotusfa.com/ipa/agent.html?language=german&input=Hallo%20Welt)
- [Vietnamese (Southern)](https://toolbox.lotusfa.com/ipa/agent.html?language=vietnamese&variant=S&format=tone_simple&input=Xin%20chao)
- [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)
- [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)
- [IPA only (no text)](https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&input=%E6%AC%A2%E8%BF%8E&displayFormat=ipa)
- [JSON output](https://toolbox.lotusfa.com/ipa/agent.html?language=cantonese&input=%E6%AC%A2%E8%BF%8E&displayFormat=json)

## 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](https://toolbox.lotusfa.com/ipa/agent.html) to see the full documentation page with language table.
- Non-ASCII input must be URL-encoded (e.g., `你好` → `%E4%BD%A0%E5%A5%BD`).