Skip to main content

moai-finance — 세무·결산·K-IFRS

moai-finance

한국 세법·회계 기준 6개 스킬을 제공합니다.

flowchart LR
    subgraph 세무회계["세무·회계"]
        A["tax-helper
원천징수·부가세"] B["financial-statements
K-IFRS 재무제표"] C["close-management
결산·정산"] end subgraph 분석["분석·조회"] D["variance-analysis
예실 분석"] E["court-auction-search
법원경매"] F["korean-stock-search
KRX 시세"] end style A fill:#eaeaea,stroke:#6e6e6e,color:#09110f style F fill:#e6f0ef,stroke:#144a46,color:#09110f

무엇을 하는 플러그인인가

moai-finance는 프리랜서 3.3% 원천징수, 종합소득세·부가가치세 신고, 홈택스 절차, K-IFRS 재무상태표·손익계산서·현금흐름표 작성, 월·분기·연간 결산과 4대보험 정산, 예산 대비 실적 분석까지 한국 기준 재무·세무 실무를 자동화합니다. 2026년 K-IFRS 제1118호 변경사항과 4대보험 요율·노동법 최신값이 반영되어 있습니다.

설치

  1. moai-core 설치 후 moai-finance 옆의 + 버튼을 눌러 설치합니다.
GitHub 저장소를 클론한 뒤 ~/.claude/plugins/에 배치합니다.

핵심 스킬 (6개)

스킬용도
tax-helper3.3% 원천징수, 종합소득세, 부가가치세, 홈택스 절차
financial-statementsK-IFRS 재무상태표·손익계산서·현금흐름표
close-management월·분기·연간 결산, 4대보험 정산, 급여 마감
variance-analysis예산 대비 실적, 매출·비용·이익 분산, KPI 추적
court-auction-search대법원 법원경매정보 매각공고·사건번호 단건 조회
korean-stock-searchKRX 상장 종목 검색·기본정보·일별 시세

한국 기준 최신화

  • 2026년 K-IFRS 제1118호 변경사항 반영
  • 4대보험 요율·노동법 최신값
  • 홈택스 신고 일정 자동 안내

대표 체인

월말 결산

close-management → xlsx-creator(결산표) → docx-generator(결산 보고서)

예실 분석 보고

variance-analysis → xlsx-creator → docx-generator → ai-slop-reviewer

빠른 사용 예

> 프리랜서 3.3% 원천징수 영수증 12장 합계 계산해줘. 종합소득세 예상 세액도.
> 이번 분기 재무상태표 K-IFRS 기준으로 엑셀로 만들어줘.

court-auction-search (법원경매 매각공고)

대법원이 운영하는 공식 법원경매정보(courtauction.go.kr)의 매각공고와 사건정보를 read-only로 조회합니다. 자산 처분·경매 투자·실사 검토에 사용합니다.

Throttling — 매우 중요

사이트는 자동화 호출에 매우 민감해 빠른 연속 조회 시 IP가 약 1시간 차단될 수 있습니다.

  • 호출 간 최소 2초 지연
  • 기본 세션 budget 10회
  • 차단 발생 시 자동 retry 금지(차단 연장 위험), 즉시 멈추고 사용자에게 안내

Honest framing (사용자에게 항상 알려야 할 사실)

  1. 데이터는 공고 시점 기준이며 정정·취하·연기로 변경될 수 있습니다.
  2. 실제 입찰 전에는 법원 원문을 재확인해야 합니다.
  3. 본 스킬은 read-only입니다. 입찰서 자동 작성·자동 제출은 절대 미지원.

데이터 출처와 크롤링 윤리 (HARD)

법원경매정보 사이트(courtauction.go.kr)는 공식 공개 OpenAPI를 제공하지 않습니다. 본 스킬은 사이트 내부 WebSquare JSON XHR endpoint를 직접 호출하는 방식이며, 사이트 공개 데이터를 사용자가 브라우저에서 보는 형태로 가공해 돌려줍니다.

  • 호출은 read-only이며 사이트 부하를 주지 않도록 호출 간 2초 지연 + 세션당 10회 budget을 강제합니다.
  • 자동화 호출이 부담스러우면 사이트 운영기관(법원행정처) 문의 후 사용을 권장합니다.
  • 한국 등기 관련 공식 OpenAPI가 필요하면 등기정보광장 (data.iros.go.kr)을 참고하세요(다른 도메인 — 등기 데이터, 경매 아님).

출처 어트리뷰션

본 스킬은 NomaDamas/k-skill (MIT) 의 court-auction-notice-search를 cowork에 포팅했습니다. 데이터는 대법원 법원경매정보 사이트의 공개 정보입니다.

korean-stock-search (KRX 시세)

KRX(한국거래소) 상장 종목 검색·기본정보·일별 시세를 조회합니다. moai-business의 DART(공시)를 보완하는 시세 데이터로 활용합니다.

지원 시장

KOSPI · KOSDAQ · KONEX

사용 측 준비

  • 사용자 측 KRX_API_KEY 발급 불필요 — NomaDamas hosted 프록시가 보유
  • self-host가 필요하면 KSKILL_PROXY_BASE_URL로 대체

데이터 갱신과 보유 기간

  • 갱신 주기: 일 1회 (영업일 하루 뒤 13시 이후 갱신, 예: 금요일 데이터는 차주 월요일)
  • 데이터 보유 기간: 2010년 이후
  • 실시간 호가·체결 미제공 — 일별 snapshot만 제공

Disclaimer (HARD)

본 스킬은 read-only 조회 전용이며 투자 자문이 아닙니다. 답변 말미에 “KRX 공식 데이터 기준 / 투자 조언 아님” 고지를 항상 남깁니다.

출처 어트리뷰션

본 스킬은 NomaDamas/k-skill (MIT) 의 korean-stock-search를 cowork에 포팅했습니다. 원 저작자 설계 참고는 jjlabsio/korea-stock-mcp 이며, 공식 데이터 출처는 KRX Open API 입니다.

다음 단계


Sources