영문 사이트 한글 번역 깃허브블로그에 자동 포스팅

구성품은 저장소+스크립트+워크플로로 동일하게 설계했고, Jekyll 테마 기본 디자인을 가정했습니다. 로컬 환경에서 웹 스크래핑→번역→마크다운 생성→커밋까지 동작하는 앱을 만들었고, 새 글 감지는 RSS를 기준으로 구현했습니다. 다만 번역은 OpenAI API 결제가 없어 호출이 차단되어 실제 변환 결과를 얻지 못했고, 자동 커밋 단계도 마크다운이 준비되지 않아 멈췄습니다. 실습하며 확인한 장점은 1) 포스트 구조가 규격화되어 향후 검색 노출에 유리해 보이고, 2) 로컬 로그로 실패 원인을 즉시 파악할 수 있으며, 3) Secrets로 키를 숨기는 설계가 안전하다는 점입니다. 단, 무료 상태에서는 한도 초과(429)로 번역이 막혀 중요 글에는 유료 API 준비가 필수라는 것을 확인했습니다. 아래는 실제 실습 화면입니다. 제품 전체 화면 - 설정 화면 확대 - 오류 캡처 순서로 남깁니다.

세팅 자체는 간단했습니다. 저장소에 _posts 디렉터리를 만들고 파이썬/노드 스크립트로 본문을 추출해 마크다운으로 변환하도록 구성했습니다. Actions는 cron과 수동 실행을 둘 다 염두에 두고 워크플로 템플릿까지 작성했지만, 현재는 배포 전 단계입니다. 실습 중에는 OpenAI 결제가 없어 429 한도 초과 오류로 번역이 막히면서 포스팅도 실패했습니다. 해결을 위해 요청 속도 제한과 재시도 로직을 넣었지만 근본적으로는 요금제 활성화가 필요했습니다. 비용을 아끼려면 초안 번역을 다른 도구로 확보하고 API 호출량을 최소화하는 전략이 현실적이었습니다.

며칠간 로컬에서 돌려보니 손은 덜 가도록 틀은 갖춰졌지만, 현재 상태로는 번역 실패로 인해 자동 포스팅까지 이어지지 않습니다. 영문 자료를 자주 읽고 깃허브블로그로 정리하려는 분들께 구조와 워크플로 설계는 충분히 유용했으며, 다음 단계로 유료 API를 준비하고 배포를 마치면 예약 배포의 장점을 제대로 누릴 수 있을 것 같습니다.

#깃허브블로그 #영문사이트한글번역 #깃허브블로그자동포스팅 #번역파이프라인 #커서ai활용