- name
- english-phonetics-batch
- description
- 批量为英文单词添加、检查和标注美式国际音标（IPA）。支持从文本文件批量导入单词，自动查询每个单词的美式发音音标，验证现有音标正确性，并输出格式化结果。
English Phonetics Batch - 英文单词批量音标标注工具
当以下情况时使用此 Skill：
- 需要批量给英文单词列表添加美式国际音标（IPA）
- 需要检查现有单词表中的音标是否正确
- 需要将纯单词列表转换为带音标的词汇表
- 需要验证修复高考/四级/六级/雅思/托福等词汇表中损坏的音标
- 需要从编码损坏的文档中恢复问号占位的音标
Features
- ✅ 自动查询每个单词的美式发音国际音标
- ✅ 支持批量处理从几十到几千个单词
- ✅ 检查现有音标正确性，标记并修复错误音标（自动修复问号占位符）
- ✅ 自动重试 - 指数退避重试网络错误和限流
- ✅ 统计报告 - 显示成功率和处理摘要
- ✅ 输出多种格式：纯文本、Markdown、CSV
- ✅ 美式发音优先，自动优先选择美式音标
- ✅ 处理结果包含单词 + 音标 + 词性
- ✅ 使用免费 API，不需要 API 密钥
- ✅ 可配置延迟和重试次数，灵活适应不同大小列表
Quick Start
Command Line
# Basic bulk processing (one word per line)
cd scripts/
python english_phonetics_batch.py input_words.txt output_with_phonetics.txt
# Check and fix existing file with corrupted phonetics (question marks from encoding errors)
python english_phonetics_batch.py input.txt output.txt --check
# Output as CSV for spreadsheets
python english_phonetics_batch.py words.txt output.csv --format csv
# Large vocabulary list - increase delay for safety, more retries
python english_phonetics_batch.py words.txt output.txt --delay 500 --retries 5Python API
import sys
sys.path.insert(0, 'path/to/english-phonetics-batch/scripts')
from english_phonetics_batch import PhoneticsBatch
processor = PhoneticsBatch()
results = processor.process_words(["apple", "banana", "cherry"])
processor.save_results(results, "output.txt", format="text")Documentation
- Usage Examples - Complete examples for common use cases
- API Notes & IPA Reference - Technical details about the API and American IPA symbols
Output Formats
Text format (default):
apple /ˈæpl/ noun
banana /bəˈnænə/ noun
cherry /ˈtʃeri/ nounCSV format (for spreadsheets):
word,phonetic_american,part_of_speech,is_valid
apple,/ˈæpl/,noun,True
banana,/bəˈnænə/,noun,TrueMarkdown format:
| Word | American IPA | Part of Speech |
|---|---|---|
| apple | /ˈæpl/ | noun |
| banana | /bəˈnænə/ | noun |
Requirements
- Python 3.6+
requestslibrary (pip install requests)- Internet connection (for dictionary API queries)
Installation
pip install requestsNo other installation required - just clone and use.
Author
Created for bulk English vocabulary phonetic transcription with American English IPA.