eggplants/deepl-cli

deepl‑cli – DeepL 번역기의 명령줄 래퍼

무엇인가요 – DeepL 웹 번역기의 명령줄 인터페이스를 제공하는 작고 간단한 Python 패키지입니다. 유료 DeepL API 키 없이도 터미널에서 또는 Python 코드에서 번역을 호출할 수 있습니다. Playwright를 사용해 DeepL 웹사이트를 제어하고 번역 결과를 추출한 후 출력합니다.

왜 중요한가요 – 번역은 많은 AI 기반 워크플로우에서 흔한 후처리 작업입니다 (예: 문서 로컬라이제이션, 다국어 코퍼스 전처리, 빠른 조회 도구 구축 등). API 등록 없이도 바로 사용 가능한 CLI는 쉘 스크립트나 CI 파이프라인에서 번역을 자동화할 수 있게 해줍니다.

설치 방법 – PyPI에서 설치하세요:

pip install deepl-cli

이 패키지는 playwright를 포함하며, 처음 실행 시 자동으로 필요한 브라우저 바이너리를 다운로드합니다.

일반적인 명령줄 사용법

# 영어에서 일본어로 짧은 문자열 번역
$ deepl -F en -T ja -s <<< 'This tool is useful for me.'
このツールは私にとって役に立ちます。

# 파일에서 읽어와 번역
$ deepl -f mytext.txt -F en -T fr

주요 플래그:

• -F / --fr – 원본 언어 (또는 auto로 설정하면 DeepL이 자동 감지함).
• -T / --to – 대상 언어 (많은 ISO 스타일 코드가 지원됨).
• -s – stdin에서 원본 텍스트를 읽음.
• -f – 파일 내용을 번역함.
• --no-headless – 브라우저 창을 표시함 (디버깅에 유용함).
• -t – 타임아웃 (밀리초 단위).

Python API – 스크립트 내에서 번역을 직접 통합하고 싶다면:

from deepl import DeepLCLI

translator = DeepLCLI('en', 'ja')
print(translator.translate('hello'))   # → こんにちは

asyncio 코드용으로 비동기 버전(translate_async)도 제공됩니다 (예제는 examples/async.py 참조).

제한 사항 – 공개된 DeepL 사이트를 스크래핑하기 때문에, 인간 사용자와 동일한 레이트 제한 및 사용 정책을 따릅니다. 고부하 또는 상업적 작업에는 공식 DeepL API를 사용하는 것이 좋습니다 (README에 deepl-python 링크 있음).

라이선스 – MIT 라이선스이므로, 자유롭게 수정하거나 다른 도구에 포함할 수 있습니다.