Python으로 반복 업무 줄이는 자동화 스크립트 8가지

준비물#

• Python 3.10+
• python -m venv .venv 후 패키지 설치
• 환경변수 또는 .env (.gitignore 필수)
• 자동화 적합성: 주 1회 이상, 규칙 명확, 15분 이상 소요

공통 시작#

1
python -m venv .venv
2
# Windows: .venv\Scripts\activate
3
pip install python-dotenv requests

1
# config는 환경변수에서만
2
import os
3
from dotenv import load_dotenv
4
load_dotenv()
5
API_TOKEN = os.environ["API_TOKEN"]

스크립트 1 — 폴더 정리 (확장자별 이동)#

1
from pathlib import Path
2
import shutil
3

4
DOWNLOADS = Path.home() / "Downloads"
5
RULES = {
6
    ".pdf": "docs",
7
    ".png": "images",
8
    ".jpg": "images",
9
    ".zip": "archives",
10
}
11

12
def organize(root: Path) -> None:
13
    for p in root.iterdir():
14
        if p.is_file() and p.suffix.lower() in RULES:
15
            dest_dir = root / RULES[p.suffix.lower()]
16
            dest_dir.mkdir(exist_ok=True)
17
            shutil.move(str(p), dest_dir / p.name)
18
            print("moved", p.name)
19

20
if __name__ == "__main__":
21
    organize(DOWNLOADS)

검증: 테스트용 폴더 복사본에서 먼저 실행.

스크립트 2 — 로그에서 ERROR 줄만 추출·요약 파일#

1
from pathlib import Path
2
from datetime import datetime
3

4
def extract_errors(log_path: Path, out_path: Path) -> int:
5
    lines = [ln for ln in log_path.read_text(encoding="utf-8", errors="ignore").splitlines()
6
             if "ERROR" in ln or "CRITICAL" in ln]
7
    header = f"# errors {datetime.now().isoformat()} count={len(lines)}\n"
8
    out_path.write_text(header + "\n".join(lines[:500]), encoding="utf-8")
9
    return len(lines)
10

11
# AI 요약이 필요하면 out 파일 내용을 챗에 붙여 "상위 원인 3개"만 요청

스크립트 3 — CSV → 주간 요약 통계#

1
import csv
2
from collections import Counter
3
from pathlib import Path
4

5
def summarize_csv(path: Path, status_col: str = "status") -> Counter:
6
    with path.open(encoding="utf-8-sig", newline="") as f:
7
        rows = list(csv.DictReader(f))
8
    return Counter(r.get(status_col, "") for r in rows)
9

10
if __name__ == "__main__":
11
    c = summarize_csv(Path("issues.csv"))
12
    for k, v in c.most_common():
13
        print(f"{k}: {v}")

스크립트 4 — Git 상태 브리핑 (로컬)#

1
import subprocess
2
from pathlib import Path
3

4
def git_brief(repo: Path) -> str:
5
    def run(args):
6
        return subprocess.check_output(["git", *args], cwd=repo, text=True, stderr=subprocess.STDOUT)
7
    branch = run(["rev-parse", "--abbrev-ref", "HEAD"]).strip()
8
    status = run(["status", "-sb"])
9
    return f"branch={branch}\n{status}"
10

11
print(git_brief(Path(".")))

스크립트 5 — Conventional Commit 메시지 초안 도우미#

1
# staged diff를 읽어 사람이 최종 확정
2
import subprocess
3

4
diff = subprocess.check_output(["git", "diff", "--cached"], text=True, errors="ignore")
5
print("아래 diff를 AI에 붙여 커밋 메시지 초안을 요청하세요. 직접 검토 후 커밋:")
6
print(diff[:4000])

프롬프트 예: Conventional Commits로 제목 1줄+본문 3줄. 과장 금지.

스크립트 6 — 디렉터리 백업 (zip)#

1
import shutil
2
from pathlib import Path
3
from datetime import datetime
4

5
def zip_backup(src: Path, dest_dir: Path) -> Path:
6
    dest_dir.mkdir(parents=True, exist_ok=True)
7
    stamp = datetime.now().strftime("%Y%m%d_%H%M")
8
    base = dest_dir / f"{src.name}_{stamp}"
9
    archive = shutil.make_archive(str(base), "zip", root_dir=src)
10
    return Path(archive)

스크립트 7 — HTTP 헬스체크 + 실패 시 종료코드#

1
import sys
2
import urllib.request
3

4
def check(url: str, timeout: float = 5.0) -> None:
5
    try:
6
        with urllib.request.urlopen(url, timeout=timeout) as r:
7
            if r.status >= 400:
8
                raise SystemExit(f"bad status {r.status}")
9
            print("ok", url, r.status)
10
    except Exception as e:
11
        print("fail", url, e)
12
        raise SystemExit(1)
13

14
if __name__ == "__main__":
15
    check("https://example.com")

작업 스케줄러·cron에 연결 가능.

스크립트 8 — 텍스트 일괄 치환 (코드 이동 시 조심)#

1
from pathlib import Path
2

3
def replace_in_files(root: Path, old: str, new: str, suffix: str = ".md") -> int:
4
    n = 0
5
    for p in root.rglob(f"*{suffix}"):
6
        text = p.read_text(encoding="utf-8")
7
        if old in text:
8
            p.write_text(text.replace(old, new), encoding="utf-8")
9
            n += 1
10
    return n
11
# 실행 전 git status 깨끗한지 확인, 반드시 버전관리 하에서

실패에서 배운 운영 팁#

• 이메일·슬랙 자동 분류는 오분류 비용이 큼 → 처음엔 “초안 폴더 + 사람 확인”
• 모든 스크립트에 if __name__ == "__main__"과 로그
• 주 1회 “자동화 점검” 15분

FAQ#

Q. AI가 스크립트를 짜 주면 되나요? 초안은 가능. 경로 삭제·메일 발송·결제 API는 반드시 사람 검토.

Q. No-code(Zapier)와 비교? 단순 SaaS 연동은 노코드, 파일·Git·커스텀 규칙은 Python이 유리.

실습 체크 (발행 전 본인 확인)#

• 글의 명령을 다른 폴더에서 한 번 더 실행해 보았는가
• 독자가 준비물 없이 막히지 않는가
• 관련 글과 역할이 겹치지 않는가

실습 체크리스트 (Python 자동화)#

• 가상환경(venv)을 만들고 의존성을 고정했는가
• 경로·계정 정보는 환경변수 또는 설정 파일로 분리했는가
• 스크립트 1개를 dry-run 후 실제 실행했는가
• 실패 시 로그가 남는가
• 스케줄(작업 스케줄러/cron) 등록 전 수동 성공을 확인했는가

자동화 후보를 고르는 점수표#

모든 반복 업무를 스크립트로 만들 필요는 없습니다. 아래 점수가 높은 것부터 하세요.

운영 체크 (스크립트 배포 전)#

• 로그 파일 경로와 로테이션
• 실패 시 알림(메일/슬랙/종료 코드)
• 의존성 버전 고정
• 샘플 데이터로 통합 테스트
• README에 권한·스케줄 예시

유지보수 부채를 줄이는 습관#

스크립트는 “짠 날”보다 고친 날이 많습니다. 함수 이름에 업무 용어를 쓰고, 매직 넘버를 상수로 빼며, 날짜 처리는 타임존을 명시하세요. AI로 초안을 받았다면 삭제·전송·결제가 있는 줄에 주석 # DANGER를 달아 리뷰 포인트를 만드세요.

Windows 작업 스케줄러를 쓸 때는 “가장 권한 높은 실행”을 기본으로 켜지 마세요. 필요한 최소 권한 계정으로 돌리고, 작업 시작/종료 로그를 이벤트 뷰어 또는 파일로 남기면 장애 분석이 빨라집니다.

이 글을 끝내면 할 수 있는 것#

• 반복 업무 8종 중 내게 해당하는 스크립트를 고른다.
• venv·설정 분리·로그로 안전하게 실행한다.
• “한 번 수동 성공 → 스케줄” 순서를 지킨다.

각 스크립트 유형별 해설 (왜 쓰는가)#

1. 파일 일괄 이름 변경: 다운로드 폴더 정리, 날짜 접두
2. CSV 병합·필터: 주간 리포트 원본 만들기
3. 이미지 리사이즈: 블로그·썸네일 일괄
4. API 폴링 후 저장: 상태 페이지·환율 등
5. 로그에서 에러 카운트: 운영 1차 점검
6. 중복 파일 해시 검사: 디스크 정리
7. Git 상태 요약 메일/슬랙: 아침 브리핑
8. 폴더 백업 zip: 배포 전 스냅샷

각 유형을 구현할 때 입출력 경로를 상수로 박지 말고 argparse 또는 환경변수로 받으세요. 그래야 다른 PC에서도 재사용됩니다.

공통 골격 예시#

1
# run_job.py — 개념 골격
2
import argparse, logging, sys
3
from pathlib import Path
4

5
logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
6
log = logging.getLogger("job")
7

8
def main() -> int:
9
    p = argparse.ArgumentParser()
10
    p.add_argument("--dry-run", action="store_true")
11
    p.add_argument("--input", type=Path, required=True)
12
    args = p.parse_args()
13
    log.info("start input=%s dry_run=%s", args.input, args.dry_run)
14
    # ... 실제 처리 ...
15
    log.info("done")
16
    return 0
17

18
if __name__ == "__main__":
19
    sys.exit(main())

트러블슈팅#

FAQ 보강#

Q. PowerShell로 충분하지 않나요? 단순 파일 작업은 충분합니다. 파싱·API·테스트가 늘면 Python이 유지보수에 유리한 경우가 많습니다.

Q. 회사 PC에 pip 설치가 막혀 있어요. 내장 venv + wheels 오프라인 설치, 또는 승인된 사내 PyPI를 사용하세요.

Q. 스크립트를 팀에 공유하는 최소 요건은? README 10줄, requirements.txt, dry-run, 샘플 입력이 있으면 충분합니다.

Q. AI가 짜 준 스크립트를 믿어도 되나요? 경로 삭제·메일 발송·결제 API는 특히 위험합니다. 부작용 있는 줄에 브레이크포인트를 걸고 한 줄씩 확인하세요.

현장에서 바로 쓰는 Python 자동화 운영 노트#

이 절은 Python 자동화 본문을 읽은 뒤 다음 영업일 안에 실행할 때 참고하는 운영 메모입니다. 도구 이름보다 중요한 것은 반복 가능한 순서와 실패 기록입니다. 처음 한 주는 완벽한 세팅보다 ‘최소 성공 1회’를 목표로 하세요. 성공 기준을 숫자나 체크박스로 적어 두면 나중에 회고할 때 감이 아니라 데이터로 판단할 수 있습니다.

정리#

8개 중 폴더 정리·로그 추출·헬스체크부터 스케줄에 올려 보세요. 자동화는 한 번 만들면 매주 시간이 돌아옵니다.

참고: Python 문서 · Real Python