eoash Cash Position 자동 업데이트
3개 법인(한국/미국/베트남) 은행 잔액·입출금을 조회하여 Google Sheets Cash Position Summary를 업데이트하는 스킬.
데이터 소스별 자동화 현황
| 법인 | 은행 | 소스 | 자동화 | 옵션 |
|---|---|---|---|---|
| US | Chase (checking ...6797) | Plaid API | 자동 (CSV 불필요) | --plaid |
| US | Hanmi (checking ...3389) | Plaid API | 자동 (CSV 불필요) | --plaid |
| KR | 농협/우리/신한 등 | Clobe.ai 엑셀 | 수동 다운로드 필요 | --clobe |
| VN | 우리은행 베트남 | 우리은행 xls | 수동 다운로드 필요 | --vietnam |
| VN | Techcombank | CSV | 수동 다운로드 필요 | --techcombank |
핵심 스크립트
scripts/parse_cash_position.py
실행 환경: /Users/ash/Documents/eoash/.venv/bin/python (plaid, pandas, dotenv 설치됨)
사용법
1. 미국만 (Plaid API — 파일 다운로드 불필요)
/Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py \
--plaid --month {YYYY.MM} [--dry-run] [--skip-revenue]
사용자가 "미국 잔액", "US cash" 등 미국만 언급하면 이 모드 사용.
2. 전체 3개 법인 (미국 자동 + 한국/베트남 파일)
/Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py \
--plaid \
--clobe ~/Downloads/주식회사*.xlsx \
--vietnam ~/Downloads/ExcelSheet*.xls \
--month {YYYY.MM}
사용자가 "캐시 포지션 업데이트", "전체 잔액" 등 전체를 요청하면:
- 미국:
--plaid로 자동 조회 - 한국: Clobe.ai에서 엑셀 다운로드했는지 확인 → 파일 경로 요청
- 베트남: 우리은행에서 xls 다운로드했는지 확인 → 파일 경로 요청
3. CSV 방식 (레거시 — Plaid 장애 시 fallback)
/Users/ash/Documents/eoash/.venv/bin/python scripts/parse_cash_position.py \
--chase ~/Downloads/Chase*.CSV \
--hanmi ~/Downloads/AccountHistory.csv \
--clobe ~/Downloads/주식회사*.xlsx \
--month {YYYY.MM}
Plaid API 장애 시에만 사용. Chase/Hanmi 웹뱅킹에서 CSV 직접 다운로드 필요.
실행 흐름
- 사용자가 월을 지정하지 않으면 현재 월(
YYYY.MM)을 자동 사용 - 먼저
--dry-run으로 실행하여 결과 확인 (사용자에게 보여주기) - 사용자가 확인하면
--dry-run없이 재실행하여 Google Sheets 실제 업데이트 - 결과 요약: 각 법인 잔액, 입출금, US 합산, 환율
주요 옵션
| 옵션 | 설명 |
|---|---|
--plaid |
Chase/Hanmi를 Plaid API로 조회 (CSV 불필요) |
--clobe |
한국 Clobe.ai 엑셀 파일 경로 (수동 다운로드) |
--vietnam |
우리은행 베트남 xls 경로 (수동 다운로드) |
--techcombank |
Techcombank 베트남 CSV 경로 (수동 다운로드) |
--month |
대상 월 (예: 2026.03) — 필수 |
--skip-revenue |
미국 매출/한국 미수금 업데이트 건너뜀 |
--dry-run |
시트 업데이트 없이 결과만 출력 |
--extra-kr-balance |
클로브에 없는 한국 계좌 잔액 수동 추가 |
환경변수 (.env)
스크립트가 자동으로 프로젝트 루트 .env를 로드함:
PLAID_CLIENT_ID/PLAID_SECRET/PLAID_ENV=productionPLAID_ACCESS_TOKEN_CHASE— Chase PLAT BUS CHECKING ...6797PLAID_ACCESS_TOKEN_HANMI— Hanmi Business Regular Checking ...3389- Google Sheets SA:
finance-dashboard/.env.local
주의사항
--dry-run없이 실행하면 Google Sheets가 직접 수정됨 — 반드시 먼저 dry-run- Plaid access_token은 영구 토큰이지만, 은행 비밀번호 변경 시 재연결 필요
- 한국/베트남은 Plaid 미지원 → 파일 다운로드 필수 (자동화 불가)
- 은행 재연결 필요 시:
python scripts/plaid_link_connect.py→ localhost:8484