dosimto 저장소

dart-mcp-사용법

💡 dart-mcp를 소개합니다. 클로드에 dart-mcp를 연결해두면 OpenDART와 금융위·국토부 공공데이터를 통해 클로드가 DART에 있는 감사보고서와 재무정보를 바탕으로 대답해줍니다. 특히 정형 API가 빈약한 비상장 외감법인의 감사보고서 원문을 직접 파싱해 다년 재무 워크페이퍼를 만들어 줍니다.

MCP를 연결하면, 클로드가 진짜 재무정보로 대답합니다

혹시 클로드(Claude)에게 특정 회사의 재무정보나 감사보고서 내용을 물어본 적 있으신가요? 답은 그럴듯하게 돌아오는데, 자세히 보면 좀 이상하죠. "있을 법한" 문장을 지어낸 것이기 때문입니다. 감사·실사처럼 한 글자가 틀리면 안 되는 일에선 이대로 쓸 수가 없습니다.

그렇다고 OpenDART에서 제공하는 정형 API만 의존하기에는 한계가 큽니다. 상장사는 재무 데이터가 잘 갖춰져 있지만, 비상장 외감법인은 정형 재무 데이터 자체가 거의 없습니다. 결국 사람이 감사보고서를 한 해씩 열어 손익·재무상태·보유세 주석을 눈으로 긁어 엑셀에 옮겨야 했습니다.

이 간극을 메우려고 dart-mcp를 만들었습니다. 클로드에 DART 원문(document.xml)을 직접 읽고 파싱하는 도구를 붙여, 회사명만 대면 다년 비교표가 떨어지게 했습니다. 모든 값은 자동추출값이며, 셀마다 원문 출처 링크가 따라붙습니다.

💡 MCP가 뭔가요? MCP(Model Context Protocol)는 클로드 같은 AI에 외부 도구와 데이터를 붙이는 표준 규격입니다. 클로드 입장에선 "손과 눈"을 다는 일이고, 한번 연결해두면 평소 대화하듯 한국어로 시키기만 하면 됩니다.

클로드에 연결하는 법

클로드 웹/데스크톱 모두 동일합니다. 한 번만 등록하면 핸드폰 앱에서도 같이 잡힙니다.

  1. 클로드 → **설정(Settings) → 커넥터(Connectors)**로 들어갑니다.

  2. **"커스텀 커넥터 추가"**를 누릅니다.

  3. 이름은 아무거나(예: dart-mcp), 주소는 아래를 넣습니다.

    https://dart-mcp.dosimto.com/mcp

  4. 추가하면 끝입니다. 대화창에서 평소처럼 질문하면, 클로드가 알아서 dart-mcp의 도구를 골라 씁니다.

활용 사례

평소 DART를 직접 조회해야 했던 것을 클로드를 통해 말로 시킬 수 있습니다.

회사 찾기 — dart_resolve_company

💡 상호 일부만으로 후보 회사를 고유번호·상장여부와 함께 찾습니다. 비상장 외감은 종목코드가 빈값으로 표시됩니다.

"삼성전자 corp_code 찾아줘"

감사보고서 목록 + 감사인 변동 — dart_list_audit_reports

💡 기간을 주면 연도별 감사보고서를 1건씩(정정공시 우선) 정리하고, 제출 감사인도 함께 보여줍니다. 감사인이 자주 바뀌었다면 한눈에 드러납니다.

"삼성전자 최근 5개년 감사보고서 목록이랑 감사인 누구였는지 정리해줘"

다년 재무 워크페이퍼 — dart_build_workpaper

💡 손익계산서·재무상태표 주요계정·보유세를 여러 해 비교표(3단 그리드)로 만듭니다. 본표·주석의 표기 단위(원·천원·백만원)를 읽어 원으로 환산하고, 금융위 데이터와 교차검증합니다. 셀마다 원문 링크가 붙습니다.

"삼성전자 최근 5개년 손익·재무상태·보유세 워크페이퍼 만들어줘"

주석 검토 — dart_get_notes

💡 하나의 도구로 보유세(세금과공과)·특수관계자 거래·약정·우발부채·이연법인세·재평가·차입금 주석을 원표 구조 그대로 뽑습니다.

"삼성전자 특수관계자 거래랑 보유세 주석 뽑아줘"

감사의견 · 핵심감사사항(KAM) — dart_get_audit_opinion

💡 감사의견 단락과 핵심감사사항(KAM) 본문을 추출합니다. 의견유형은 키워드 추정값이므로 원문 확인 안내가 함께 옵니다.

"네이버 최근 감사의견이랑 핵심감사사항 정리해줘"

계속기업 불확실성 — dart_get_going_concern

💡 계속기업 가정 관련 중대한 불확실성(강조사항) 기재 여부와, 자본잠식·당기순손실 같은 재무 정량 징후를 함께 검토합니다.

"(주)○○ 최근 3개년에 계속기업 강조사항이 기재됐는지 알려줘"

내부회계관리제도 · 중요한 취약점 — dart_get_internal_control

💡 내부회계관리제도 감사/검토 의견과 중요한 취약점 단락을 추출합니다. 비상장 외감은 검토(또는 면제)일 수 있습니다.

"(주)○○의 내부회계관리제도 의견이랑 중요한 취약점 내용 알려줘"

감사인 프로파일 — dart_get_audit_profile

💡 매 사업연도별 감사인명·감사의견·감사보수·감사시간·비감사보수, 외부조회/재고실사/금융자산실사 수행여부를 조회합니다.

"SK하이닉스 최근 5개년 감사인 누구고, 감사보수·감사시간 알려줘"

지배구조 — dart_get_group_structure

💡 금융위 정형 데이터로 기업개요·계열회사·연결대상 종속기업을 정리합니다.

"현대차 계열회사랑 연결 종속기업 정리해줘"

건축물대장 — bldrgst_expos_area 외

💡 지번(또는 19자리 PNU)을 주면 호실별 전유면적·공용면적을 용도별로 분해·집계합니다 — 딜 면적계산의 1차값. 표제부(연면적·건폐율·용적률)·층별개요·기본개요도 같은 방식입니다.

"○○구 ○○동 123-45 건물 호실별 전유·공용 면적 집계해줘"

등기부등본 PDF — deungi_parse

💡 IROS에서 받은 등기 PDF를 표제부(전유면적)·갑구(소유·신탁·지분·압류)·을구(근저당·전세권)로 구조화합니다. 말소선이 PDF 텍스트추출 시 소실되므로, 후순위 말소등기를 역추적해 현재 유효 권리를 추정합니다(원문 대조 경고 동반).

"이 등기 PDF에서 소유권·근저당·신탁 구조 뽑아줘"

믿고 쓰기 위한 장치

  • 자동추출값 — 모든 값은 자동추출값입니다. 최종 판단은 사람 몫이라는 전제를 시스템에 박았습니다.
  • 출처 동봉 — 셀·블록마다 DART 원문 보기 링크가 붙어, 클릭 한 번에 원문 대조가 됩니다.
  • 단위 자동 환산 — 본표·보유세 주석의 표기 단위(원·천원·백만원)를 읽어 원으로 통일합니다. 단위가 적혀 있지 않으면 임의 환산 없이 "확인 필요"로 표시합니다.
  • 교차검증 — 매출·영업이익·총자산 등을 금융위 데이터와 대사해 일치/불일치를 표시합니다. 단, 금융위 정형 데이터는 상장·대형 위주라 비상장 외감은 미수록일 수 있고, 그 경우 DART 원문이 유일 정본입니다.

데이터 출처

  • 금융감독원 전자공시(OpenDART) — 전자공시 원문·정형 데이터
  • 금융위원회·금융감독원 공공데이터(FSC) — 기업 재무·기본정보
  • 국토교통부 건축HUB — 건축물대장
  • 등기부등본 PDF — 사용자가 IROS에서 직접 열람·다운로드

본 도구는 데이터를 재배포하지 않으며, 발급받은 인증키로 각 기관 API를 직접 호출합니다. 데이터 이용은 각 기관 이용약관 및 관련 법규를 따릅니다.

면책

본 도구의 파싱·분류·플래그(재무·보유세·감사의견·계속기업·내부회계 취약점·면적·권리관계 등)는 자동 추출 결과이며, 감사·실사 판단이나 의사결정의 근거로 쓰기 전 반드시 원문과 교차 확인하시기 바랍니다.