菜单
홈택스·은행·카드사 데이터를 자동 수집하기 위한 CODEF API 자격증명 발급·설정 가이드 스킬. 사용자가 직접 CODEF(developer.codef.io)에 무료 가입해 받은 Client ID/Secret을 로컬(macOS Keychain 또는 ~/.jangbu/credentials.env)에 저장. BYOK(Bring Your Own Key) 방식, 외부 서버 전송 없음. 2026년 4월 기준.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/kimlawtech/korean-jangbu-for --skill jangbu-connect命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
한국 종합소득세·법인세 신고 준비를 위한 서류 체크리스트 자동 생성 스킬. 개인사업자(일반·간이·면세)·프리랜서·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 민감정보 마스킹 적용.
基于 SOC 职业分类
正在显示 SKILL.md
| 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":
간편인증 테스트를 할 수 있는 메뉴로 이동합니다.
[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 스킬이 홈택스 각 메뉴의 다운로드 경로를 상세히 안내합니다.