{"_id":"korean-dart-mcp","_rev":"9-e586997dd36af3f57984aa5078f4f8a5","name":"korean-dart-mcp","dist-tags":{"latest":"0.10.3"},"versions":{"0.7.0":{"name":"korean-dart-mcp","version":"0.7.0","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.7.0","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"13ca665f4c65b21b8b6ea735037d77a960b82a90","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.7.0.tgz","fileCount":57,"integrity":"sha512-CQ9VPxFyqOduh0myVh322HUl9R9KLcjh2OdKFc31/e33gGQpmXB8Jo9qGwp94ftcPJ8gHEimwR3bmcyQ58UunA==","signatures":[{"sig":"MEUCIHXP5Hn+5CupzN+0vxjU4yHKSPmZuhF++MtrlY6GpJM8AiEA/cAAEdHNAr+DR8EIRyEM3ysNkIbOFSLadHCMUSPxcj0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":160222},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"f326bb94438bf685ecd9300966da73276dbda197","scripts":{"cli":"node build/cli.js","build":"tsc","start":"node build/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^2.4.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.7.0_1776463503530_0.7368202391218335","host":"s3://npm-registry-packages-npm-production"}},"0.7.1":{"name":"korean-dart-mcp","version":"0.7.1","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.7.1","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"f064dd35cc7c38d3f7bd8d132e2b40c01a179593","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.7.1.tgz","fileCount":57,"integrity":"sha512-cJYFrz7aH33jjaUTJaSUT5hJQucmOBNY1PAnrzB+KRw3FDfLJKbAN+JdC54awM9if10K34EFYtuWs3gTBcURYw==","signatures":[{"sig":"MEQCIBo8qSyLI6VzpvNpISmEilzVuzLGuNzPLHceuFGO8PkKAiBRIiVjnJpi/FPUY6vVs+asojTHiJJuDy0BEQWFM3fHRg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":167744},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"32a2e2fb8a1b509f0636c1f457a9ee371bda9788","scripts":{"cli":"node build/cli.js","build":"tsc","start":"node build/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^2.4.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.7.1_1776465638865_0.6414082459642374","host":"s3://npm-registry-packages-npm-production"}},"0.9.1":{"name":"korean-dart-mcp","version":"0.9.1","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.9.1","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"963b485b4cd731f2a4011897ef604de0db0cb1c7","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.9.1.tgz","fileCount":55,"integrity":"sha512-3JIaRrgi/gnt2ultAvKIm1mLxpewV0VBtGSVuXLcSMt5vooenP1Bg520tQHrHTS5ylDD/s9D/jyqSw7EJcYWLw==","signatures":[{"sig":"MEYCIQC81W9Q83sp7DETGTNFogTvqsLhpPBhzlFOVCRBy0v1dAIhAK47YmHSiYtdy2Py7mvbG0srpJ3qqdG/NXPUnuHjNWpn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":202532},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"8e73b73295af8ada69156e54a92bbfc1f4b692a0","scripts":{"cli":"node build/cli.js","build":"tsc","start":"node build/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^2.4.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.9.1_1776483032868_0.8538381735098939","host":"s3://npm-registry-packages-npm-production"}},"0.9.2":{"name":"korean-dart-mcp","version":"0.9.2","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.9.2","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"2f6bf3f4009edabd7d4a7954b04ec64c0b329f56","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.9.2.tgz","fileCount":57,"integrity":"sha512-hi/mHM+1ptSnbnHT+3mXXK79BAanvTmRPuLzXKXiFQMISkHc1XjKEuw+taz4ByJuV00cTXeaVax814eJ28zqtA==","signatures":[{"sig":"MEUCIQCZ0ZTxQwwXutGmMpcZAd6KC9O1yEpS1c+If+P5qiNVLwIgXU9/Gs8VAPpEyR0OBGth/mm6NoV+c4pKGzvOWzTVLl8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":228640},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"79c549b5c7b124630268b517a792d1e45cef2375","scripts":{"cli":"node build/cli.js","build":"tsc","start":"node build/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^2.4.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.9.2_1776597996237_0.3816341754176702","host":"s3://npm-registry-packages-npm-production"}},"0.9.3":{"name":"korean-dart-mcp","version":"0.9.3","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.9.3","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"119c172f61fc7ae1cd5ccad6bcdc01eec5c8dc78","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.9.3.tgz","fileCount":57,"integrity":"sha512-UZBR5pCA5Y413ibZ5AkiQB2lNg6AP4yaOcHWSRAprrq0dIXAY56k+3jXEkr2onxkUnozsaUHiPFttUb+iyUmmg==","signatures":[{"sig":"MEYCIQDSX7v5bpmQ4CLrOBdkD/WgFZ+H9aF7VDdFCqa1t4MM7wIhAInjIjY4rsm8d46hF7qPQ/fSc6BC4sDwztecpfWYJv9M","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":229119},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"c1671cec9cc3dba4d4b81abe1b9b1812b2258a71","scripts":{"cli":"node build/cli.js","build":"tsc","start":"node build/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^3.0.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.9.3_1781137099908_0.7091139269716407","host":"s3://npm-registry-packages-npm-production"}},"0.10.0":{"name":"korean-dart-mcp","version":"0.10.0","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.10.0","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"04e572d05a61bd23e7a4e20fdf6c5ed1c2eaa05c","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.10.0.tgz","fileCount":65,"integrity":"sha512-05oLl9XOKuwYHUFS4icgm/bc++203BpIkUg1dNkvUT1/KuRoOoCFMin25ib/3Y9ZANg2AeZn3eRh8j2HVpQ6iw==","signatures":[{"sig":"MEUCIQDMUmlt/VteeWpU8V+Vce3RcVeYp7gcImN6Ilt34+BUIAIgSg8c8Z7YLSVugVfVNAZX7hEFRHGnnS45aA4NqAroaf4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":251418},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"6e4f7a71bf1044ef2fedb7614e466bda86ba8e54","scripts":{"cli":"node build/cli.js","test":"vitest run","build":"tsc","start":"node build/index.js","watch":"tsc --watch","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"25.8.2","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^3.0.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.10","typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.10.0_1785075094252_0.6048902472249287","host":"s3://npm-registry-packages-npm-production"}},"0.10.1":{"name":"korean-dart-mcp","version":"0.10.1","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.10.1","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"b27c2ba1dfcb608488b16e8e28014684fbc35b95","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.10.1.tgz","fileCount":63,"integrity":"sha512-Xr2iOCms8g2a4zelBC4ej8Z+zKjTwjgKqrKJCg+G4tzIPnWX4pbRLpEB8T4h/Guh++3SfEdlcCuRA6pgusP5ng==","signatures":[{"sig":"MEYCIQDttF5J51iNb3dT49ilyR8agQK6t92gqhKsu4CAFGrDxgIhAKde47mLwQgk6rioYMkMrs4YBG9+ru6VM1/2HW5+nROP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":249250},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"bf61abb034bb8f3eb34ae5ef4aa4daf64bfc33e3","scripts":{"cli":"node build/cli.js","test":"vitest run","build":"tsc","start":"node build/index.js","watch":"tsc --watch","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"25.8.2","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^3.0.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^11.7.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.10","typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.10.1_1785075141667_0.6311206388126489","host":"s3://npm-registry-packages-npm-production"}},"0.10.2":{"name":"korean-dart-mcp","version":"0.10.2","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"author":{"name":"Chris"},"license":"MIT","_id":"korean-dart-mcp@0.10.2","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"dist":{"shasum":"7e78cecd45aa8e9eb6fb4e2f21737fd95ed63344","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.10.2.tgz","fileCount":63,"integrity":"sha512-Qh6KuL96i62n49ywYbfVeBW/QdhLz+GyMwWfCnuL8w/59Jd44G8TwpPJx7Mbfx9qkkMERh+lcUEl3kE5YATXWw==","signatures":[{"sig":"MEQCIGPTE8BiFtfbsN1F9oZR3voeFGjIKkj4DA2BNzEZXYgDAiAGcfENC8YBkbvHf2TBWjiM6DIAwd2FAyZe07LbKa+9AA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAC0bXsbhopU+BQTMq13NRp+ThbE6AYMoalMjbeyVY2BAiEA0uyjZLOqqiLg6VkJgHW/86QdPql7O6Eg0PMYr2gHASI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":260408},"main":"build/index.js","type":"module","types":"build/index.d.ts","engines":{"node":">=20.19.0"},"gitHead":"ca276aeef0a7037b6d9e855d325450a8a4b2c4ff","scripts":{"cli":"node build/cli.js","test":"vitest run","build":"tsc","start":"node build/index.js","watch":"tsc --watch","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"overrides":{"sharp":"^0.35.4","adm-zip":"^0.6.1"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"_nodeVersion":"26.10.0","dependencies":{"zod":"^3.25.76 || ^4.0.0","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^3.0.0","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^12.4.1","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.10","typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/korean-dart-mcp_0.10.2_1792280305864_0.19555483818154906","host":"s3://npm-registry-packages-npm-production"}},"0.10.3":{"_id":"korean-dart-mcp@0.10.3","bin":{"korean-dart":"build/cli.js","korean-dart-mcp":"build/index.js"},"bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"dist":{"shasum":"0f36f01e35de7075eb5bfab663af9f5eed1b9943","tarball":"https://registry.npmjs.org/korean-dart-mcp/-/korean-dart-mcp-0.10.3.tgz","fileCount":63,"integrity":"sha512-axTrI8f0mAwSOOK6Qzv5irEvK+06r4Q6Eg7abwxvQFiYq23EadYLZrtD/pShhQINyTNjZfy1mZYSrA39OlSGxg==","signatures":[{"sig":"MEQCIGeijnkEJGjpdId/UVo4ZbmXkRd5478NaY1xcGgGUPLuAiBJE1PWeIoxilkXQz6Xs6tcgsVIMOC/baEXjoXwN495yA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDXVmttJebZKRi3Zb+j+Em4sBXnZ1kHb8QHBDwGXT3K7AIgVg778a7izAozvZsn56Yp7Kdy1hArH/IWzSzDCDvdFDo="}],"unpackedSize":260397},"main":"build/index.js","name":"korean-dart-mcp","type":"module","types":"build/index.d.ts","author":{"name":"Chris"},"engines":{"node":">=20.19.0"},"gitHead":"be4619eb8e74479df81f82f11aa42ced05869937","license":"MIT","scripts":{"cli":"node build/cli.js","test":"vitest run","build":"tsc","start":"node build/index.js","watch":"tsc --watch","test:watch":"vitest","prepublishOnly":"npm run build"},"version":"0.10.3","_npmUser":{"name":"chrisryugj","email":"ryuseungin@naver.com"},"homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"overrides":{"sharp":"^0.35.4","adm-zip":"^0.6.1"},"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"_npmVersion":"11.19.1","description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","directories":{},"maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"_nodeVersion":"26.10.0","dependencies":{"zod":"^4.6.7","yauzl":"^3.2.0","dotenv":"^17.3.1","kordoc":"^4.24.8","commander":"^14.0.3","iconv-lite":"^0.7.2","pdfjs-dist":"^4.10.38","@xmldom/xmldom":"^0.9.8","better-sqlite3":"^12.4.1","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.12","typescript":"^5.9.3","@types/node":"^22.19.3","@types/yauzl":"^2.10.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/korean-dart-mcp_0.10.3_1792988639700_0.8898747658993416"}}},"time":{"created":"2026-04-17T22:05:03.420Z","modified":"2026-10-26T04:23:59.967Z","0.7.0":"2026-04-17T22:05:03.663Z","0.7.1":"2026-04-17T22:40:39.036Z","0.9.1":"2026-04-18T03:30:33.049Z","0.9.2":"2026-04-19T11:26:36.493Z","0.9.3":"2026-06-11T00:18:20.085Z","0.10.0":"2026-07-26T14:11:34.410Z","0.10.1":"2026-07-26T14:12:21.809Z","0.10.2":"2026-10-17T23:38:25.961Z","0.10.3":"2026-10-26T04:23:59.829Z"},"bugs":{"url":"https://github.com/chrisryugj/korean-dart-mcp/issues"},"author":{"name":"Chris"},"license":"MIT","homepage":"https://github.com/chrisryugj/korean-dart-mcp#readme","keywords":["mcp","mcp-server","dart","opendart","공시","전자공시","금융감독원","claude","model-context-protocol","finance-ai","korean-stocks","xbrl"],"repository":{"url":"git+https://github.com/chrisryugj/korean-dart-mcp.git","type":"git"},"description":"OpenDART 83개 API → 15개 MCP 도구. 금융감독원 전자공시(DART)를 AI로 검색·조회·분석","maintainers":[{"name":"chrisryugj","email":"ryuseungin@naver.com"}],"readme":"# Korean DART MCP\n\n**OpenDART 83개 API를 15개 도구로.** 공시·재무·지분·XBRL + **버핏급 애널리스트 프레임(내부자 시그널·회계 리스크·퀄리티 체크리스트)** + **HWP/PDF 첨부 마크다운화**를 AI 어시스턴트에서 바로 사용.\n\n[![npm version](https://img.shields.io/npm/v/korean-dart-mcp.svg)](https://www.npmjs.com/package/korean-dart-mcp)\n[![MCP 1.27](https://img.shields.io/badge/MCP-1.27-blue)](https://modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n> 금융감독원 [OpenDART](https://opendart.fss.or.kr/) 전자공시 기반 MCP 서버 + CLI. Claude Desktop, Cursor, Windsurf, Claude Code 등에서 바로 사용 가능.\n\n자매 프로젝트: [korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp) (법제처 41 API → 15 도구)\n\nEnglish documentation → [README-EN.md](README-EN.md)\n\n---\n\n## ⚡ 30초 설치 — 한 줄로 끝\n\n**macOS / Linux / Windows 공용**. Node.js 20.19+ 만 깔려있으면 됩니다.\n\n```bash\nnpx -y korean-dart-mcp setup\n```\n\n대화형 마법사가 띄웁니다:\n1. OpenDART 인증키 입력 (없으면 Enter — 나중에 설정 가능, [여기서 무료 발급](https://opendart.fss.or.kr/))\n2. 사용 중인 AI 클라이언트 번호 선택 (Claude Desktop / Cursor / Claude Code / Windsurf / VS Code / Gemini CLI / Zed / Antigravity — 설치된 건 `[감지됨]` 표시)\n3. 설정 파일 자동 패치 → 클라이언트 재시작\n\nWindows 도 자동으로 `cmd /c npx` 래핑해줘서 `npx not found` 이슈 해결됨. 수동 JSON 편집 불필요.\n\n> 수동 설정을 원하면 아래 [설치 및 사용법](#설치-및-사용법) 섹션 참고.\n\n---\n\n## v0.9 — 무엇이 새로운가\n\n- **`get_xbrl format=\"markdown_full\"`** — presentation/calculation linkbase 를 파싱해 **전체 계정 + 계층 구조 + 합산 검증**. 기존 `markdown` 의 whitelist 50태그 대비 BS 50+ / IS 15+ / CF 10+ 전부 커버. 금융지주 `DX` prefix 등 업종별 택소노미 자동 대응. 6MB XBRL → ~30-60KB 마크다운.\n- **`search_disclosures` 90일 자동분할** — `corp_code` 미지정 + 기간 90일 초과 시 자동으로 90일 청크 분할 (OpenDART \"전체시장 3개월 제약\" 우회). 최대 40 chunks(≈10년).\n- **`insider_signal` / `disclosure_anomaly` `summary_text`** — 한국어 자동 요약문 필드 추가. LLM 이 원시 테이블 뽑기 전 한 줄로 맥락 파악.\n- **보안 하드닝** (v0.9.1) — ZIP slip / ZIP bomb 방어 공용 헬퍼, HTTPS 뷰어 스크래핑, chunks 상한, presentation 재귀 depth 가드, XBRL 파싱 경고 노출.\n\n---\n\n## 💡 주식에 관심 많은 일반인이 쓸 수 있는 5가지\n\n증권사 앱만으론 아쉬운 **개미 투자자 기준** 킬러 유스케이스. Claude 에게 프롬프트로 그냥 말하면 됨.\n\n### 1. 내 보유종목 \"경영진 눈치게임\"\n\n```\n\"삼성전자 최근 1년 임원·대주주 매수/매도 보고 어때?\"\n```\n\n→ `insider_signal` 이 매수 vs 매도 **클러스터 시그널**로 집계. 실측: 매수 2,429 vs 매도 43 → `strong_buy_cluster` (경영진이 자기 돈으로 사고 있음).\nHTS 에선 공시 하나하나 뒤져야 알 수 있는 것을 한 줄 프롬프트로.\n\n### 2. \"이 회사 회계 뭐 수상한 거 없나\"\n\n```\n\"카카오 최근 3년 회계 리스크 점수 뽑아줘\"\n```\n\n→ `disclosure_anomaly` 로 **0-100 스코어 + verdict**(clean/watch/warning/red_flag). 실측: 카카오 40점 `warning` — 정정공시 32.8% 가 임계 초과. 개인이 수동으로 확인 불가능한 리스크 플래그를 자동 탐지.\n\n### 3. \"사업보고서 300쪽 읽기 싫어\"\n\n```\n\"삼성전자 2023 사업보고서에서 '위험요소'·'주요 사업' 섹션 요약\"\n```\n\n→ `get_attachments(mode=\"extract\")` 가 PDF 2.2MB → 마크다운 92만 자로 변환 (3.7초). Claude 가 섹션별로 직접 검색·요약. **증권사 리포트 없이도 원본 읽기 가능**.\n\n### 4. \"오늘 이런 공시 낸 회사 누구?\"\n\n```\n\"최근 30일 자기주식 취득 결정한 상장사 전부\"\n\"최근 일주일 유상증자·CB 발행 공시 회사\"\n\"최근 30일 합병·분할 결정 공시\"\n```\n\n→ `search_disclosures(preset=...)` 22개 프리셋. 자기주식 취득 = 주가 부양 시그널 / 유상증자·CB = 희석 경계. 실측: 최근 30일 자기주식 취득 **59건**. HTS 에서 놓치는 배치 정보를 한 번에.\n\n### 5. \"A랑 B 중 뭐가 더 튼튼해\"\n\n```\n\"삼성전자 · SK하이닉스 · LG전자 5년 ROE·부채·성장성 비교\"\n```\n\n→ `buffett_quality_snapshot(corps=[...])` 이 5지표 자동 랭킹. 실측 (위 [실전 시나리오 1](#1-버핏식-5년-퀄리티-비교--자동-랭킹) 표 참고): SK하이닉스 3/4 체크 통과, 부채 안정성은 삼성 압도적. **종목 고를 때 감각 의존 대신 수치 근거**.\n\n---\n\n### 이런 사람에게 딱\n\n- 본인 **보유 종목 5-20개** 있고 분기·반기마다 공시 점검하는 **중급 개미**\n- 뉴스 해석 말고 **원본 공시** 직접 보고 싶은 사람 (기자 편향 싫어하는 타입)\n- 네이버 금융·HTS 정보 부족해서 답답한 사람\n- 증권사 리포트 안 사고 **직접 기업 분석**하고 싶은 사람\n\n### 이런 사람한텐 오버스펙\n\n- **차트 보고 들어가는 단타** — 이 도구엔 차트·실시간 주가 없음\n- **코스피 ETF 만 사는 장투** — 개별 종목 분석 필요 없음\n- **Excel·Python 으로 DataFrame 돌리는 퀀트** — OpenDartReader·dart-fss 가 나음 (pandas 네이티브)\n\n### 솔직한 진입 장벽\n\n- Claude Desktop / Cursor 설치 + OpenDART 키 발급 (**10분**, 무료, 일 20,000건)\n- ROE · CAGR · 부채비율 용어는 알아야 결과 이해 가능\n- Claude Pro 구독 $20/월 (대용량 PDF 요약엔 컨텍스트 넉넉한 상위 플랜이 편함)\n- 이 도구는 **리서치 보조용**. 투자 판단은 본인이.\n\n---\n\n## 실전 시나리오 — 실제 API 호출 결과\n\n아래 결과는 실제 DART API 를 때려 얻은 **실측값**. 전부 `scripts/showcase-v0_9_1.mjs` 로 재현 가능 (12/12 PASS).\n\n### 1. 버핏식 5년 퀄리티 비교 + 자동 랭킹\n\n**프롬프트**: *\"삼성전자·SK하이닉스·LG전자 최근 5년 퀄리티 지표 비교해줘\"*\n\n→ `buffett_quality_snapshot(corps=[\"삼성전자\",\"SK하이닉스\",\"LG전자\"], years=5)`\n\n| 기업 | 평균 ROE | 최근 D/E | 매출 CAGR | 순이익 CAGR | 체크리스트 |\n|---|---:|---:|---:|---:|---:|\n| 삼성전자 | 10.39% | **29.94%** | 4.51% | 3.17% | 1/4 |\n| SK하이닉스 | **12.86%** | 45.95% | **22.6%** | **45.37%** | **3/4** |\n| LG전자 | 5.37% | 140.33% | 4.81% | -3.63% | 0/4 |\n\n**자동 생성 랭킹** (5지표별):\n- ROE: SK하이닉스(12.86) > 삼성전자(10.39) > LG전자(5.37)\n- 부채 안정성: 삼성전자(29.94) > SK하이닉스(45.95) > LG전자(140.33)\n- 순이익 CAGR: SK하이닉스(45.37) > 삼성전자(3.17) > LG전자(-3.63)\n- ROE 일관성 (stddev ↓): LG전자(2.09) > 삼성전자(3.91) > SK하이닉스(18.44)\n\n### 2. 경영진이 본인 돈으로 매수하고 있는가 (insider_signal)\n\n**프롬프트**: *\"삼성전자 최근 1년 내부자 거래 매수/매도 클러스터\"*\n\n→ `insider_signal(corp=\"삼성전자\", start=\"2025-04-18\", end=\"2026-04-18\")`\n\n```\n삼성전자: 2,473건 보고 (매수 2,429 / 매도 43).\n고유 매수자 1,047명 vs 매도자 40명, 순매수 +2,302,375주.\n→ strong_buy_cluster 시그널.\n최강 클러스터: 2026Q1 (매수 985명/매도 18명).\n```\n\n버핏 철학의 *\"경영진이 본인 돈으로 매수하는가\"* 를 한 호출로 정량화. 최근 24:1 매수 우세.\n\n### 3. 회계·거버넌스 리스크 스코어 (disclosure_anomaly)\n\n**프롬프트**: *\"카카오 최근 3년 회계 리스크\"*\n\n→ `disclosure_anomaly(corp=\"카카오\")`\n\n```\n카카오 (2023-04~2026-04): ⚠️ 경고, 점수 40/100\n- 정정공시 167/509건 (32.8%)  ← 임계(20%) 초과로 +30점\n- 자본 스트레스 공시 5건       ← +10점\n- verdict: warning\n```\n\n정정공시·감사인 교체·비적정 의견·자본 스트레스 4개 축을 0-100 스코어로 집계 + 개별 flag 의 evidence 구조화. LLM 은 스토리만 만들면 됨.\n\n### 4. XBRL 전체 계정 + 계산 검증 (v0.9 markdown_full)\n\n**프롬프트**: *\"삼성전자 2023 사업보고서 재무제표 전체 계정 뽑아줘\"*\n\n→ `get_xbrl(rcept_no=\"20240312000736\", format=\"markdown_full\")`\n\n```\n기간: 당기 2023-12-31 / 전기 2022-12-31 / 전전기 2021-12-31\n계정 수: BS 52행 · IS 18행 · CF 12행 (whitelist 모드의 17/13/7행 대비 3배)\n마크다운 크기: 8,905자 (원본 XBRL 6MB → 99.85% 절감)\n계산 검증: ✅ 모두 일치 (0 건 위반)\ntaxonomy roles: presentation 10개 · calculation 8개\n소요: 615ms\n```\n\n**계산 검증 자동화**가 핵심 — calculation linkbase 의 `summation-item` 관계로 \"부모=자식 합산\"을 검증해서 공시 오기재를 즉시 탐지.\n\n### 5. 업종별 택소노미 자동 대응 (금융지주)\n\n**프롬프트**: *\"신한지주 최신 사업보고서 재무제표 전체\"*\n\n→ 내부적으로 `search_disclosures` 로 rcept_no 찾고 → `get_xbrl(format=\"markdown_full\")`\n\n```\n신한지주 2025 사업보고서 (rcept_no=20260318000826)\nBS 44행 · IS 49행\n계산 검증 위반: 3건 (금융업 특유 항목)\n→ DX prefix (금융지주 전용) taxonomy 를 코드 변경 없이 자동 처리\n```\n\ndart-fss 도 XBRL ZIP 은 받지만 **금융업 DX prefix 택소노미 자동 대응은 문서에 명시되어있지 않음**. 업종별 커버리지는 이 MCP 의 강점.\n\n### 6. 최근 30일 자기주식 취득 결정 상장사 전수\n\n**프롬프트**: *\"최근 30일 자기주식 취득 결정한 상장사 전부\"*\n\n→ `search_disclosures(preset=\"treasury_buy\", days=30, limit=500)`\n\n```\n매칭 공시 59건 / 8페이지 병렬 수집 (17.5초)\n\n최신 5건:\n  2026-04-17 티플랙스 — 자기주식취득신탁계약해지결정\n  2026-04-17 엠투엔 — 자기주식취득결정\n  2026-04-17 PS일렉트로닉스 — 자기주식취득신탁계약해지결정\n  2026-04-15 아세아 — 자기주식취득신탁계약해지결정\n  2026-04-15 아세아시멘트 — 자기주식취득신탁계약해지결정\n```\n\n22개 프리셋이 `pblntf_ty` + `report_nm` 정규식을 자동 조립. LLM 이 DART 코드를 외울 필요 없음.\n\n### 7. 전체시장 180일 공시 (90일 자동분할, v0.9)\n\n**프롬프트**: *\"최근 6개월 사업보고서 낸 회사 전부\"*\n\n→ `search_disclosures(preset=\"annual_report\", days=180)`\n\n```\n자동분할: 3 chunks (DART '전체시장 3개월' 제약 자동 우회)\n총 수집 6,000건 → 사업보고서 매칭 2,625건 (10.3초)\n\n최신 3건:\n  2026-01-09 미라셀 사업보고서 (2024.12)\n  2026-01-08 케이원제15호판교위탁관리부동산투자회사 사업보고서 (2025.10)\n  2026-01-08 삼성FN리츠 사업보고서 (2025.10)\n```\n\n### 8. 자본 이벤트 타임라인 (카카오 3년)\n\n**프롬프트**: *\"카카오 최근 3년 자본 이벤트 전부\"*\n\n→ `get_corporate_event(corp=\"카카오\", mode=\"timeline\", start=\"2023-04-18\", end=\"2026-04-18\")`\n\n| 이벤트 유형 | 건수 |\n|---|---:|\n| 자기주식 처분 | 14 |\n| 감자 | 3 |\n| 합병 | 2 |\n| CB 발행 | 1 |\n| EB 발행 | 1 |\n| **합계** | **21** |\n\n36개 이벤트 enum 을 한 번에 병렬 수집 → 날짜순 통합. LLM 이 \"카카오가 최근 뭘 했는지\" 즉시 파악.\n\n### 9. 지분공시 통합 (5%룰 + 임원 지분)\n\n**프롬프트**: *\"삼성전자 최근 3년 지분 변동 전부\"*\n\n→ `get_major_holdings(corp=\"삼성전자\")`\n\n```\nmajorstock(5%룰): 41건 — 최근: 삼성물산 19.70% (2026-04-17)\nelestock(임원·주요주주): 200건 반환 (2,615건 중 최근순)\n기간: 2023-04-18 ~ 2026-04-18\n```\n\n두 엔드포인트(majorstock + elestock)를 한 호출로 합성 — Python 래퍼는 두 번 호출 + pandas merge 필요.\n\n### 10. 단일기업 버핏 체크리스트 (근거 포함)\n\n**프롬프트**: *\"삼성전자 6년 버핏 체크리스트\"*\n\n→ `buffett_quality_snapshot(corps=[\"삼성전자\"], years=6)`\n\n```\n삼성전자 2020~2025:\n- ROE 평균 10.26% (min 4.26 / max 15.69 / stddev 3.58)\n- D/E 최근 29.94% / 평균 31.11%\n- 매출 CAGR 7.09% · 순이익 CAGR 11.35%\n\n체크리스트 3/4:\n  ❌ consistent_high_roe (모든 연도 ROE ≥ 15%)\n  ✅ low_debt         (최근 부채비율 ≤ 100%)\n  ✅ growing_revenue  (매출 CAGR ≥ 5%)\n  ✅ growing_earnings (순이익 CAGR ≥ 5%)\n```\n\n### 11. 공시 원문 마크다운 (DART XML → MD)\n\n**프롬프트**: *\"삼성전자 최근 자기주식 취득 결정 공시 원문\"*\n\n→ `search_disclosures(preset=\"treasury_buy\")` 로 rcept_no 찾고 → `download_document(format=\"markdown\")`\n\n```\n원본: 2026-03-18 주요사항보고서(자기주식취득결정)\n원본 XML 32,618자 → 마크다운 2,272자 변환 (93% 절감)\n# 주요사항보고서(자기주식 취득 결정) / 삼성전자\n## 자기주식 취득 결정\n| 1. 취득예정주식(주) | 보통주식 | ...\n| 3. 취득예상기간 | 시작일 | 2026년 03월 19일 |\n```\n\nDART 전용 XML(`dart4.xsd`)을 자체 파서로 heading·테이블 보존 마크다운으로.\n\n### 12. 사업보고서 첨부 → 마크다운 본문\n\n**프롬프트**: *\"삼성전자 2023 사업보고서 PDF 본문\"*\n\n→ `get_attachments(rcept_no=\"20240312000736\", mode=\"extract\", index=0)`\n\n- PDF 첨부 2.2MB → **921,998자 마크다운 (3.7초)**. LLM 이 \"위험요소\" 섹션을 직접 검색해 요약 가능.\n- [kordoc](https://github.com/chrisryugj/kordoc) 엔진 (HWP/HWPX/PDF/DOCX/XLSX 통합) — **OpenDartReader·dart-fss·기존 DART MCP 6종 어디에도 없는 기능**.\n\n---\n\n## 기존 DART 도구와의 차별점\n\n한국 DART 생태계 조사 결과 (2026-04-18 기준):\n\n| 기능 | OpenDartReader (438⭐, Python) | dart-fss (364⭐, Python) | hypn4/opendart-fss-mcp (85 도구) | RealYoungk/opendart-mcp (83 도구) | **korean-dart-mcp (15 도구)** |\n|---|:---:|:---:|:---:|:---:|:---:|\n| MCP 네이티브 | ❌ | ❌ | ✅ | ✅ | ✅ |\n| **Node.js/TypeScript (npm)** | ❌ | ❌ | ❌ | ❌ | ✅ **(유일)** |\n| 엔드포인트 1:1 커버리지 | 대부분 | 공시+재무 | 85개 전부 | 83개 전부 | 83→15 enum 압축 |\n| 회사명 자동 해결 | 부분 | 부분 | ✅ (오타·초성) | ✅ | ✅ (SQLite FTS 선적재) |\n| XBRL presentation/calculation linkbase | ❌ | ZIP만 | ZIP+taxonomy | ZIP만 | ✅ **자동 markdown + 계산 검증** |\n| HWP/PDF 첨부 → 마크다운 | ❌ | ❌ | ❌ | ❌ | ✅ **(유일, kordoc)** |\n| `insider_signal` 클러스터 | ❌ | ❌ | ❌ | ❌ | ✅ **(유일)** |\n| `disclosure_anomaly` 0-100 스코어 | ❌ | ❌ | ❌ | ❌ | ✅ **(유일)** |\n| `buffett_quality_snapshot` 체크리스트 | ❌ | ❌ | ❌ | ❌ | ✅ **(유일)** |\n| 90일 자동분할 · 페이지 병렬화 | ❌ | ❌ | ❌ | ❌ | ✅ |\n| ZIP slip/bomb 방어 | n/a | n/a | ❌ | ❌ | ✅ |\n\n### 포지셔닝 한 줄\n\n> **Python 래퍼(OpenDartReader · dart-fss)** 는 \"quant·백테스터가 Jupyter 에서 DataFrame 으로 쓰는 용\",\n> **기존 Python DART MCP 6종**은 \"LLM 이 DART 원시 JSON 을 그대로 받아보는 용\",\n> **이 프로젝트**는 한국 DART 생태계에서 **유일하게 LLM 네이티브로 설계된 Node.js MCP** — 83 API 를 15 enum 으로 압축하고, XBRL 완전 파싱 · HWP/PDF 마크다운화 · 내부자/어노말리/버핏 애널리스트 프레임을 **기본 탑재한 유일한 서버**.\n\n### 정직한 약점\n\n- **엔드포인트 1:1 커버리지는 hypn4 (85 도구) / RealYoungk (83 도구) 가 더 넓음** — 희귀 엔드포인트 직접 호출이 필요하면 그쪽이 낫다. 이 프로젝트는 **83→15 압축**이라 자주 쓰는 조합을 제외한 엣지 엔드포인트는 제공하지 않음.\n- 한국 DART MCP 시장 전체가 작아서 (최대 9⭐ · 2026-04 기준) 생태계 자체가 아직 초기.\n\n---\n\n## v0.7.0 — LLM 네이티브 분석 레이어\n\nDART 83 API 를 LLM 이 **스토리로 해석 가능한 분석 프레임**으로 가공해서 넘깁니다. 아래는 대표적인 네 가지 사용 시나리오.\n\n### 버핏·그레이엄 관점 정량화\n\n```\n\"삼성전자 임원 거래 최근 2년 매수/매도 클러스터 분석해줘\"\n```\n\n→ `insider_signal` 한 번으로:\n\n- 매수 보고 103건 (고유 임원 103명)\n- 매도 보고 4건 (고유 임원 4명)\n- 시그널: **`strong_buy_cluster`** (매수/매도 비율 25:1)\n- 분기별 클러스터: 2024Q1 `buy_cluster` (n=42, net +380만주) → 2024Q2 `buy_cluster` (n=31, net +210만주) ...\n\n버핏 철학의 \"경영진이 본인 돈으로 매수하는가?\" 를 데이터로 굳혀 LLM 에 넘깁니다.\n\n### N년 퀄리티 체크리스트 + 피어 비교\n\n```\n\"삼성전자·SK하이닉스·LG전자 5년 퀄리티 비교\"\n```\n\n→ `buffett_quality_snapshot(corps=[...])`:\n\n| 기업 | 평균 ROE | D/E | 매출 CAGR | 순이익 CAGR | 체크리스트 |\n|---|---:|---:|---:|---:|---:|\n| SK하이닉스 | 12.86% | 45.95% | 22.6% | 45.37% | **3/4** |\n| 삼성전자 | 10.39% | **29.94%** | 4.51% | 3.17% | 1/4 |\n| LG전자 | 5.37% | 140.33% | 4.81% | -3.63% | 0/4 |\n\n- ROE 랭킹: **SK하이닉스 > 삼성전자 > LG전자**\n- 부채 안정성 랭킹: **삼성전자 > SK하이닉스 > LG전자**\n- ROE 일관성 (stddev): LG전자(2.09) > 삼성전자(3.91) > SK하이닉스(18.44)\n\n### 회계·거버넌스 리스크 스코어\n\n```\n\"카카오 최근 3년 회계 리스크 스코어\"\n```\n\n→ `disclosure_anomaly`:\n\n- 정정공시 비율, 감사인 교체 이력, 감사의견 비적정, 자본 스트레스 이벤트 빈도를 **0-100 스코어**로 집계\n- `verdict: clean / watch / warning / red_flag`\n- 각 flag 의 근거(evidence) 구조화\n\n### HWP/PDF 첨부를 LLM이 직접 읽음\n\n```\n\"삼성전자 2023 사업보고서 본문에서 '위험요소' 섹션 요약해줘\"\n```\n\n→ `get_attachments(mode=extract)`:\n\n- DART 뷰어 HTML 스크래핑으로 첨부 목록 조회\n- [kordoc](https://github.com/chrisryugj/kordoc) 엔진으로 HWP/HWPX/PDF/DOCX/XLSX → 마크다운 변환\n- 삼성전자 2.2MB PDF 사업보고서 → **921,998 자 마크다운 (3.7초)**. LLM 이 원문 전체를 컨텍스트로 읽고 분석\n\nDART XML 원문(`download_document(format=markdown)`) 도 자체 파서로 heading/테이블 보존된 마크다운 변환.\n\n---\n\n## 왜 만들었나\n\n한국 상장사 약 3,000개의 공시·재무가 [DART](https://dart.fss.or.kr) 한 곳에 모여 있지만, 개발자가 쓰려면 83개 엔드포인트를 직접 조합해야 합니다. 다행히 한국 개발자 생태계에는 [OpenDartReader](https://github.com/FinanceData/OpenDartReader)(438⭐) 와 [dart-fss](https://github.com/josw123/dart-fss)(364⭐) 라는 훌륭한 Python 래퍼가 있어, **엔드포인트 매핑·XBRL 파싱 노하우가 이미 정리돼 있습니다**. 이 프로젝트도 그 매핑을 상당 부분 그대로 수용했습니다.\n\n이 프로젝트는 두 래퍼가 커버하지 못하는 **다른 레이어**를 목표로 합니다:\n\n- **pandas 생태계용** — OpenDartReader / dart-fss. DataFrame 으로 분석가가 직접 핸들링.\n- **LLM 네이티브용** — 이 프로젝트. raw 테이블을 **전문가가 쓰는 각도**(버핏 체크리스트·내부자 시그널·회계 리스크 스코어·공시 타임라인·마크다운 원문)로 한 번 더 정제해, AI 어시스턴트가 바로 스토리를 만들 수 있게 합니다.\n\n둘은 **보완 관계**입니다. DataFrame 이 필요하면 Python 래퍼, AI 에이전트용 프레임이 필요하면 이 MCP.\n\n---\n\n## 설치 및 사용법\n\n### 0단계: API 키 발급 (무료, 1분)\n\n모든 방법에 공통으로 **OpenDART 인증키**가 필요합니다.\n\n1. [OpenDART 가입 페이지](https://opendart.fss.or.kr/uss/umt/cmm/EgovMberInsertView.do) 에서 회원가입\n2. 로그인 후 [인증키 신청](https://opendart.fss.or.kr/mng/apiUsageStatusView.do) → 이메일로 **40자 인증키** 즉시 수신\n3. 이 인증키를 아래 설정의 `DART_API_KEY` 에 넣습니다. 일 20,000건 무료.\n\n---\n\n### 방법 0: `setup` 마법사 (추천, 30초)\n\n```bash\nnpx -y korean-dart-mcp setup\n```\n\n대화형으로 API 키 입력 → 클라이언트 감지 → 설정 파일 자동 패치. macOS / Linux / Windows 공용. Windows 에선 `cmd /c npx` 래핑까지 자동 처리. 수동 JSON 편집 불필요.\n\n지원: Claude Desktop / Claude Code / Cursor / VS Code / Windsurf / Gemini CLI / Zed / Antigravity.\n\n> **`MODULE_NOT_FOUND` / `Cannot find module ...\\build\\index.js` 가 뜨면**: 과거에 깨진 글로벌 설치가 남아있는 상태입니다. 아래 중 하나로 해결:\n> ```powershell\n> # A. 글로벌 구버전 제거 후 재시도 (Windows/Mac/Linux 공통)\n> npm uninstall -g korean-dart-mcp\n> npx -y korean-dart-mcp@latest setup\n>\n> # B. 또는 글로벌 무시하고 항상 최신 받아오기\n> npx --yes --package=korean-dart-mcp@latest korean-dart-mcp setup\n> ```\n\n---\n\n### 방법 1: Claude Code 플러그인 (한 줄 설치)\n\n[Claude Code](https://docs.claude.com/en/docs/claude-code) 사용자는 marketplace 등록 후 `/plugin` 으로 설치하면 끝.\n\n```\n/plugin marketplace add chrisryugj/korean-dart-mcp\n/plugin install korean-dart\n```\n\n설치 시 OpenDART 인증키 입력 프롬프트가 뜸 (한 번만). 이후 15개 DART 도구 자동 활성화.\n\n---\n\n### 방법 2: Claude Desktop / Cursor / Windsurf (수동 설정)\n\n**사전 준비**: [Node.js 20.19.0 이상](https://nodejs.org) 설치 (LTS 권장).\n\n설정 파일에 아래 내용을 추가하세요 (`YOUR_API_KEY` 를 본인 키로 교체):\n\n**설정 파일 위치:**\n\n| 앱 | Windows | Mac |\n|---|---|---|\n| Claude Desktop | `%LOCALAPPDATA%\\Packages\\Claude_<publisher>\\LocalCache\\Roaming\\Claude\\claude_desktop_config.json` (아래 참고) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Cursor | 프로젝트 `.cursor/mcp.json` | 프로젝트 `.cursor/mcp.json` |\n| Windsurf | 프로젝트 `.windsurf/mcp.json` | 프로젝트 `.windsurf/mcp.json` |\n| Claude Code | `~/.claude.json` 또는 프로젝트 `.mcp.json` | `~/.claude.json` 또는 프로젝트 `.mcp.json` |\n\n> **Windows 경로 주의**: Claude Desktop 은 MSIX 패키지라 `%APPDATA%` 가 패키지 전용 위치로 리다이렉트됩니다. 앱이 실제로 읽는 파일은 `%LOCALAPPDATA%\\Packages\\Claude_<publisher>\\LocalCache\\Roaming\\Claude\\` 아래에 있고, `%APPDATA%\\Claude\\` 에 써 두면 앱이 읽지 않습니다. `npx korean-dart-mcp setup` 은 이 경로를 자동으로 찾습니다.\n\n**설정 내용:**\n\n```json\n{\n  \"mcpServers\": {\n    \"korean-dart\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"korean-dart-mcp\"],\n      \"env\": {\n        \"DART_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n저장 후 앱을 **재시작**하면 15개 DART 도구가 활성화됩니다.\n\n> 이미 다른 MCP 서버를 쓰고 있다면, `\"mcpServers\": { ... }` 안에 `\"korean-dart\": { ... }` 부분만 추가하세요.\n\n> **⚠️ Windows 사용자**: 위 설정으로 fail 이 뜨면 Claude Desktop 이 Windows PATH 의 `.cmd` 확장자를 해석하지 못해 `npx` 를 못 찾는 이슈입니다. 아래처럼 `cmd /c` 로 래핑하세요:\n>\n> ```json\n> {\n>   \"mcpServers\": {\n>     \"korean-dart\": {\n>       \"command\": \"cmd\",\n>       \"args\": [\"/c\", \"npx\", \"-y\", \"korean-dart-mcp\"],\n>       \"env\": { \"DART_API_KEY\": \"YOUR_API_KEY\" }\n>     }\n>   }\n> }\n> ```\n>\n> 그래도 안 되면: ① Node.js **20.19.0 이상** 설치 여부 확인 (`node --version`), ② 방화벽이 `opendart.fss.or.kr` 차단하는지 확인, ③ 첫 기동 시 corp_code 덤프(11.6만건, 약 5-10초) 다운로드 중이니 10초 정도 기다린 후 재시도.\n\n---\n\n### 방법 3: 내 컴퓨터에 직접 설치 (글로벌)\n\n```bash\nnpm install -g korean-dart-mcp\n```\n\n설정 파일에 `command` 를 바꿔 등록:\n\n```json\n{\n  \"mcpServers\": {\n    \"korean-dart\": {\n      \"command\": \"korean-dart-mcp\",\n      \"env\": {\n        \"DART_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n첫 실행 시 OpenDART 가 제공하는 **전체 기업 덤프(약 11.6만 건)** 를 내려받아 `~/.korean-dart-mcp/corp_code.sqlite` 에 FTS 인덱싱합니다 (약 5초, 24시간 TTL). 이후 회사명 / 종목코드 / corp_code 어느 형식으로 넘겨도 자동 해석됩니다.\n\n---\n\n### API 키 전달 방법\n\n| 방법 | 사용법 | 언제 쓰나 |\n|---|---|---|\n| 환경변수 | `DART_API_KEY=...` | Claude Desktop 등 설정 파일 |\n| `.env` 파일 | 프로젝트 루트 `.env` | 로컬 개발 |\n\n---\n\n## 사용 예시 — 킬러 프롬프트\n\n**기본 조회**\n```\n\"삼성전자 최근 분기 매출·영업이익, 전년 동기 대비 변화\"\n\"최근 30일 자기주식 취득 결정한 상장사 전부\"\n\"네이버 2023년 임원 보수 5억 이상 명단\"\n```\n\n**애널리스트 프레임**\n```\n\"삼성전자 임원 거래 최근 2년 매수/매도 클러스터 분석\"     → insider_signal\n\"카카오 최근 3년 회계 리스크 스코어 (정정·감사인·의견)\"   → disclosure_anomaly\n\"네이버 10년 버핏식 퀄리티 체크리스트\"                    → buffett_quality_snapshot\n\"삼성·SK하이닉스·LG전자 5년 퀄리티 비교 + 순위\"           → buffett_quality_snapshot(corps=[...])\n\"LG에너지솔루션 2021년 이후 자본 이벤트 타임라인 전부\"    → get_corporate_event(mode=timeline)\n```\n\n**원문 분석**\n```\n\"삼성전자 2023 사업보고서 PDF 본문에서 '위험요소' 섹션 요약\"   → get_attachments(mode=extract)\n\"삼성전자 자기주식 취득 결정 원본 XML 마크다운으로\"           → download_document(format=markdown)\n```\n\n**배치 조회**\n```\n\"최근 7일 자기주식 취득 결정 상장사 전부\"        → search_disclosures(preset=treasury_buy)\n\"최근 30일 전환사채·신주인수권부사채 발행 공시\"    → search_disclosures(preset=cb_issue, days=30)\n```\n\n---\n\n## 도구 구조 (15개)\n\n### 기본 조회 (7)\n| 도구 | 용도 |\n|---|---|\n| `resolve_corp_code` | 회사명 → corp_code (SQLite FTS 선적재, 전수 11.6만 건) |\n| `search_disclosures` | 공시 검색. `page` / `preset`(22종 자동필터) / `all_pages` **3모드** + 페이지 병렬화 + **90일 자동분할**(v0.9) |\n| `get_company` | 기업 개황 (업종·대표자·설립일) |\n| `get_financials` | 재무정보. `scope: summary`(주요계정, 단일/다중사) / `full`(전체 BS/IS/CF, 단일사) |\n| `download_document` | 공시 원문 → `format: markdown`(DART XML 자체 파서) / `raw` / `text` |\n| `get_xbrl` | XBRL. `format: raw` ZIP 해제(보안 가드) / `markdown` whitelist 50태그 / `markdown_full` taxonomy 전체(v0.9) |\n| `get_periodic_report` | 정기보고서 **29 섹션 enum** (배당·최대주주·감사인·보수·자금사용 등) |\n\n### 합성 래퍼 (4)\n| 도구 | 용도 |\n|---|---|\n| `get_shareholders` | 지배구조 4섹션(최대주주·변동·소액주주·주식총수) 병렬 합성 |\n| `get_executive_compensation` | 임원 보수 6섹션(전체·5억 이상·상위 5·미등기·주총승인·유형별) |\n| `get_major_holdings` | 5%룰(majorstock) + 임원·주요주주 본인 지분(elestock) |\n| `get_corporate_event` | 주요사항보고서 **36 이벤트 enum** + `mode: single` / `timeline` |\n\n### 애널리스트 프레임 (3 · 킬러)\n| 도구 | 용도 |\n|---|---|\n| `insider_signal` | 임원 거래를 매수/매도 **클러스터 시그널**로 집계 (`strong_buy_cluster` 등) |\n| `disclosure_anomaly` | 정정공시·감사인 교체·비적정 의견·자본 스트레스 → **0-100 score + verdict** |\n| `buffett_quality_snapshot` | N년 ROE/부채/CAGR + **버핏 체크리스트 4종**. corps 배열 지원 (1개=시계열, 2+=비교+랭킹) |\n\n### 원문 분석 (1)\n| 도구 | 용도 |\n|---|---|\n| `get_attachments` | 공시 첨부 HWP/HWPX/PDF/DOCX/XLSX → 마크다운 ([kordoc](https://github.com/chrisryugj/kordoc)) + ZIP 재귀 파싱 |\n\n---\n\n## 주요 특징\n\n- **83 API → 15 도구** — OpenDART 전체(공시·재무·지분·주요사항·정기보고서·XBRL) 를 enum 압축. LLM 컨텍스트 8-10k → 6-8k 토큰\n- **회사명 자동 해결** — \"삼성전자\" / \"005930\" / \"00126380\" 어느 형식이든 자동 변환 (SQLite FTS 선적재, 24h TTL)\n- **버핏급 애널리스트 프레임** — raw 테이블 위에 **시그널/스코어/체크리스트** 레이어를 얹어 AI 에이전트가 바로 쓰도록 가공\n- **HWP/PDF 첨부 마크다운화** — [kordoc](https://github.com/chrisryugj/kordoc) 엔진으로 공시 원문 본문을 LLM 이 직접 읽음 (2.2MB PDF → 3.7초)\n- **DART XML 자체 파서** — `dart4.xsd` 전용 마크업을 heading·테이블 보존된 마크다운으로 변환\n- **페이지 병렬화** — `search_disclosures` 배치 모드 30-50초 → 17초 (2-3배)\n- **22 프리셋** — 자기주식·CB/BW·합병·5%보유·정정·부실·소송 등 자주 쓰는 조합을 enum 으로\n- **XBRL 원본 노출** — 파싱 안 하고 해제 경로만 반환. Claude 가 직접 집계 가능\n- **OpenDartReader/dart-fss 호환 매핑** — 검증된 Python 래퍼들의 엔드포인트 매핑을 그대로 수용\n\n---\n\n## 참고\n\n- [OpenDART API 목록](https://opendart.fss.or.kr/intro/infoApiList.do) — 공식 83 엔드포인트\n- [FinanceData/OpenDartReader](https://github.com/FinanceData/OpenDartReader) — pandas 래퍼 (438⭐)\n- [josw123/dart-fss](https://github.com/josw123/dart-fss) — XBRL 파싱 (364⭐)\n- 자매 프로젝트 [korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp) — 법제처 MCP\n\n## Star History\n\n<a href=\"https://www.star-history.com/?repos=chrisryugj%2Fkorean-dart-mcp&type=timeline&legend=bottom-right\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=chrisryugj/korean-dart-mcp&type=timeline&theme=dark&legend=top-left\" />\n    <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=chrisryugj/korean-dart-mcp&type=timeline&legend=top-left\" />\n    <img alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=chrisryugj/korean-dart-mcp&type=timeline&legend=top-left\" />\n  </picture>\n</a>\n\n## 라이선스\n\n[MIT](./LICENSE)\n\n---\n\n<sub>Made by 류주임 @ 광진구청 AI동호회 AI.Do</sub>\n","readmeFilename":"README.md"}