// 한국 스타트업·1인 법인 대표·프리랜서·개인사업자를 위한 장부 자동 생성 진입점 스킬. 호출 시 5개 하위 스킬(jangbu-import·jangbu-tag·jangbu-tax·jangbu-dash·jangbu-jongso)을 번호·문자 메뉴로 제시하고, 입력 즉시 해당 스킬 인터뷰로 직행한다. 엑셀·5대 은행 CSV·7대 카드사 명세서 PDF·영수증·세금계산서 지원, macOS Vision/PaddleOCR 로컬 처리, Level 2 민감정보 마스킹.
| name | korean-jangbu-for |
| description | 한국 스타트업·1인 법인 대표·프리랜서·개인사업자를 위한 장부 자동 생성 진입점 스킬. 호출 시 5개 하위 스킬(jangbu-import·jangbu-tag·jangbu-tax·jangbu-dash·jangbu-jongso)을 번호·문자 메뉴로 제시하고, 입력 즉시 해당 스킬 인터뷰로 직행한다. 엑셀·5대 은행 CSV·7대 카드사 명세서 PDF·영수증·세금계산서 지원, macOS Vision/PaddleOCR 로컬 처리, Level 2 민감정보 마스킹. |
한국 장부 자동 생성 진입점 스킬.
진입점이 처음 실행될 때 다음 두 도구를 먼저 호출해 결과를 인트로에 삽입:
mcp_health() # 서버·DB·OCR·자격증명 상태
security_status() # 마스킹·토큰DB·감사로그 상태
응답이 실패하면 즉시 설치 안내(scripts/install.sh·claude mcp add jangbu-mcp)로 전환.
성공하면 아래 인트로의 [보안 모델] 블록에 실시간 상태 표시:
[MCP 연결 상태]
✅ jangbu-mcp v0.2.0 정상 동작
✅ OCR 엔진: vision (macOS) / paddleocr
✅ SQLite 초기화 완료 (계정 47·룰 46·거래 N건)
✅ 지원 파일: PNG·JPG·HEIC·HEIF·WEBP·TIFF·BMP·GIF·PDF·XLSX·CSV
[보안 상태]
✅ Level 2 마스킹 활성 (5개 패턴)
✅ tokens.db 권한 0o600
✅ audit.log append-only (누적 N건)
✅ OCR 로컬 실행 · 외부 전송 없음
✅ 자격증명 BYOK (사용자 로컬)
처음 사용 시 (또는 ~/.jangbu/jangbu.db 미존재) 아래 안내를 먼저 출력.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
한국 법률 AI 허브 — SpeciAI 에서 만들었어요
→ discord.gg/wQWpEpnBfE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
korean-jangbu-for
한국 스타트업·1인 법인·프리랜서를 위한 장부 자동화
[무엇을 할 수 있나요]
• 카드명세서 PDF·은행 CSV·영수증을 자동 표준화
• 계정과목 자동 분류 (룰 + 학습 + LLM 보조)
• 손익계산서·재무상태표·월별 대시보드 생성
• 더존·세무사랑 호환 분개 CSV (세무사 전달용)
• 홈택스·은행·카드사 자동 수집 (CODEF API 연동)
• 5월 종합소득세 준비 체크리스트 + 자동 생성 서류 패키지
[보안 모델 · Level 2]
• 원본 파일은 ~/.jangbu/raw/ 에만 저장
• 사업자번호·주민번호·카드번호·계좌번호 자동 토큰화
• LLM에는 마스킹 뷰만, 리포트 집계는 서버 내부에서
• OCR은 macOS Vision / PaddleOCR 로컬 실행
• 모든 호출 ~/.jangbu/audit.log 기록
[자동 수집 (BYOK — 사용자 본인 키 사용)]
• CODEF developer.codef.io 무료 가입 후 키 발급
• /jangbu-connect 스킬에서 로컬 저장 (Keychain)
• 외부 서버 전송 없음, 사용자 본인 계정 비용으로 호출
[SpeciAI — 한국 법률·세무 AI 허브]
창업자·개발자·변호사·세무사·회계사가 모여
계약·노동·투자·지재권·세무 이슈를 AI로 푸는 커뮤니티.
여기서 물어볼 수 있어요:
• 이 스킬 사용 중 궁금한 점 / 버그 리포트 / 기능 요청
• 종소세·부가세·법인세 신고 전 실무 질문
• CODEF·홈택스·세무사랑 연동 관련 이슈
• 계약서·처리방침·장부 작성 팁
• "이런 스킬 있으면 좋겠는데" 아이디어 제안
신규 스킬 업데이트 공지·실전 사례·Q&A 채널 운영 중.
→ https://discord.gg/wQWpEpnBfE
[면책]
생성 문서는 참고용 초안입니다.
법인세·종소세 신고 전 세무사 검토 필수,
외감 대상(자산 120억↑)은 공인회계사 감사 필수.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
호출 즉시 아래 번호 메뉴를 출력하고 사용자 입력을 대기한다.
무엇을 하시겠습니까?
━ 시스템 · 자동 수집 ━
[H] MCP 연결 · 보안 상태 점검 (mcp_health + security_status)
[S] CODEF API 설정 (CODEF 키 발급·등록, 1회)
→ jangbu-connect
[F] 홈택스·은행·카드 자동 수집 실행
codef_fetch_hometax / codef_fetch_bank / codef_fetch_card
[P] 일괄 서류 준비 (5월·6월 신고 시즌 원클릭)
→ 홈택스 증명서 + 은행·카드 최근 12개월 + 4대보험 일괄
[I] 폴더 일괄 가져오기 (ingest_folder)
→ 영수증·세금계산서·카드명세서·엑셀·CSV 섞여있어도 자동 분류
━ 단계별 실행 ━
[1] 원본 데이터 표준화 (엑셀·은행CSV·카드명세서·영수증·세금계산서)
→ jangbu-import
[2] 계정과목 매핑 (룰 분류 + 학습 + 사용자 확인)
→ jangbu-tag
[3] 세무용 재무제표 생성 (재무상태표·손익계산서)
→ jangbu-tax
[4] 경영 리포트 생성 (월별 손익·현금흐름·cash burn·카드별 분석)
→ jangbu-dash
━ 원클릭 시나리오 ━
[M] 월마감 (지난달 데이터 정리 → 분류 → PL·현금흐름 → HTML 대시보드)
[Q] 분기마감 (분기 데이터 정리 → 분류 → BS·PL·분기 대시보드)
[T] 세무사 전달용 (연간 분개 CSV + PL CSV 생성, 더존 호환)
[X] 종소세 준비 (체크리스트 + 자동 생성 서류 묶음)
→ jangbu-jongso
[C] 카드별 사용 분석 (여러 장 카드 이용액·계정 분포·월별 추이)
[A] 전체 파이프라인 순차 실행 (1 → 2 → 3 → 4)
번호 또는 문자를 입력하세요.
[S] 자동 수집 설정 — jangbu-connect 직행. 첫 CODEF 등록 5분, 이후 재실행 1분.
[F] 자동 수집 실행
1. codef_credentials_status 호출 — 키 등록 여부 확인
미등록이면 → /jangbu-connect 안내 후 종료
2. 수집 유형 선택:
[1] 홈택스 증명서류 (소득·납세·사업자등록·부가세과세표준)
[2] 은행 거래내역 (KB·신한·우리·하나·IBK·NH·카카오·토스)
[3] 카드 이용내역 (신한·KB·삼성·현대·롯데·BC·우리·하나·NH)
[A] 전체 (홈택스 + 주 거래 계좌 + 주 사용 카드)
3. 각 항목별 필요 정보 입력:
- 홈택스: 이름·주민번호(13자리)·귀속연도
- 은행: 기관·계좌번호·계좌비번·기간
- 카드: 카드사·로그인ID·비번·기간
간편인증 방식 선택 (기본 카카오)
4. MCP 도구 호출 → 1단계 응답 받음
→ "카카오톡 승인 요청됨" 알림
→ 사용자가 카카오톡 앱에서 인증 완료
5. 2단계 호출 (twoway_info 포함)
→ 데이터 수신 → 표준 13필드 매핑 → DB 적재
6. 요약 표시:
✅ 홈택스: 소득금액증명 1건
✅ 신한은행: 856건 거래내역
✅ 신한카드(039/122): 287건
→ 다음 단계: /jangbu-tag 로 계정 분류
[P] 일괄 서류 준비 워크플로우 (5월·6월 신고용)
1. codef_credentials_status — 키 등록 확인
미등록이면 → /jangbu-connect 안내 후 종료
2. 사용자 정보 수집:
- 신고 주체 (개인사업자·프리랜서·1인 법인)
- 귀속 연도 (기본: 직전년도)
- 이름·주민번호(13자리)·사업자번호(있으면)
- 주 거래 은행 계좌·비번
- 주 사용 카드사·ID·비번
3. 홈택스 일괄:
- codef_fetch_hometax(income_proof) # 소득금액증명
- codef_fetch_hometax(tax_clearance) # 납세증명
- codef_fetch_hometax(biz_reg_proof) # 사업자등록증명
- codef_fetch_hometax(vat_base_proof) # 부가세 과세표준증명
각 단계마다 카카오 간편인증 필요
4. 금융 일괄 (지난 12개월):
- codef_fetch_bank 각 은행별
- codef_fetch_card 각 카드사별
5. 결과 요약:
✅ 홈택스 증명 4종
✅ 은행 거래 N건
✅ 카드 이용 M건
⏳ 수동 준비 필요:
- 임대차계약서 사본
- 환급용 통장 사본
- 기부금 영수증 원본
6. 분류 + 리포트 자동 이어서:
classify_with_rules(year_start, year_end)
export_djournal(year_start, year_end)
export_report(pl, fmt=csv)
export_report(dashboard, fmt=html)
7. tax_package 디렉토리 생성 → 세무사 전달용 패키지 완성
[I] 폴더 일괄 가져오기
1. 사용자에게 폴더 경로 요청
예: ~/Downloads/2025_영수증
2. file_types.scan_folder로 파일 유형 분류 (이미지·PDF·엑셀·CSV)
3. ingest_folder 호출
- 이미지 → OCR (영수증/세금계산서 auto) → 거래 적재
- PDF → 카드명세서 구조화 → 적재
- 엑셀 → parse_manual_xlsx
- CSV → parse_bank_csv → 실패 시 parse_card_csv
4. 결과:
"이미지 47 / PDF 3 / 엑셀 1 / CSV 2 처리 완료, 313건 적재"
실패 건 목록 표시 (사용자 수동 확인 필요)
[M] 월마감 워크플로우
1. 지난달 기간 확정 (예: 2026-03-01 ~ 2026-03-31)
2. jangbu-import 실행 안내 — 사용자에게 파일 경로 요청
3. classify_with_rules(start_date, end_date) — 룰 자동 분류
4. 미분류 건 LLM fallback (마스킹 뷰) → 사용자 확인 루프
5. export_report(pl) + export_report(cash_flow)
6. export_report(dashboard, fmt=html) → 브라우저 열기 안내
7. 결과 요약 출력
[Q] 분기마감 워크플로우
1. 분기 기간 확정 (Q1: 1-3월 등)
2. 누락 월 있는지 데이터 검증
3. 룰 분류 + LLM fallback
4. export_report(pl) + export_report(bs) + export_report(monthly_pl)
5. export_report(dashboard, fmt=html) 분기 버전
[T] 세무사 전달용
1. 연도 확인
2. 미분류 거래 있으면 먼저 분류 권고
3. export_djournal(period_start, period_end) — 더존·세무사랑 CSV
4. export_report(pl, fmt=csv) + export_report(bs, fmt=csv)
5. 출력 파일 경로 안내 — 세무사 전달 방법
[X] 종소세 준비 시나리오
1. jangbu-jongso 스킬로 라우팅
2. 신고 주체 확인 (개인사업자·프리랜서·1인 법인·겸업·성실신고 대상)
- 성실신고 대상은 5/31이 아니라 6/30 기한
3. 귀속 연도 확인 (기본 직전년도)
4. 유형별 체크리스트 + 자동 생성 가능 항목 표시
5. 자동 생성: export_djournal + PL·BS·dashboard
6. 수동 준비 항목 안내 (홈택스 자료·계약서 등)
7. 세무사 전달 패키지 생성 (선택)
[C] 카드별 분석 시나리오
1. 기간 확인
2. export_report(card_analysis, period_start, period_end)
3. 카드별 이용액·주요 계정·월별 추이 표시
4. 특정 카드 드릴다운 가능 (예: "신한 039 세부 내역")
H → mcp_health + security_status 호출 결과 표시S → jangbu-connect 스킬 호출 (CODEF 자격증명 설정)F → 자동 수집 시나리오 (codef_credentials_status 확인 → 문서 유형 선택 → codef_fetch_*)P → 일괄 서류 준비 시나리오 (아래 상세 참조)I → ingest_folder 호출 (사용자에게 폴더 경로 묻고 처리)1 → jangbu-import 스킬 호출 안내2 → jangbu-tag 스킬 호출 안내3 → jangbu-tax 스킬 호출 안내4 → jangbu-dash 스킬 호출 안내M → 월마감 시나리오 실행Q → 분기마감 시나리오 실행T → 세무사 전달 CSV 생성 (export_djournal + export_report csv)X → jangbu-jongso 스킬 호출C → export_report(card_analysis) 실행A → 순서대로 호출: import → tag → tax → dash각 번호 선택 시 다음 순서로 검증:
jangbu-mcp 서버 연결 확인
get_audit_log 호출로 서버 동작 확인데이터 존재 여부 확인 (2·3·4번 선택 시)
list_transactions 호출로 거래내역 존재 확인~/.jangbu/raw/에만 저장~/.jangbu/audit.log에 기록한국 종합소득세·법인세 신고 준비를 위한 서류 체크리스트 자동 생성 스킬. 개인사업자(일반·간이·면세)·프리랜서·1인 법인·겸업·성실신고확인대상 5가지 유형별로 필요 서류 목록을 제공하고, korean-jangbu-for에서 자동 생성 가능한 항목을 표시한다. 2026년 기준 기한표(토·일 자동 이연 반영) 포함 — 종소세 일반 2026-06-01, 성실신고 2026-06-30.
원본 재무 데이터(엑셀·은행 CSV·카드 내역 CSV·영수증 이미지·세금계산서 PDF·카드명세서 PDF)를 표준 거래내역 13개 필드로 변환하는 스킬. PaddleOCR 로컬 처리로 영수증·세금계산서·카드명세서에서 거래 자동 추출, Level 2 민감정보 마스킹 적용.
홈택스·은행·카드사 데이터를 자동 수집하기 위한 CODEF API 자격증명 발급·설정 가이드 스킬. 사용자가 직접 CODEF(developer.codef.io)에 무료 가입해 받은 Client ID/Secret을 로컬(macOS Keychain 또는 ~/.jangbu/credentials.env)에 저장. BYOK(Bring Your Own Key) 방식, 외부 서버 전송 없음. 2026년 4월 기준.
스타트업·1인 법인 대표용 경영 리포트 자동 생성 스킬. 월별 손익 추이, 현금흐름(일별 net), cash burn rate(최근 N개월 평균 순지출), 비용 구조 분석. 공식 재무제표와 별개로 의사결정용 가공 리포트 제공.
표준 거래내역에 계정과목을 매핑하는 스킬. 룰 기반 분류 우선(80%+), 실패 건만 LLM fallback(마스킹 뷰), 사용자 확인 루프. 한국 거래처 100개 시드 룰 포함, 내부 계정 ↔ 국세청 표준계정 이중 구조.
세무용 재무제표(재무상태표·손익계산서) 자동 생성 스킬. 국세청 표준계정과목 매핑, 일반기업회계기준(K-GAAP) 간소화 버전. 분류 완료된 거래내역을 기간 지정해 BS·PL로 집계하고 JSON·CSV 파일로 출력.