// 홈택스·은행·카드사 데이터를 자동 수집하기 위한 CODEF API 자격증명 발급·설정 가이드 스킬. 사용자가 직접 CODEF(developer.codef.io)에 무료 가입해 받은 Client ID/Secret을 로컬(macOS Keychain 또는 ~/.jangbu/credentials.env)에 저장. BYOK(Bring Your Own Key) 방식, 외부 서버 전송 없음. 2026년 4월 기준.
한국 종합소득세·법인세 신고 준비를 위한 서류 체크리스트 자동 생성 스킬. 개인사업자(일반·간이·면세)·프리랜서·1인 법인·겸업·성실신고확인대상 5가지 유형별로 필요 서류 목록을 제공하고, korean-jangbu-for에서 자동 생성 가능한 항목을 표시한다. 2026년 기준 기한표(토·일 자동 이연 반영) 포함 — 종소세 일반 2026-06-01, 성실신고 2026-06-30.
한국 스타트업·1인 법인 대표·프리랜서·개인사업자를 위한 장부 자동 생성 진입점 스킬. 호출 시 5개 하위 스킬(jangbu-import·jangbu-tag·jangbu-tax·jangbu-dash·jangbu-jongso)을 번호·문자 메뉴로 제시하고, 입력 즉시 해당 스킬 인터뷰로 직행한다. 엑셀·5대 은행 CSV·7대 카드사 명세서 PDF·영수증·세금계산서 지원, macOS Vision/PaddleOCR 로컬 처리, Level 2 민감정보 마스킹.
원본 재무 데이터(엑셀·은행 CSV·카드 내역 CSV·영수증 이미지·세금계산서 PDF·카드명세서 PDF)를 표준 거래내역 13개 필드로 변환하는 스킬. PaddleOCR 로컬 처리로 영수증·세금계산서·카드명세서에서 거래 자동 추출, Level 2 민감정보 마스킹 적용.
스타트업·1인 법인 대표용 경영 리포트 자동 생성 스킬. 월별 손익 추이, 현금흐름(일별 net), cash burn rate(최근 N개월 평균 순지출), 비용 구조 분석. 공식 재무제표와 별개로 의사결정용 가공 리포트 제공.
표준 거래내역에 계정과목을 매핑하는 스킬. 룰 기반 분류 우선(80%+), 실패 건만 LLM fallback(마스킹 뷰), 사용자 확인 루프. 한국 거래처 100개 시드 룰 포함, 내부 계정 ↔ 국세청 표준계정 이중 구조.
세무용 재무제표(재무상태표·손익계산서) 자동 생성 스킬. 국세청 표준계정과목 매핑, 일반기업회계기준(K-GAAP) 간소화 버전. 분류 완료된 거래내역을 기간 지정해 BS·PL로 집계하고 JSON·CSV 파일로 출력.
| name | jangbu-connect |
| description | 홈택스·은행·카드사 데이터를 자동 수집하기 위한 CODEF API 자격증명 발급·설정 가이드 스킬. 사용자가 직접 CODEF(developer.codef.io)에 무료 가입해 받은 Client ID/Secret을 로컬(macOS Keychain 또는 ~/.jangbu/credentials.env)에 저장. BYOK(Bring Your Own Key) 방식, 외부 서버 전송 없음. 2026년 4월 기준. |
CODEF 자격증명 설정 가이드 스킬.
한국에서 홈택스·은행·카드·4대보험 데이터를 합법적·합리적 비용으로 자동 수집할 수 있는 유일한 프록시 API.
~/.jangbu/credentials.env)CODEF 자동 수집을 쓰려면 개인 개발자 키가 필요합니다.
[1] 브라우저에서 https://developer.codef.io 접속
[2] 우측 상단 "회원가입" → 이메일 인증 (사업자번호 불필요)
[3] 로그인 후 상단 "My Page" → "서비스 관리" → "신규 서비스 등록"
- 서비스 명: 예) korean-jangbu-for
- 서비스 구분: "개발용" 선택
- 이용 서비스: "대한민국" · "공공" · "금융" 체크
[4] 등록 직후 표시되는
- Client ID
- Client Secret
두 값을 복사해 두세요.
[5] (선택) "My Page" → "RSA Public Key" 에서 공개키 PEM도 복사해 두면
프로덕션 API에서 비밀번호 암호화 전송이 가능해요 (샌드박스는 불필요).
준비 끝나면 Enter 누르세요.
아래 값을 순서대로 입력받습니다. 값은 로컬에만 저장됩니다.
Client ID: (CODEF My Page에서 복사한 값)
Client Secret: (CODEF My Page에서 복사한 값)
RSA Public Key: (선택, 프로덕션 전환 시만 필요)
샌드박스 사용: Y/n (기본 Y — 개인 체험·테스트)
Keychain 저장: Y/n (기본 Y — 실패 시 envfile로 fallback)
입력이 끝나면 내부적으로 MCP 도구 codef_credentials_save를 호출:
codef_credentials_save(
client_id="...",
client_secret="...",
public_key_pem="...", # 선택
sandbox=True,
use_keyring=True,
)
codef_credentials_status
응답 예시:
{
"CODEF_CLIENT_ID": {"set": true, "source": "keyring", "preview": "abcd...xyz1"},
"CODEF_CLIENT_SECRET": {"set": true, "source": "keyring", "preview": "****...****"},
"CODEF_PUBLIC_KEY": {"set": false, "source": null, "preview": null},
"CODEF_SANDBOX": {"set": true, "source": "keyring", "preview": "1"}
}
간편인증 테스트를 할 수 있는 메뉴로 이동합니다.
[1] 홈택스 사업자등록증명 1건 발급 테스트 → /korean-jangbu-for → [F]
[2] 지금은 건너뛰기
| 키 | 필수 | 용도 |
|---|---|---|
CODEF_CLIENT_ID | 필수 | OAuth 클라이언트 ID |
CODEF_CLIENT_SECRET | 필수 | OAuth 시크릿 |
CODEF_PUBLIC_KEY | 선택 | 프로덕션 비밀번호 RSA 암호화용 |
CODEF_SANDBOX | 자동 | "1"=샌드박스, "0"=운영 |
export CODEF_CLIENT_ID=...)keyring 패키지 설치 시)~/.jangbu/credentials.env — 평문, 파일 권한 0o600저장 방법은 codef_credentials_save(use_keyring=True/False)로 선택 가능.
재입력하면 덮어쓰기. 완전 삭제하려면:
# Keychain (macOS)
security delete-generic-password -s korean-jangbu-for -a CODEF_CLIENT_ID
# envfile
rm ~/.jangbu/credentials.env
또는 향후 MCP 도구로 제공 예정.
| 플랜 | 월 한도 | 비용 |
|---|---|---|
| 개인 개발자(샌드박스) | 1,000건 | 무료 |
| 개인 개발자(운영) | 3,000건 | 월 1만원 |
| 스타트업 | 10,000건 | 월 5만원~ |
| 법인 | 협의 | 견적 |
일반 스타트업·1인 법인의 월 사용량은 보통 100~500건 수준 → 무료 플랜으로 충분.
CODEF 사용이 어려운 경우 수동 다운로드 + jangbu-import 플로우로 동일한 기능 실행 가능.
jangbu-jongso 스킬이 홈택스 각 메뉴의 다운로드 경로를 상세히 안내합니다.