ํ๊ตญ ๊ธ์ต๊ฐ๋ ์ ์ ์๊ณต์์์คํ (DART) API๋ฅผ MCP(Model Context Protocol)๋ก ์ ๊ณตํ๋ ์๋ฒ์ ๋๋ค.
AI ์ด์์คํดํธ๊ฐ ํ๊ตญ ์์ฅ๊ธฐ์ ์ ๊ณต์, ์ฌ๋ฌด์ ๋ณด, ๊ธฐ์ ์ ๋ณด๋ฅผ ์ค์๊ฐ์ผ๋ก ์กฐํํ ์ ์์ต๋๋ค.
๐ ์ง์ ๋ฐ์ดํฐ: 2023๋ ~ 2025๋ ์ต์ (3๋ถ๊ธฐ) ๋ชจ๋ ์กฐํ ๊ฐ๋ฅ!
๐ฅ ํด๋ฆญํ๋ฉด YouTube์์ ์์ฐ ์์์ ๋ณผ ์ ์์ต๋๋ค!
| ๊ธฐ๋ฅ | ์ค๋ช |
|---|---|
find_company |
๊ธฐ์ ๋ช ์ผ๋ก corp_code ๊ฒ์ (114,951๊ฐ ์ ์ฒด ๊ธฐ์ ) |
| ๊ธฐ๋ฅ | ์ค๋ช |
|---|---|
search_disclosures |
๊ณต์ ๊ฒ์ (๊ธฐ๊ฐ, ๊ธฐ์ , ์์ฅ ํํฐ๋ง) |
get_company_info |
๊ธฐ์ ๊ธฐ๋ณธ์ ๋ณด (ํ์ฌ๋ช , ๋ํ์, ์ ์ข ๋ฑ) |
| ๊ธฐ๋ฅ | ์ค๋ช |
|---|---|
get_financial_account |
์ฃผ์ ์ฌ๋ฌด๊ณ์ (์์ฐ, ๋ถ์ฑ, ๋งค์ถ, ์์ ์ด์ต ๋ฑ) |
get_full_financial_statement |
์ ์ฒด ์ฌ๋ฌด์ ํ (BS, IS, CF ๋ฑ) |
get_financial_index |
โญ ์ฃผ์ ์ฌ๋ฌด์งํ (ROE, ROA, ๋ถ์ฑ๋น์จ, PER, PBR ๋ฑ) |
get_dividend_info |
๋ฐฐ๋น ์ ๋ณด |
| ๊ธฐ๋ฅ | ์ค๋ช |
|---|---|
get_executives |
์์ ํํฉ |
get_employees |
์ง์ ํํฉ (ํ๊ท ๊ธ์ฌ, ๊ทผ์์ฐ์ ๋ฑ) |
| ๊ธฐ๋ฅ | ์ค๋ช |
|---|---|
get_largest_shareholders |
์ต๋์ฃผ์ฃผ ํํฉ |
get_major_stock |
โญ ๋๋๋ณด์ ์ํฉ๋ณด๊ณ (5%๋ฃฐ - 5% ์ด์ ์ฃผ์ฃผ ๋ณ๋) |
get_executive_stock |
โญ ์์ยท์ฃผ์์ฃผ์ฃผ ์ง๋ถ ๋ณ๋ |
| ๊ธฐ๋ฅ | ์ค๋ช |
|---|---|
get_capital_change |
โญ ์ฆ์/๊ฐ์ ํํฉ |
get_treasury_stock |
โญ ์๊ธฐ์ฃผ์ ์ทจ๋/์ฒ๋ถ ํํฉ |
๋ณ๋ ์ค์ ์์ด ๋ฐ๋ก ์ฌ์ฉ ๊ฐ๋ฅ!
https://dart-mcp-self.vercel.app/sse
MCP ํด๋ผ์ด์ธํธ์ ์ URL๋ง ์ถ๊ฐํ๋ฉด ๋!
Fork ํ Vercel์ ์ฐ๊ฒฐํ๋ฉด ์๋ ๋ฐฐํฌ๋ฉ๋๋ค.
git clone https://github.com/Dayoooun/dart-mcp.git
cd dart-mcp
# ์์กด์ฑ ์ค์น ๋ฐ ์คํ
pip install -e .
opendart-mcp~/.cursor/mcp.json ํ์ผ์ ์ถ๊ฐ:
{
"mcpServers": {
"opendart": {
"type": "http",
"url": "https://dart-mcp-self.vercel.app/sse"
}
}
}claude_desktop_config.json์ ์ถ๊ฐ:
{
"mcpServers": {
"opendart": {
"url": "https://dart-mcp-self.vercel.app/sse"
}
}
}{
"mcpServers": {
"opendart": {
"command": "opendart-mcp"
}
}
}corp_code๋ฅผ ๋ชฐ๋ผ๋ ๋ฉ๋๋ค! find_company๋ก ๊ฒ์ํ์ธ์:
"์ธ์ฐ๊ฐ๋ผ๋ ํ์ฌ ์ฌ๋ฌด์ ํ ๋ณด์ฌ์ค"
AI๊ฐ ์๋์ผ๋ก:
find_company("์ธ์ฐ๊ฐ")โ corp_code ํ๋get_financial_account(corp_code=...)โ ์ฌ๋ฌด์ ๋ณด ์กฐํ
"์ผ์ฑ์ ์ ๊ธฐ์
์ ๋ณด ์๋ ค์ค"
"๋ค์ด๋ฒ์ 2023๋
์ฐ๊ฐ ์ฌ๋ฌด์ ํ ๋ณด์ฌ์ค"
"์นด์นด์ค ์ง์ ํํฉ๊ณผ ํ๊ท ๊ธ์ฌ ์๋ ค์ค"
"์ค๋ฅด๋นํ
์ด๋ผ๋ ํ์ฌ์ ์ง์ ํํฉ ์๋ ค์ค"
"๋๋
ธ์จ์ ์์ค ์์ ํํฉ ๋ณด์ฌ์ค"
"๋์ฐ๋ก๋ณดํฑ์ค ์ฌ๋ฌด์ ๋ณด ์กฐํํด์ค"
"NAVER ์ฌ๋ฌด์ ๋ณด" โ ๋ค์ด๋ฒ ์ฐพ์
"๋ค์ด๋ฒ ์ฌ๋ฌด์ ๋ณด" โ NAVER ์ฐพ์
"LG ๊ณ์ด์ฌ ๋ชฉ๋ก" โ LG์ ์, LGํํ, LG์๋์ง์๋ฃจ์
๋ฑ ์ฐพ์
์์ฃผ ์ฌ์ฉ๋๋ ๋๊ธฐ์ ์ corp_code๋ฅผ ์ง์ ์ฌ์ฉํด๋ ๋ฉ๋๋ค:
| ๊ธฐ์ ๋ช | corp_code | ์ข ๋ชฉ์ฝ๋ |
|---|---|---|
| ์ผ์ฑ์ ์ | 00126380 | 005930 |
| SKํ์ด๋์ค | 00164779 | 000660 |
| LG์ ์ | 00401731 | 066570 |
| ํ๋์๋์ฐจ | 00164742 | 005380 |
| ๋ค์ด๋ฒ | 00266961 | 035420 |
| ์นด์นด์ค | 00258801 | 035720 |
| ์ผ์ฑSDI | 00126371 | 006400 |
| LGํํ | 00356361 | 051910 |
| ์ ํธ๋ฆฌ์จ | 00421045 | 068270 |
| ํฌ์ค์ฝํ๋ฉ์ค | 00126186 | 005490 |
๊ทธ ์ธ ๊ธฐ์
: find_company๋ก ๊ฒ์ํ์ธ์! (114,951๊ฐ ๊ธฐ์
์ง์)
| ์ฝ๋ | ์ค๋ช | ํน์ง |
|---|---|---|
| 11011 | ์ฌ์ ๋ณด๊ณ ์ (์ฐ๊ฐ) | ๊ฐ์ฅ ์์ธ, ์ง์ํํฉ ํฌํจ |
| 11012 | ๋ฐ๊ธฐ๋ณด๊ณ ์ | 6๊ฐ์ ์ค์ |
| 11013 | 1๋ถ๊ธฐ๋ณด๊ณ ์ | 3๊ฐ์ ์ค์ |
| 11014 | 3๋ถ๊ธฐ๋ณด๊ณ ์ | 9๊ฐ์ ์ค์ |
| ๊ฐ | ์ค๋ช |
|---|---|
| CFS | ์ฐ๊ฒฐ์ฌ๋ฌด์ ํ (์ํ์ฌ ํฌํจ, ์ผ๋ฐ์ ์ผ๋ก ์ฌ์ฉ) |
| OFS | ๊ฐ๋ณ์ฌ๋ฌด์ ํ (ํด๋น ๋ฒ์ธ๋ง) |
| ๊ฐ | ์ค๋ช |
|---|---|
| Y | ์ ๊ฐ์ฆ๊ถ์์ฅ (์ฝ์คํผ) |
| K | ์ฝ์ค๋ฅ์์ฅ |
| N | ์ฝ๋ฅ์ค์์ฅ |
| E | ๊ธฐํ (๋น์์ฅ ๋ฑ) |
get_financial_index API์์ ์ฌ์ฉ (ํ์):
| ์ฝ๋ | ์ค๋ช | ํฌํจ ์งํ |
|---|---|---|
| M210000 | ์์ต์ฑ์งํ | ROE, ROA, ์์ ์ด์ต๋ฅ , ์์ด์ต๋ฅ ๋ฑ |
| M220000 | ์์ ์ฑ์งํ | ๋ถ์ฑ๋น์จ, ์ ๋๋น์จ, ๋น์ข๋น์จ ๋ฑ |
| M230000 | ์ฑ์ฅ์ฑ์งํ | ๋งค์ถ์ฆ๊ฐ์จ, ์์ ์ด์ต์ฆ๊ฐ์จ ๋ฑ |
| M240000 | ํ๋์ฑ์งํ | ์ด์์ฐํ์ ์จ, ์ฌ๊ณ ์์ฐํ์ ์จ ๋ฑ |
๊ธฐ์ ๋ช ์ผ๋ก corp_code๋ฅผ ๊ฒ์ํฉ๋๋ค. 114,951๊ฐ ์ ์ฒด ๊ธฐ์ ๋ฐ์ดํฐ์์ ์ฆ์ ๊ฒ์!
ํน์ง:
- ๐ ๋น ๋ฅธ ๊ฒ์ (~50ms) - ๋ฏธ๋ฆฌ ๋ก๋๋ ๋ฐ์ดํฐ ์ฌ์ฉ
- ๐ ํ๊ธ/์๋ฌธ ๋์ ๊ฒ์ - "๋ค์ด๋ฒ" ๊ฒ์ ์ "NAVER"๋ ์ฐพ์
- โญ ์์ฅ๊ธฐ์ ์ฐ์ ์ ๋ ฌ
์์ฒญ:
{
"query": "๋ค์ด๋ฒ"
}์๋ต:
{
"status": "000",
"companies": [
{
"corp_code": "00266961",
"corp_name": "NAVER",
"stock_code": "035420"
},
{
"corp_code": "01246715",
"corp_name": "๋ค์ด๋ฒ๋ฉ์ค",
"stock_code": ""
}
]
}dart-mcp/
โโโ api/
โ โโโ index.py # Vercel ์๋ฒ๋ฆฌ์ค ํจ์ (SSE)
โ โโโ companies.json # ๊ธฐ์
๋ฐ์ดํฐ (114,951๊ฐ)
โโโ scripts/
โ โโโ update_companies.py # ๊ธฐ์
๋ฐ์ดํฐ ์
๋ฐ์ดํธ ์คํฌ๋ฆฝํธ
โโโ src/opendart_mcp/
โ โโโ server.py # MCP ์๋ฒ ํต์ฌ ๋ก์ง
โ โโโ api/ # API ๋ชจ๋
โ โโโ models/ # Pydantic ๋ชจ๋ธ
โโโ vercel.json # Vercel ์ค์
โโโ pyproject.toml # ํจํค์ง ์ค์
# uv ์ฌ์ฉ (๊ถ์ฅ)
uv sync
uv run opendart-mcp
# ๋๋ pip ์ฌ์ฉ
pip install -e ".[dev]"
opendart-mcpfind_company๋ api/companies.json ํ์ผ์ ์ฌ์ฉํฉ๋๋ค. ์๋ก์ด ๊ธฐ์
์ด ๋ฑ๋ก๋๋ฉด ์ 1ํ ์ ๋ ์
๋ฐ์ดํธ๋ฅผ ๊ถ์ฅํฉ๋๋ค:
# ๊ธฐ์
๋ฐ์ดํฐ ์
๋ฐ์ดํธ (114,000+ ๊ธฐ์
)
python scripts/update_companies.py
# ๋ณ๊ฒฝ์ฌํญ ๋ฐฐํฌ
git add api/companies.json
git commit -m "Update companies data"
git push๊ธฐ์ฌ๋ฅผ ํ์ํฉ๋๋ค!
- Fork
- Feature branch ์์ฑ (
git checkout -b feature/amazing-feature) - Commit (
git commit -m 'Add amazing feature') - Push (
git push origin feature/amazing-feature) - Pull Request
MIT License - ์์ ๋กญ๊ฒ ์ฌ์ฉ, ์์ , ๋ฐฐํฌ ๊ฐ๋ฅํฉ๋๋ค.
์ด ํ๋ก์ ํธ๊ฐ ๋์์ด ๋์ จ๋ค๋ฉด โญ Star๋ฅผ ๋๋ฌ์ฃผ์ธ์!
