kazukinagata/shinkoku

해결하는 문제

이 프로젝트는 개인 사업자와 소규모 사업자를 위한 일본의 연간 세금 신고 프로세스(확정신고)를 자동화합니다. 장부에 거래 기록, 소득세·소비세 계산, 재무제표 작성, 공식 e-Tax 양식 작성까지 지루한 수동 단계를 제거합니다. 개인 사업자, 부업이 있는 직장인, 프리랜서 등 일본 거주자로서 세금 신고를 하는 사람들을 대상으로 합니다.

작동 방식

Shinkoku는 Claude Code, Cursor, Copilot과 같은 인기 있는 AI 코딩 에이전트와 작동하는 AI 에이전트 스킬 및 CLI 세트입니다. 설치 후 사용자는 /setup, /journal, /income-tax, /consumption-tax, /e-tax와 같은 슬래시 명령을 실행합니다. 이 도구는 재무 데이터를 로컬 SQLite 데이터베이스에 저장하고, Python 라이브러리에서 세금 규칙을 읽으며, OCR을 사용하여 영수증과 원천징수 영수증을 읽습니다. e-Tax 제출의 경우 Claude in Chrome, Playwright 또는 Antigravity를 통해 브라우저 입력을 자동화합니다. /tax-advisor 스킬은 LLM을 사용하여 세금 질문에 답변하고, /furusato는 후루사토 납세 기부를 처리합니다. 여러 세금 제도(청색 신고, 간이 과세 등)를 지원하며 주식 거래나 부동산과 같은 지원되지 않는 경우에 대해 경고합니다.

대상자

소득세 또는 소비세 신고가 필요한 일본 거주자. 개인 사업자, 부업이 있는 직장인, 의료비 공제나 후루사토 기부가 있는 사람을 포함합니다. 비거주자, 백색 신고자, 주식·부동산·외국 세액 공제와 같은 복잡한 소득이 있는 사람은 대상이 아닙니다. 사용자는 AI 코딩 에이전트 사용에 익숙해야 하며 제출 전에 모든 출력을 검증해야 합니다. 이 도구는 명시적으로 책임을 부인합니다.

주요 기능

• 장부 기록부터 e-Tax 양식 작성까지 엔드투엔드 자동화
• SKILL.md 표준을 통한 40개 이상의 AI 코딩 에이전트와 호환
• 영수증, 원천징수 영수증, 청구서, 증명서의 OCR 기반 판독
• OCR 검증을 위한 두 개의 하위 에이전트를 사용한 이중 확인 기능
• 소득세, 소비세(2% 특례, 간이과세, 본세과세), 후루사토 기부, 주택담보대출 공제 지원
• 세금 신고는 사용자의 책임이라는 명확한 면책 조항