English Phonetics Batch

批量为英文单词添加、检查和标注美式国际音标（IPA）。支持从文本文件批量导入单词，自动查询每个单词的美式发音音标，验证现有音标正确性，并输出格式化结果。

Security Scan

The skill's code, instructions, and requirements are consistent with its stated purpose (bulk American IPA lookup using the free Dictionary API); it requests no credentials or unusual installs and makes only expected network requests to dictionaryapi.dev.

Purpose & Capability

Name/description match the included files: an instruction-only skill plus a Python script that fetches American IPA from the Dictionary API. No unrelated binaries, credentials, or config paths are requested.

Instruction Scope

SKILL.md instructs running the included Python script and documents inputs/outputs. The runtime behavior (reading provided input files, calling dictionaryapi.dev, writing formatted outputs) matches the documented scope. There are no instructions to read unrelated system files, secrets, or send data to unexpected endpoints.

Install Mechanism

No install spec; dependencies limited to the well-known 'requests' Python package listed in requirements.txt. No downloads from arbitrary URLs or archive extraction are present.

Credentials

The skill requires no environment variables or credentials. Network access to dictionaryapi.dev is appropriate for the documented function. No API keys or unrelated service tokens are requested.

Persistence & Privilege

always is false and the skill does not request persistent system privileges or modify other skills/configuration. It runs as a normal user script and does not attempt to install background services.

Assessment

This skill appears coherent and low-risk, but before running it: (1) inspect the included script and run it in a virtual environment (venv) and with a test input to confirm behavior; (2) be aware it sends each lookup to https://api.dictionaryapi.dev/ (no API key required) so any words you provide will be transmitted to that service — avoid sending sensitive/personal data; (3) respect the API's non-commercial terms and rate limits (the script includes delays and retries, which is good); (4) if you need higher throughput/privacy, consider switching to an offline source such as the CMU Pronouncing Dictionary as suggested in the docs.

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 5

Python 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/ noun

CSV format (for spreadsheets):

word,phonetic_american,part_of_speech,is_valid
apple,/ˈæpl/,noun,True
banana,/bəˈnænə/,noun,True

Markdown format:

Word	American IPA	Part of Speech
apple	/ˈæpl/	noun
banana	/bəˈnænə/	noun

Requirements

• Python 3.6+
• requests library (pip install requests)
• Internet connection (for dictionary API queries)

Installation

pip install requests

No other installation required - just clone and use.

Author

Created for bulk English vocabulary phonetic transcription with American English IPA.