korean-tax-calc-mcp โ Korea Tax Calculator MCP (ํ๊ตญ ์ธ๊ธ ๊ณ์ฐ)

์์: Claude ์ฑ(์ฝ์ํฌ) + ์ด ์๋ฒ. ์์ต๊ณ์ฐ์์ ๊ณ์ ๋ณ ์์ฅ ์์
์ ์ฃผ๋ฉด ์ธ๋ฌด์กฐ์ ๋ถํฐ ๋ฒ์ ์์ ์ด์๊น์ง ํ ๋ฒ์ ์ด์ด์ง๋๋ค(2026-11-08 ๊ณต๊ฐ, ํ์ฌยท์ซ์๋ ๊ฐ์ ์์).
ยท English
์์ฑ ์ฃผ์ฒด(์ ํํ ๊ณ ์ง): 0.3.0๋ถํฐ 0.12.2๊น์ง(2026-10-10๋ถํฐ 10-26๊น์ง)๋ Solar Pro 4(Solar Work CLI)๊ฐ ์ฝ๋๋ฅผ ์ฐ๊ณ CodeSolar๊ฐ ๋ฆฌ๋ทฐ, Claude๊ฐ ํ
์คํธ๋ก ๊ต์ฐจ ๊ฒ์ฆํ์ต๋๋ค(0.8.0 ์ผ๋ถ ๋ฌธ๋ฒ ์ค๋ฅ์ 0.9.2๋ Claude๊ฐ ์์ ยท์์ฑ). 0.13.0(2026-10-28)๋ถํฐ๋ ๊ธฐ์กด ๊ณ์ฐ๊ธฐ ๋ผ๋๋ Solar Pro 4 ๊ทธ๋๋ก์ด๊ณ , ์ ๋๊ตฌยท์ฐ๋๋ณ ์กฐ๋ฌธ ๋์กฐยท๋ฒ๊ทธ ์์ ์ Claude(Anthropic)๊ฐ ์์ฑํ๋ฉฐ CodeSolar๊ฐ ๋ฆฌ๋ทฐํฉ๋๋ค. 0.26.0(2026-11-10)๋ถํฐ ์ ๋๊ตฌ๋ Claude๊ฐ ๋ช
์ธยท์ ๋ต ํ
์คํธ๋ฅผ ๋จผ์ ์ฐ๊ณ Solar Pro 4๊ฐ ๋ผ๋๋ฅผ ๊ตฌํํ ๋ค Claude๊ฐ ๊ฒ์ยท๋ณด์ํฉ๋๋ค(์ปค๋ฐ๋ณ ์์ฑ์ ํ๊ธฐ). ๋ฒ์ ๋ณ ์์ฑ ์ฃผ์ฒด๋ CHANGELOG ๊ฐ ์ ๋จธ๋ฆฌ์ ์ ํ ์์ต๋๋ค. ๋๊ตฌ 109๊ฐ.
Korean tax calculations for AI agents โ code, not guesses. English
์ธ๊ธ ๊ณ์ฐ์ AI๊ฐ ์์ฃผ ํ๋ฆฝ๋๋ค. ์ด ์๋ฒ๋ ๊ณ์ฐ์ ์ฝ๋๋ก ํ๊ณ , ๊ฒฐ๊ณผ๋ง๋ค ๊ทผ๊ฑฐ ์กฐ๋ฌธ์ ๋ถ์
๋๋ค. ์ฐ๋ํ๊ฐ ์๋ ํด๋ ์ถ์ ํ์ง ์๊ณ ๋ฉ์ถฅ๋๋ค.
์๋ ๋ฐฉ์
flowchart LR
Q["AI์ ์
๋ ฅ<br/>์ฐ๋ยท๊ธ์กยทํญ๋ชฉ"] --> V["์
๋ ฅ ํ์ธ<br/>๋ชจ๋ฅด๋ ํญ๋ชฉยท๋น ์ง ๊ฐ ๊ฑฐ๋ถ"]
V --> T["๊ทธํด ๊ธฐ์ค๊ฐ<br/>์ธ์จยทํ๋ยท๊ณต์ ์จ"]
T --> E["๊ณ์ฐ<br/>์กฐ๋ฌธ ์์๋๋ก"]
E --> R["๊ฒฐ๊ณผ<br/>์ธ์กยท์ธ๋ฌด์กฐ์ ยท๊ทผ๊ฑฐ ์กฐ๋ฌธ"]
T -.->|ํ ์๋ ์ฐ๋| X["๋ฉ์ถค<br/>์ถ์ ๊ณ์ฐ ์ ํจ"]
- ์
๋ ฅ ํ์ธ โ ๋ชจ๋ฅด๋ ํญ๋ชฉยท๋น ์ง ๊ฐ์ด ์์ผ๋ฉด ๊ณ์ฐํ์ง ์๊ณ ๋ฌด์์ด ํ์ํ์ง ์๋ ค ์ค๋๋ค.
- ๊ทธํด ๊ธฐ์ค๊ฐ โ ์ธ์จยทํ๋๋ ์ฝ๋ ์ ์ฐ๋ํ(๋ฒ์ธ์ธยท์๋์ธ 2016โ2026, ๋ถ๊ฐ์ธ 2016๋
1๊ธฐโ2026๋
2๊ธฐ), ํญ๋ชฉ๋ณ ํ๋จ ๊ธฐ์ค์
facts_vocab.json(์ ์ฉ ๊ธฐ๊ฐยท๊ทผ๊ฑฐ ์กฐ๋ฌธ ํฌํจ)์์ ๊บผ๋
๋๋ค.
- ๊ณ์ฐ โ ์กฐ๋ฌธ ์์๋๋ก ๊ณ์ฐํฉ๋๋ค. ์: ๊ณผ์ธํ์ค โ ๊ทธํด ์ธ์จ ๊ตฌ๊ฐ โ ์ฐ์ถ์ธ์ก.
- ๊ฒฐ๊ณผ โ ์ธ์กยท์ค๊ฐ ๊ณ์ฐยทํญ๋ชฉ๋ณ ํ๋จยท์ธ๋ฌด์กฐ์ (์๋์ฒ๋ถ)ยท๊ทผ๊ฑฐ ์กฐ๋ฌธ์ ํจ๊ป ๋๋ ค์ค๋๋ค.
๋๊ตฌ 114๊ฐ ์ค 110๊ฐ๋ ์์ฑํ AI ์์ด ์ฝ๋๋ก ๋์ํฉ๋๋ค(์์ธยท๊ณต์๊ฐ๊ฒฉ ์กฐํ 2๊ฐ๋ KRXยท๋ธ์ด์๋ ๊ณต๊ฐ ๋ฐ์ดํฐ๋ง ๊ฐ์ ธ์ต๋๋ค). PDF ๋๊ตฌ 3๊ฐ๋ง UPSTAGE_API_KEY๊ฐ ์์ ๋ Upstage๋ฅผ ์๋๋ค.
๋ฒ์ธ์ธ ์ธ๋ฌด์กฐ์ ์ด ์ด์ด์ง๋ ๋ชจ์
๋๊ตฌ๋ ํ๋์ฉ๋ ์ฐ์ง๋ง, ๋ฒ์ธ์ธ๋ ์ ๋๊ตฌ์ ๊ฒฐ๊ณผ๊ฐ ๋ค์ ๋๊ตฌ์ ์
๋ ฅ์ด ๋๋๋ก ์ด์ด์ง๋๋ค.
flowchart TD
L["์ฅ๋ถยท์ฌ์ค๊ด๊ณ<br/>ํญ๋ชฉ ์ด๋ฆยท๊ธ์กยท์ฆ๋น"] --> A["ํญ๋ชฉ๋ณ ์ธ๋ฌด์กฐ์ <br/>๊ธฐ์
์
๋ฌด์ถ์ง๋นยท๊ฐ๊ฐ์๊ฐยท๋์<br/>์ธ์ ์ด์ยท์ง๊ธ์ด์ยท์น์ฉ์ฐจ"]
A -->|์กฐ์ ๋ชฉ๋ก| T["์ฐจ๊ฐ๊ฐ์๋๊ธ์ก<br/>income_adjustment_total"]
T -->|๊ธฐ์ค์๋| D["๊ธฐ๋ถ๊ธ ํ๋<br/>donation_limit"]
D -->|ํ๋์ด๊ณผ์ก| T
T --> B["๊ณผ์ธํ์ค<br/>์ด์๊ฒฐ์๊ธ ํ๋"]
B --> C["์ฐ์ถ์ธ์กยท์ต์ ํ์ธ<br/>corporate_tax ยท minimum_tax"]
C --> X["๊ฒํ ์ฉ ์์
<br/>export_workbook"]
ํญ๋ชฉ๋ณ ์กฐ์ ๋๊ตฌ๋ ์๋์ฒ๋ถ(์ ๋ณดยท์์ฌยท๊ธฐํ์ฌ์ธ์ ์ถ ๋ฑ)๊น์ง ๋๋ ค์ฃผ๊ณ , export_workbook์ ๊ฐ์ ํธ์ถ์ ๋ค์ ์คํํด ๋ณ์ง ์์๋ผ๋ฆฌ ์์์ผ๋ก ์ฐ๊ฒฐ๋ ์์
์ ๋ง๋ญ๋๋ค. ์ด๋ค ๋๊ตฌ๋ฅผ ์ธ์ง ๋ชจ๋ฅด๋ฉด find_tool์ ํ์ ๋ง๋ก ๋ฌผ์ด๋ณด๋ฉด ๋ฉ๋๋ค.
์ด๋ ๊ฒ ๋ฌผ์ด๋ณด์ธ์
- "2025 ์ฌ์
์ฐ๋ ๊ณผ์ธํ์ค 5์ต ๋ฒ์ธ์ธ ์ฐ์ถ์ธ์ก์?"
- "๊ฐ์ง๊ธ๊ธ 3์ 1์ผ 2์ต ๋์ฌ, 9์ 30์ผ 1์ต ํ์ โ ์ธ์ ์ด์ ๊ณ์ฐํด์ค"
- "๊ณผ์์ ๊ณ 1์ฒ๋ง ์์ 10์ 7์ผ์ ๋ฉ๋ถํ๋ฉด ๊ฐ์ฐ์ธ๋?"
- "ํด์ง๊ธ 1์ต, ๊ทผ์ 15๋
ํด์ง์๋์ธ"
- "๊ธฐ์
์
๋ฌด์ถ์ง๋น ์์ฅ 5๊ฑด ๊ทธ๋๋ก ์ค๊ฒ โ 2025 ์ฌ์
์ฐ๋ ์ธ๋ฌด์กฐ์ ๋ฝ์์ค"
์ค์น
claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp
{
"mcpServers": {
"korean-tax-calc": { "command": "uvx", "args": ["korean-tax-calc-mcp"] },
"korean-tax": { "command": "uvx", "args": ["korean-tax-mcp"], "env": { "LAW_OC": "๋ฒ์ ์ฒ OC(๋ฌด๋ฃ, ์ ํ)" } }
}
}
๋ ๋ฒ์งธ ์ค์ korean-tax-mcp๋ ์กฐ๋ฌธยท๋ถ์นยทํด์ยทํ๋ก๋ฅผ ์ฐพ๋ ์ง ์๋ฒ์
๋๋ค. ๊ฐ์ด ๋๋ฉด ๊ทผ๊ฑฐ ์ฐพ๊ธฐ โ ๊ณ์ฐ โ ์์์ด ํ ๋ํ์์ ์ด์ด์ง๊ณ , ์ด ์๋ฒ์ find_tool๋ ๊ณ์ฐ ๋๊ตฌ๊ฐ ์๋ ์ง๋ฌธ(์์ธยท์ฐ๊ธ๊ณ์ข ์ธ์ก๊ณต์ , ์ฃผ์ ์๋ ๋ฑ)์ ๋ฐ๋ก ๋ถ๋ฅผ ์กฐ๋ฌธ ํธ์ถ๊ฐ์ ๋๋ ค์ค๋๋ค. ๊ณ์ฐ๋ง ์ฐ๋ ค๋ฉด ์ฒซ ์ค๋ง ๋ฃ์ด๋ ๋ฉ๋๋ค.
์ ๋ฒ์ ์ผ๋ก ๋ฐ๋ก ๋ฐ๊พธ๋ ค๋ฉด uvx --refresh korean-tax-calc-mcp(uvx๋ ๋ฐ์ ๋ฒ์ ์ ์บ์ํฉ๋๋ค). ํน์ ๋ฒ์ ๊ณ ์ ์ uvx korean-tax-calc-mcp@0.28.1.
ํค ์์ด ๋์ํฉ๋๋ค. ์ ํ: LAW_OC(์ธ๋ฌด์กฐ์ฌ ํ์ ๋๊ตฌ 2๊ฐ์ ๋ฒ์ ์ฒ ์กฐ๋ฌธ ์กฐํ), UPSTAGE_API_KEY(PDF ํ ์ถ์ถ).
ํจ๊ป ์ฐ๋ฉด ์ข์ ์ง์นจ
AI๊ฐ ๋๊ตฌ๋ฅผ ์ธ์ ๋ถ๋ฅด๊ณ , ๋๊ตฌ์ ๋ต์ ์ธ์ ๋ฏฟ์์ง ์ ํด ์ฃผ๋ ๋ค์ฏ ์ค์
๋๋ค. ์๋ฒ ์๋ด๋ฌธ(instructions)์๋ ๊ฐ์ ๊ท์น์ด ๋ค์ด ์์ง๋ง, ํด๋ผ์ด์ธํธ์ ๋ฐ๋ผ ์๋ด๋ฌธ์ ์ฝํ๊ฒ ๋ฐ์ํ๊ฑฐ๋ ์ฝ์ง ์์ต๋๋ค. ์๋๋ฅผ ์์คํ
ํ๋กฌํํธ์ ๋ฃ์ผ๋ฉด ๋ ์ ์งํต๋๋ค(Claude Desktop ํ๋ก์ ํธ ์ง์นจ, Claude Code์ CLAUDE.md, ๊ทธ ๋ฐ์ ๋ง์ถค ์ง์นจ).
์ธ๊ธ ์ง๋ฌธ์ ๋ตํ ๋ korean-tax-mcp์ korean-tax-calc-mcp๋ฅผ ์ด๋ ๊ฒ ์ด๋ค.
1. ์ซ์ ํ๋, ํ๋จ ํ๋๋ง๋ค ์ธ ์ ์๋ ๋๊ตฌ๊ฐ ์๋์ง ๋จผ์ ์ฐพ๋๋ค. ์ด๋ฆ์ ๋ชจ๋ฅด๋ฉด find_tool๋ก ์ฐพ๊ณ , ๊ท์ยท๊ณต๊ธ์๊ธฐ๋ timing_rules๋ฅผ ๋จผ์ ๋ณธ๋ค.
2. ๋๊ตฌ๊ฐ ์์ผ๋ฉด ์์ผ๋ก ํ๊ธฐ ์ ์ ๋๊ตฌ๋ถํฐ ๋ถ๋ฅธ๋ค.
3. ๋๊ตฌ์ ๋ต๊ณผ ๋ด ๊ณ์ฐ์ด ๋ค๋ฅด๋ฉด ๋ฐ๋ก ๊ณ ๋ฅด์ง ์๋๋ค. ์
๋ ฅ์ ๋ค์ ํ์ธํ๊ณ , ์ฐจ์ด๋ฅผ ๊ฐ๋ฅด๋ ์กฐ๋ฌธ์ law_article๋ก ์ด์ด ์๊ฑด์ ์ฌ์ค๊ด๊ณ์ ํ๋์ฉ ๋ง์ถฐ ๋ณธ๋ค.
4. ์กฐ๋ฌธ์์ ๋๊ตฌ๊ฐ ํ๋ ธ๋ค๋ ๊ทผ๊ฑฐ๋ฅผ ๋ชป ์ฐพ์ผ๋ฉด ๋๊ตฌ์ ๋ต์ ๋ฐ๋ฅธ๋ค. ๋ค๋ฅธ ๊ฐ์ ์ฐ๋ฉด ๊ทธ ์ด์ (์
๋ ฅ ์ค๋ฅ ๋๋ ์กฐ๋ฌธ ๋ฒํธ)๋ฅผ ํ ์ค ์ ๋๋ค.
5. ๋ต์ด ๋ ๊ฐ ๋์ค๋ฉด(์๋ถ ์ ํ, ์ ์ฒด์ ๊ณผ์ธ๋ถ ๋ฑ) ์ง๋ฌธ์ด ๋ฌป๋ ํ๋๋ง ๋ตํ๋ค.
๋๊ตฌ (114๊ฐ)
๋ฌถ์ ์ด๋ฆ์ ๋๋ฅด๋ฉด ๋๊ตฌ ๋ชฉ๋ก์ด ํผ์ณ์ง๋๋ค.
๋ฒ์ธ์ธ (26)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
corporate_tax | ์ฐ์ถ์ธ์ก |
foreign_tax_credit | ์ธ๊ตญ๋ฉ๋ถ์ธ์ก๊ณต์ |
entertainment_limit | ๊ธฐ์
์
๋ฌด์ถ์ง๋น ํ๋ |
deemed_interest | ๊ฐ์ง๊ธ๊ธ ์ธ์ ์ด์ |
unfair_transaction | ๋ถ๋นํ์ ๊ธฐ์ค |
loss_carryforward_limit | ์ด์๊ฒฐ์๊ธ ํ๋ |
minimum_tax | ์ต์ ํ์ธ |
minimum_tax_adjustment | ์ต์ ํ์ธ ์กฐ์ (๊ฐ๋ฉดยท๊ณต์ ๋ฐฐ์ ์์ยท๋ณ์ง ์ 4ํธยท์ 8ํธ์์(๊ฐ)) |
nonbusiness_interest_disallowance | ์
๋ฌด๋ฌด๊ด ์ง๊ธ์ด์(๊ฐ์ง๊ธ๊ธ ์ ์ธ ํ์ ยท์ ์ยท์์) |
business_car_expense | ์
๋ฌด์ฉ์น์ฉ์ฐจ |
donation_limit | ๊ธฐ๋ถ๊ธ ํ๋ |
nonprofit_reserve_limit | ๋น์๋ฆฌ๋ด๊ตญ๋ฒ์ธ ๊ณ ์ ๋ชฉ์ ์ฌ์
์ค๋น๊ธ ์๊ธ์ฐ์
ํ๋(๋ฒ ์ 29์กฐ) |
bad_debt_allowance | ๋์์ถฉ๋น๊ธ ํ๋ |
thin_capitalization | ๊ณผ์์๋ณธ |
missing_receipt_disallowance | ์ ๊ฒฉ์ฆ๋น ๋ฏธ์์ทจ |
dividend_received_deduction | ์์
๋ฐฐ๋น๊ธ ์ต๊ธ๋ถ์ฐ์
|
foreign_subsidiary_dividend | ์ธ๊ตญ์ํ์ฌ ์์
๋ฐฐ๋น๊ธ ์ต๊ธ๋ถ์ฐ์
ยท์ธ๊ตญ๋ฉ๋ถ์ธ์ก๊ณต์ |
expat_cost_recharge | ํด์ธ ํ๊ฒฌ ์ธ๊ฑด๋น ์ฒญ๊ตฌ์กยท์ ์๊ฐ๊ฒฉยท์๊ธยท๋น๊ณผ์ธ |
corporate_filing_obligations | ์ธ๋ถ๊ฐ์ฌยท์ธ๋ถ์ธ๋ฌด์กฐ์ ยท๊ตญ์ ๊ฑฐ๋ ์๋ฃ ์ ์ถ ์๋ฌด ํ์ |
cfc_deemed_dividend | ํน์ ์ธ๊ตญ๋ฒ์ธ(CFC) ์ ๋ณด์๋ ๋ฐฐ๋น๊ฐ์ฃผ์ก โ ์ ์จ๊ณผ์ธยท์ง๋ถ์จ 10%ยท์ ์ฉ์ ์ธยท๋ฐฐ๋น๊ฐ๋ฅ ์ ๋ณด์๋ยท์ ์ฉ๋๋ ๋ฐฐ๋น๊ฐ์ฃผ(์ ๋ถ/์๋์๋) ํ์ (๊ตญ์กฐ๋ฒ ์ 27์กฐ~์ 31์กฐ) |
loss_carryforward_ledger | ์ด์๊ฒฐ์๊ธ ๋ค๊ธฐ๊ฐ ์ถ์ โ ๋ฐ์ ์ฐ๋๋ณ ์์ก, ์ฐ๋๋ณ ๊ณต์ ์กยท๊ณผ์ธํ์ค, ๊ณต์ ๊ธฐ๊ฐ ๊ฒฝ๊ณผ ์๋ฉธ(๋ฒ์ธ์ธ๋ฒ ์ 13์กฐโ , ์ ์ 10์กฐโก) |
foreign_subsidiary_liquidation | ํด์ธ ์ํ์ฌ ์ฒญ์ฐ ์์ต โ ์์ ๋ฐฐ๋น ๋๋ ์ฒญ์ฐ์์ค๊ณผ ์๊ธ ๊ท์ ์ฌ์
์ฐ๋(๋ฒ์ธ์ธ๋ฒ ์ 16์กฐโ 4ํธ) |
arm_length_range | ์ ์๊ฐ๊ฒฉ ๋ฒ์์ ์กฐ์ ์ก โ ๋น๊ต๋์ ์ด์ต๋ฅ ๋ก ์ฌ๋ถ์ยท์ ์ฒด ๋ฒ์, ์ค์๊ฐ, ๋ถ์๋์ ๊ฐ์ ๋ฒ์ ์ ์ฌ๋ถ, ์กฐ์ ์ก(๊ตญ์กฐ๋ น ์ 15์กฐโคโฅ) |
provision_reserve_ledger | ์ถฉ๋น๋ถ์ฑ(ํฌ์ธํธยท๋ง์ผ๋ฆฌ์ง, ํ๋งค๋ณด์ฆ) ์ธ๋ฌด์กฐ์ ๋ค๊ธฐ๊ฐ ์ถ์ โ ์ฐ๋๋ณ ์ ๋ฆฝยท์ฌ์ฉยท์ ํจ๊ธฐ๊ฐ ์๋ฉธ์ ๋ฐ๋ฅธ ์๊ธ๋ถ์ฐ์
ยท์๊ธ์ฐ์
ยท์ ๋ณด ์์ก(๋ฒ์ธ์ธ๋ฒ ์ 40์กฐ) |
foreign_exchange_reporting | ํด์ธ์ง์ ํฌ์ ํด๋น ์ฌ๋ถยท์ธ๊ตญํ ์ ๊ณ (์ฌ์ /์ฌํ) ๊ธฐํยท๊ธฐ๊ดยท์๋ฅ, ์ฌํ๊ด๋ฆฌ ๋ณด๊ณ ์ ์ผ์ , ์ฒญ์ฐ, ํด์ธ์ง์ ํฌ์๋ช
์ธ ๊ธฐํ |
individual_foreign_tax_credit | ๊ฑฐ์ฃผ์ ์ธ๊ตญ๋ฉ๋ถ์ธ์ก๊ณต์ โ ๊ตญ๊ฐ๋ณ ํ๋ยท์กฐ์ฝ ์ ํ์ธ์จ ์ํยท10๋
์ด์ยทํด์ง์๋(์๋์ธ๋ฒ ์ 57์กฐ) |
overseas_account_reporting | ํด์ธ๊ธ์ต๊ณ์ข ์ ๊ณ ์๋ฌด(์๋ง ์์ก 5์ต ์ด๊ณผ)ยท๋ฉด์ ยท์ ๊ณ ๊ธฐํยท๋ฏธ์ ๊ณ ๊ณผํ๋ฃยท์์ ์ ๊ณ ๊ฐ๊ฒฝยท์๋ช
๋ถ์ดํ ๊ณผํ๋ฃ(๊ตญ์กฐ๋ฒ ์ 53์กฐยท์ 90์กฐ) |
capital_gains_unfair_transaction | ์๋์๋ ๋ถ๋นํ์๊ณ์ฐ โ ์ ๊ฐ์๋ยท๊ณ ๊ฐ์ทจ๋ ์๊ฐ ์ฌ๊ณ์ฐ(3์ตยท5% ๊ธฐ์ค), ์ฆ์ฌ ํ 10๋
๋ด ์๋ ๋น๊ต ํ์ (์๋์ธ๋ฒ ์ 101์กฐ) |
asset_grant_reserve | ์ผ์์๊ฐ์ถฉ๋น๊ธ |
corporate_deemed_rent_income | ์๋๋ณด์ฆ๊ธ ๊ฐ์ฃผ์ต๊ธ |
liquidation_income | ์ฒญ์ฐ์๋ |
disaster_loss_credit | ์ฌํด์์ค์ธ์ก๊ณต์ |
์๋์ธยท์์ฒยท์๋ยท์์์ฆ์ฌ (24)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
income_tax | ์ข
ํฉ์๋์ธ |
withholding_tax | ์์ฒ์ง์ |
nonresident_withholding | ๋น๊ฑฐ์ฃผ์ ์์ฒ์ง์ |
retirement_income_tax | ํด์ง์๋์ธ |
wage_income_tax | ๊ทผ๋ก์๋์ธ |
daily_worker_withholding | ์ผ์ฉ๊ทผ๋ก์ |
deemed_bonus_resettlement | ์๋์ฒ๋ถ ์์ฌ ์ฌ์ ์ฐ |
special_tax_credit | ํน๋ณ์ธ์ก๊ณต์ |
capital_gains_income | ์๋์๋ |
inheritance_tax | ์์์ธ |
gift_tax | ์ฆ์ฌ์ธ |
estimated_business_income | ์ถ๊ณ ์ฌ์
์๋ |
personal_deduction | ์ธ์ ๊ณต์ |
pension_income | ์ฐ๊ธ์๋๊ธ์ก |
income_loss_offset | ๊ฒฐ์๊ธ ๊ณต์ |
pension_account_withdrawal | ์ฐ๊ธ๊ณ์ข ์ธ์ถ |
inheritance_gift_valuation | ์์ยท์ฆ์ฌ์ฌ์ฐ ํ๊ฐ |
capital_gains_tax | ์๋์๋ ์ฐ์ถ์ธ์ก |
housing_deemed_rent_income | ์ฃผํ ๊ฐ์ฃผ์๋๋ฃ |
housing_rental_income | ์ฃผํ์๋์๋(๋น๊ณผ์ธยท๋ถ๋ฆฌ๊ณผ์ธ) |
child_tax_credit | ์๋
์ธ์ก๊ณต์ |
dividend_tax_credit | ๋ฐฐ๋น์ธ์ก๊ณต์ (๋น๊ต์ฐ์ถ์ธ์ก) |
religious_income | ์ข
๊ต์ธ์๋ |
individual_donation_expense | ๊ฐ์ธ์ฌ์
์ ๊ธฐ๋ถ๊ธ ํ์๊ฒฝ๋น ํ๋ |
๋ถ๊ฐ์ธยท๊ฐ์ฐ์ธยท์ ์ฒ๊ธฐ๊ฐยท๊ฒฝ์ ์ฒญ๊ตฌ (17)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
vat_deemed_rent | ๊ฐ์ฃผ์๋๋ฃ |
vat_deemed_input_credit | ์์ ๋งค์
์ธ์ก |
vat_common_input_allocation | ๊ณตํต๋งค์
์ธ์ก ์๋ถ |
vat_simplified_taxpayer | ๊ฐ์ด๊ณผ์ธ ๋ฉ๋ถ์ธ์ก |
vat_card_sales_credit | ์นด๋ ๋ฐํ์ธ์ก๊ณต์ |
vat_bad_debt_credit | ๋์์ธ์ก๊ณต์ (ํ์ํ๋ฉด ๋งค์ถ์ธ์ก ๊ฐ์ฐ) |
underreporting_penalty | ๊ณผ์์ ๊ณ ๊ฐ์ฐ์ธ |
late_payment_penalty | ๋ฉ๋ถ์ง์ฐ๊ฐ์ฐ์ธ |
withholding_late_payment_penalty | ์์ฒ์ง์ ๋ฉ๋ถ์ง์ฐ๊ฐ์ฐ์ธ(๊ตญ์ธ๊ธฐ๋ณธ๋ฒ ์ 47์กฐ์5, 3%+์ผํ , ํ๋) |
invoice_penalty | ์ธ๊ธ๊ณ์ฐ์ ๊ฐ์ฐ์ธ |
assessment_limitation | ๋ถ๊ณผ์ ์ฒ๊ธฐ๊ฐ |
refund_claim_deadline | ๊ฒฝ์ ์ฒญ๊ตฌ ๊ธฐํ(ํต์ 5๋
ยทํ๋ฐ์ 3๊ฐ์ยท์ฆ์ก๊ฒฝ์ ๋ถ 3๊ฐ์, ํ ยท์ผยท๊ณตํด์ผ ๊ธฐํ ํน๋ก ๋ฐ์) |
vat_exempt_use_deemed_supply | ๋ฉด์ธ์ ์ฉ ๊ฐ์ฃผ๊ณต๊ธ |
vat_input_tax_deduction | ๋งค์
์ธ์ก ๊ณต์ ํ์ |
vat_deemed_supply_items | ๊ฐ์ฃผ๊ณต๊ธ ํ์ |
vat_tax_base_adjustments | ๊ณผ์ธํ์ค ์กฐ์ โ ๋ฐํ(ํ์
)ยท์๋๋ฆฌยทํ ์ธยท์ฅ๋ ค๊ธยท๋์๊ธ, ๋ง์ผ๋ฆฌ์งยทํฌ์ธํธ ๊ฒฐ์ ๊ฑฐ๋์ ๊ณต๊ธ๊ฐ์ก(๋ถ๊ฐ๊ฐ์น์ธ๋ฒ ์ 29์กฐ, ์ํ๋ น ์ 61์กฐ) |
vat_supply_timing | ๊ณต๊ธ์๊ธฐ ํ์ (์์ ยทํ์ ๊ท์) |
์ฌ์ค๊ด๊ณยท์์ฅ โ ์ธ๋ฌด์กฐ์ (15)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
bad_debt_adjustment | ๋์ ์กฐ์ |
entertainment_adjustment | ๊ธฐ์
์
๋ฌด์ถ์ง๋น ์กฐ์ |
deemed_dividend_bonus_shares | ๋ฌด์์ฃผ ์์ ๋ฐฐ๋น |
financial_income_aggregate | ๊ธ์ต์๋ ํฉ์ฐ |
other_income_aggregate | ๊ธฐํ์๋ |
earned_income_gross_pay | ๊ทผ๋ก์๋ ์ด๊ธ์ฌ |
simplified_vat_return | ๊ฐ์ด๊ณผ์ธ ํ์ ์ ๊ณ |
vat_return_general | ์ผ๋ฐ๊ณผ์ธ์ ๋ถ๊ฐ๊ฐ์น์ธ ์ ๊ณ ์(๋ณ์ง ์ 21ํธ์์) ์ง๊ณ โ ๋ถํ ๋๊ตฌ ๊ฒฐ๊ณผ๋ฅผ ์ฐจ๊ฐ๊ฐ ๋ฉ๋ถ(ํ๊ธ)์ธ์ก๊น์ง ํฉ์ฐ |
vat_foreign_currency_base | ์ธํ ๋๊ฐ ๋ถ๊ฐ๊ฐ์น์ธ ๊ณผ์ธํ์ค ํ์ฐ(์ํ๋ น ์ 59์กฐยท์ 95์กฐ์ 3ํญ) |
vat_reverse_charge | ๊ตญ์ธ์ฌ์
์ ์ฉ์ญ๋ฑ ๋๋ฆฌ๋ฉ๋ถ(๋ฒ ์ 52์กฐ) |
common_input_tax | ๊ณตํต๋งค์
์ธ์ก ์ ์ฐ |
input_tax_recalculation | ๋งค์
์ธ์ก ์ฌ๊ณ์ฐ |
bundled_supply_split | ํ ์งยท๊ฑด๋ฌผ ์๋ถ |
depreciation_adjustment | ๊ฐ๊ฐ์๊ฐ ์๋ถ์ธ |
retirement_allowance_adjustment | ํด์ง๊ธ์ฌ์ถฉ๋น๊ธ |
deemed_dividend_capital_reduction | ๊ฐ์ ์์ ๋ฐฐ๋น |
inventory_valuation_adjustment | ์ฌ๊ณ ์์ฐ ํ๊ฐ |
income_adjustment_total | ์ฐจ๊ฐ๊ฐ์๋๊ธ์ก |
์ฃผ์ยท์ฌ์ฐ ํ๊ฐ (7)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
stock_major_shareholder | ์ฃผ์ ์๋์ธ ๋์ฃผ์ฃผ ํ์ (์ฃผ์ฃผ ๋ช
๋ถ๋ก ์ง๋ถ์จยทํฉ์ฐ ๋ฒ์๊น์ง) |
stock_capital_gains_tax | ์ฃผ์ ์๋์๋์ธ(๊ณผ์ธ ๋์ ์ฌ๋ถยท์ธ์จยท์์ ์ ๊ณ ๊ธฐํ) |
unlisted_stock_valuation | ๋น์์ฅ์ฃผ์ ์์ยท์ฆ์ฌ ํ๊ฐ(์์์ตยท์์์ฐ ๊ฐ์คํ๊ท , ํ ์ฆ) |
stock_basis_income_tax | ๋น์์ฅ์ฃผ์ ์๋์ธ๋ฒ ๊ธฐ์ค์๊ฐ |
building_standard_price | ๊ฑด๋ฌผ ๊ธฐ์ค์๊ฐ(๊ตญ์ธ์ฒญ ๊ณ ์ ์ฐ์) |
stock_price_lookup | ์์ฅ์ฃผ์ ์์ธ ์กฐํ(KRX) |
official_property_price | ๋ถ๋์ฐ ๊ณต์๊ฐ๊ฒฉ ์กฐํ(๋ธ์ด์๋, VWORLD_KEY) |
์ธ๋ฌด์กฐ์ฌ ํ์ (9)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
related_judge | ํน์๊ด๊ณ(์๊ณ๋ฅผ ํจ๊ปํ๋ ์น์กฑ ํฌํจ) |
kinship_check | ์น์กฑ๊ด๊ณ |
ownership_ratio | ๊ฐ์ ๋ณด์ ๋น์จ |
dominant_shareholder | ์ง๋ฐฐ์ฃผ์ฃผ |
tunnelling_gift | ์ผ๊ฐ๋ชฐ์์ฃผ๊ธฐ |
tunnelling_gift_nts | ์ผ๊ฐ๋ชฐ์์ฃผ๊ธฐ(๊ตญ์ธ์ฒญ ์ฐ์) |
related_provision_at | ํน์๊ด๊ณ ์กฐ๋ฌธ ์์น |
return_precheck | ์ ๊ณ ์ ์ฌ์ ๊ฒํ |
precheck_schema | ์ฌ์ ๊ฒํ ์
๋ ฅ ๋ชฉ๋ก |
PDF ํ ์ถ์ถ (3)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
extract_relations | ๊ด๊ณํ |
tunnelling_from_pdf | ์ผ๊ฐ๋ชฐ์์ฃผ๊ธฐ ์๋ฃ |
return_precheck_pdf | ๋ฒ์ธ์ธ ์ ๊ณ ์ |
๊ตญ์ธ์ง์ (1)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
tax_priority_distribution | ๊ตญ์ธ ์ฐ์ ๊ถ ๋งค๊ฐ๋๊ธ ๋ฐฐ๋ถ |
์์
๋ด๋ณด๋ด๊ธฐ (1)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
export_workbook | ๊ณ์ฐ ๊ทผ๊ฑฐ ์์
|
๋๊ตฌ ์ฐพ๊ธฐ (1)
| ๋๊ตฌ | ํ๋ ์ผ |
|---|
find_tool | ํ์ ๋ง๋ก ๋ง๋ ๋๊ตฌ ์ฐพ๊ธฐ |
- ๊ณ์ฐ ๊ทผ๊ฑฐ ์์
:
export_workbook์ ์ฌ๋ฌ ๋๊ตฌ ํธ์ถ์ ๋ค์ ์คํํด ๋ฒ์ ์์ ๋ชจ์(๋ณ์ง ์ 3ํธยท์ 4ํธยท์ 8ํธ(๊ฐ)ยท์ 15ํธยท์ 21ํธยท์ 23ํธ(๊ฐ)(์)ยท์ 29ํธยท์ 32ํธยท์ 33ํธยท์ 34ํธยท์ 20ํธ(1)ยท์ 16ํธ์2ยท์ 26ํธ(๊ฐ)(์)ยท์ 50ํธ(์), ๋ถ๊ฐ์ธ ๊ณต์ ๋ฐ์ง ๋ชปํ ๋งค์
์ธ์ก ๋ช
์ธ์, ์ข
ํฉ์๋์ธ ๋ถ์ ๋ช
์ธ์, ์๋์๋์ธ ๋ณ์ง ์ 84ํธ ์ ๊ณ ์ ์ธ์ก ๊ณ์ฐยท๋ถํ1 ์๋์๋๊ธ์ก ๊ณ์ฐ๋ช
์ธ์ ๋ฑ)์ ๊ฒํ ์ฉ ์์
๋ก ๋ง๋ญ๋๋ค. ๊ธ์ก ์นธ์ ์์ ์ฐ์ ๊ทธ๋๋ก์ ์์์ด๊ณ ์์๋ผ๋ฆฌ ์ฐ๊ฒฐ๋๋ฉฐ(๋ชจ๋ ๊ธ์ก ์นธ์ด '์
๋ ฅยท๊ฐ์ ' ์ด๋ฆ์ด๋ ์ ์นธ์ ๊ฐ๋ฆฌํค๋ ์์ โ ๋๊ตฌ ๊ฐ์ ์ซ์๋ก ๋ฐ์ง ์์), ๋๊ตฌ ๊ฐ๊ณผ ๋์กฐํ๋ ํ์ธ ์นธ์ด ๋ถ์ต๋๋ค. ๊ณ์ฐ ๊ณผ์ ์ ๋ณด์ฌ ์ฃผ๋ ์ฐธ๊ณ ์๋ฃ์ด๋ฉฐ ์ธ๋ฌด์กฐ์ ๊ณ์ฐ์ ์์ฑยท์ ๊ณ ๋๋ฆฌ๊ฐ ์๋๋๋ค. ๊ธฐ์
์
๋ฌด์ถ์ง๋น๋ entertainment_limit ๋๊ตฌ๋ก๋ ๋ณ์ง ์ 23ํธ(๊ฐ)ยท(์)๊ฐ ๋์ต๋๋ค.
- ์์ฅ ๊ทธ๋๋ก ์
๋ ฅ: ์ธ๋ฌด์กฐ์ ๋๊ตฌ๋ ์ฅ๋ถ ํญ๋ชฉ(์ด๋ฆยท๊ธ์กยท์ฆ๋นยท์ฑ๊ฒฉ)์ ๊ทธ๋๋ก ๋ฐ์ ํญ๋ชฉ ํ๋จ โ ์ธ๋ฌด์กฐ์ โ ์๋์ฒ๋ถ๊น์ง ๋๋ ค์ค๋๋ค.
- ์์ ํ์: ๋น๊ฑฐ์ฃผ์ ์์ฒ์ง์ยท๊ณผ์์๋ณธ ๊ฒฐ๊ณผ์๋ ๋คํผ์ด ๋ ์ ์๋ ์ง์ ๊ณผ ํ์ธํ ์๋ฃ๋ฅผ ํจ๊ป ๋ถ์
๋๋ค(๊ฒฐ๋ก ์ ๋ด๋ฆฌ์ง ์์).
- ์ง์ ์ฐ๋: ๋ฒ์ธ์ธ 2016โ2026 ์ฌ์
์ฐ๋, ์๋์ธ 2016โ2026 ๊ท์์ฐ๋, ๋ถ๊ฐ๊ฐ์น์ธ 2016๋
1๊ธฐโ2026๋
2๊ธฐ, ๊ฐ์ฐ์ธยท์ ์ฒ๊ธฐ๊ฐ์ ํํ ์กฐ๋ฌธ. ๊ทธ ๋ฐ์ ์ฐ๋๋ ์ค๋ฅ๋ก ๋ฉ์ถฅ๋๋ค. ์ง๋ฐฉ์๋์ธ๋ ๋ณ๋์
๋๋ค.
์ฒ๋ฆฌํ์ง ์๋ ๊ฒฝ์ฐ
์ฒ๋ฆฌํ์ง ๋ชปํ๋ ๊ฒฝ์ฐ์๋ ๊ณ์ฐํ์ง ์๊ณ "์
๋ ฅ ํ์ธ ํ์"๋ ์ค๋ฅ๋ก ๋ฉ์ถ๊ฑฐ๋, ๊ฒฐ๊ณผ์ ํ๋จ์ "ํ์ธ ํ์"๋ก ์๋ฆฝ๋๋ค. ๊ฒฐ๊ณผ๋ฅผ ์ฐ๊ธฐ ์ ์ ์๋์ ํด๋นํ๋์ง ๋จผ์ ํ์ธํด ์ฃผ์ธ์.
๊ณตํต
- ์ง์ ์ฐ๋ ๋ฐ(๋ฒ์ธ์ธ 2016โ2026 ์ฌ์
์ฐ๋, ์๋์ธ 2016โ2026 ๊ท์์ฐ๋, ๋ถ๊ฐ๊ฐ์น์ธ 2016๋
1๊ธฐโ2026๋
2๊ธฐ)๊ณผ ์ง๋ฐฉ์๋์ธ
- ์ฃผํ ์ยทํน์๊ด๊ณยท์ฌ์
๊ด๋ จ์ฑ์ฒ๋ผ ์ฌ์ค๊ด๊ณ ํ๋จ์ด ๋จผ์ ์ธ ํญ๋ชฉ์ ์ฌ์ฉ์๊ฐ ํ๋จํด ๋ฃ์ ๊ฐ์ผ๋ก ๊ณ์ฐํฉ๋๋ค(๋๊ตฌ๊ฐ ํ๋จํ์ง ์์)
- ํฉ๋ณยท๋ถํ ์ธ๋ฌด์กฐ์ ์ ์ฉ ๋๊ตฌ๋ ์์ต๋๋ค
๋๊ตฌ๋ณ๋ก ์ฒ๋ฆฌํ์ง ์๋ ๊ฒฝ์ฐ (๋๊ตฌ ์ค๋ช
์์ ๋ชจ์)
| ๋๊ตฌ | ์ฒ๋ฆฌํ์ง ์๋ ๊ฒฝ์ฐ |
|---|
retirement_allowance_adjustment | ํ์ ๊ธฐ์ฌํ ์ ํ ์ ๊ทผ๋ฌด๋ถ ํด์ง๊ธ์ฌ์ถฉ๋น๊ธ(์ํ๊ท์น ์ 31์กฐ์ 2ํญ)์ ์
๋ ฅํ ๊ธ์ก์ ๋ผ์ด ๋๋ ๊ฒ๊น์ง๋ง ์ฒ๋ฆฌ โ ๊ธ์ก ๊ณ์ฐ, ํ์ ๊ธฐ์ฌํ๋ง ์๋ ํ์ฌ์ ์
๋ ฅ, ๊ทธ ๋ชซ์ ์ง๊ธยท์ด์ , ๊ด๋ จ ๋ถ์ธ๋๊ณ ๊ตฌ๋ถ์ ํ์ง ์์. ๋ณ์ง ์ 33ํธ์์ โง์ด ์์์ผ ๋์ ์ต๊ธ์ฐ์
|
capital_gains_incomeยทcapital_gains_tax | ๋ถ์๊ถยท์กฐํฉ์์
์ฃผ๊ถยท์ฃผ์, 2018.4.1. ์ ์๋ ์ง์ ์ง์ญ 3์ฃผํ ์ด์ ๊ฐ์ฐ, ์ฃผํ ์ ๊ณ์ฐ, ๋น๊ณผ์ธ ๋ณด์ ๊ธฐ๊ฐ ์์ธ, ์ฃผ๊ฑฐ์ฉ ์ ํ, ๊ณ ๊ฐ์ฃผํ ์ผ๋ถ ์๋ |
stock_capital_gains_tax | 2019๋
์ด์ ๊ตญ์ธ์ฃผ์, ํ์์ํ, ์๋์ฐจ์ ํต์ฐ |
housing_rental_income | ๊ฒธ์ฉ์ฃผํ ์ฃผํ ๋ถ๋ถ ํ์ , ๊ณต๋์์ ์ฃผํ์ ์ฃผํ ์ ํ์ (์ฃผํ ์๋ฅผ ์ง์ ๋ฃ์ผ๋ฉด ๊ณ์ฐ) |
dividend_tax_credit | ์ข
ํฉ์๋๊ณต์ ๊ฐ ๊ธ์ต์๋ ์ธ ์๋๋ณด๋ค ํฐ ๊ฒฝ์ฐ, ์กฐ์ธํน๋ก์ ํ๋ฒ ์ 104์กฐ์27 ๋ฐฐ๋น(2016โ2018), ๋ค๋ฅธ ์ธ์ก๊ณต์ ยท๊ฐ๋ฉด |
religious_income | ๊ทผ๋ก์๋ ์ ํ ๊ฒฝ๋ก, ๊ฐ์ด์ธ์กํยท์ฐ๋ง์ ์ฐ ์ธ์ก, ๋น๊ณผ์ธ ์๊ฑด ํ์ , ๋ค๋ฅธ ๊ธฐํ์๋๊ณผ์ 300๋ง ์ ํฉ์ฐ ํ์ |
gift_tax | ์์์ธ ๋ฐ ์ฆ์ฌ์ธ๋ฒ ์ 58์กฐ์ 1ํญ ๋จ์(๊ฐ์ฐ๋ถ ์ฆ์ฌ์ธ๊ฐ ์ ์ฒ๊ธฐ๊ฐ ๋ง๋ฃ๋ก ๋ถ๊ณผ๋์ง ์์ ๊ฒฝ์ฐ) |
inheritance_gift_valuation | ํ ์งยท๊ฑด๋ฌผ ์์ ์๊ฐ ๋ค๋ฅผ ๋ ํ์ฐ๊ฐ์ก ์๋ถ, ๊ณต๋์ ๋น ์๋ถ |
unlisted_stock_valuation | ํ๊ฐ์ฌ์์์ํ, ์์ฐ๋ณ ์๊ฐ์ ํ๊ฐ๊ธฐ๊ฐ ํ์ , ๊ตญ์ธ ๋น์์ฅ์ฃผ์ |
vat_supply_timing | ์ํ๊ถยท๊ฐ๊ณตยท๋ฌด์ธํ๋งค๊ธฐยท๊ตญ๋ด ์ํํ๋งคยท๊ฐ์ฃผ๊ณต๊ธ, ๋ถ๋์ฐ ์๋ยท์ ๋ถ ์ฐํ๋น, ์ธ๊ตญํญํ์ฉ์ญ, ํ์
์ผ ์์ , ๊ณต๊ธ์๊ธฐ ํ ๋ฐ๊ธ ๊ฐ์ฐ์ธ(์์ถ์ ์ง์์ถยท์ค๊ณ๋ฌด์ญยท๋ณด์ธ๊ตฌ์ญ๋ฐ์ถยท์ํํ๋งค์์ถยท์ธ๊ตญ์ธ๋์์ถยท์ํ๊ฐ๊ณต๋ฌด์ญยท์๋ฃ๋ฐ์ถ ์ง์) |
vat_deemed_supply_items | 2020๋
์ 1๊ธฐ ์ด์ ์ฌ์ฉ์ธ ์ ๋ฌผ ํ๋ |
refund_claim_deadline | 2016๋
์ ์ฌ์ ยทํต์ง, 2015๋
์ ๊ฐ์ ๊ฒฝ๊ณผ์กฐ์น, ํ๋ฐ์ ์ฌ์ ํด๋น ์ฌ๋ถ ํ์ |
tax_priority_distribution | ๊ฐ์๋ฅ์ฑ๊ถ ์๋ถยทํก์๋ฐฐ๋น, ์กฐ์ธ ์ํธ๊ฐ ํก์๋ฐฐ๋น, ๋ด๋ณด๊ถ ์ํ๊ด๊ณ, ๊ณต๊ณผ๊ธ, ๋ฉ์ธ๋ด๋ณด ๋ฑ(์
๋ ฅ ํ์ธ ํ์๋ก ๋ฐํ) |
individual_donation_expense | ๊ธฐ๋ถ๊ธ ์ธ์ก๊ณต์ ๊ธ์ก ์์ฒด |
stock_major_shareholder | ์๊ฐ์ด์ก ์กฐํ(์ฌ์ฉ์๊ฐ ๊ณ์ฐํด ๋ฃ์) |
minimum_tax_adjustment | ์ ๋ฐํ์ค์ด์ต(119), ๋ฒ์ธ์ธ๋ฒ ์ 59์กฐ ๊ฐ๋ฉดยท๊ณต์ ์์์ ์ ์ฉ์ ์ธ ํญ๋ชฉ ํ๋, ๊ธฐ๋ถ๊ธ ํ๋ ์ฌ๊ณ์ฐ, ๊ณต์ ๊ฐ๋ฉด์ธ์ก๊ณ์ฐ์(๋ถํ)ยท์ถ๊ฐ๋ฉ๋ถ์ธ์ก(์) |
๊ฐ ๋๊ตฌ์ ์ค๋ช
์ ์์ธํ ๋ฒ์๊ฐ ์์ต๋๋ค.
๋ฉด์ฑ
๋ฐ ๊ณ ์ง
- ๋ฉด์ฑ
: ์ด ๋๊ตฌ์ ๊ฒฐ๊ณผ๋ ์ธ๋ฌด ์๋ฌธ์ด ์๋๋๋ค. ๋ฒ๋ นยทํด์์ ๋ฐํ์ผ๋ก ๊ณ์ฐยทํ์ ๊ณผ์ ์ ๋ณด์ฌ ์ฃผ๋ ์ฐธ๊ณ ์๋ฃ์ด๋ฉฐ, ์ค์ ์ ๊ณ ยท์ธ๋ฌด์กฐ์ฌยท๋ถ๋ณต ํ๋จ์ ์ธ๋ฌด์ฌยทํ๊ณ์ฌยท๋ณํธ์ฌ ๋ฑ ์ ๋ฌธ๊ฐ์๊ฒ ํ์ธํ์ธ์. ๊ทผ๊ฑฐ ์กฐ๋ฌธยทํ๋ก๋ ์๋ฌธ์ผ๋ก ํ์ธํ์ธ์.
- ์ธ๋ฌด๋๋ฆฌ ์๋: ์ด ๋๊ตฌ๋ ์ธ๋ฌด์ฌ๋ฒ ์ 2์กฐ์ ์ธ๋ฌด๋๋ฆฌ(์ธ๋ฌด์กฐ์ ๊ณ์ฐ์ ์์ฑ, ์ ๊ณ ๋๋ฆฌ, ์ธ๋ฌด์๋ด ๋ฑ)๋ฅผ ์ํํ์ง ์์ผ๋ฉฐ, ๊ทธ ์
๋ฌด๋ ์ธ๋ฌด์ฌ์ ๋ฑ๋กํ ๊ณต์ธํ๊ณ์ฌยท๋ณํธ์ฌ๋ง ํ ์ ์์ต๋๋ค(์ธ๋ฌด์ฌ๋ฒ ์ 20์กฐ). ๋ฒ๋ น์ ์ ํ ์ฐ์์ ์ฝ๋๋ก ์ฎ๊ฒจ ์
๋ ฅ๊ฐ์ ๋ํ ๊ณ์ฐ ๊ณผ์ ์ ๋ณด์ฌ ์ฃผ๋ ์ํํธ์จ์ด์ด๊ณ , ์
๋ ฅ ์ฌ์ค๊ด๊ณ์ ํ์ธ๊ณผ ์ต์ข
ํ๋จ์ ์ธ๋ฌด ์ ๋ฌธ๊ฐ(์ธ๋ฌด์ฌยทํ๊ณ์ฌยท๋ณํธ์ฌ)์ ํจ๊ป ํด ์ฃผ์ธ์.
- AI ์ฌ์ฉ ๊ณ ์ง: ๊ณ์ฐยทํ์ ยท์กฐํ ๋๊ตฌ 101๊ฐ๋ ์ฝ๋๋ก ๋์ํ๋ฉฐ ์์ฑํ AI๋ฅผ ์ฐ์ง ์์ต๋๋ค. PDF ๊ฒํ ๋๊ตฌ 3๊ฐ(
extract_relations, tunnelling_from_pdf, return_precheck_pdf)๋ UPSTAGE_API_KEY๊ฐ ์์ผ๋ฉด ์์ฑํ AI(Upstage Solar Pro 4)๋ก ํ๋ฅผ ์ถ์ถํ๋ฉฐ ๊ฒฐ๊ณผ์ ๊ทธ ์ฌ์ค์ ํ์ํฉ๋๋ค. ํค๊ฐ ์์ผ๋ฉด pypdf๋ก ๋ก์ปฌ ํ
์คํธ ์ถ์ถ(host_ai ๋ชจ๋) ํ ์ ๋ฆฌ ์๋ด์ ๋ฐ๋ผ ๋ค์ ๋๊ตฌ ์
๋ ฅ์ผ๋ก ์ง์ ์ ๋ฆฌํ ์ ์์ต๋๋ค.
- ๋ฐ์ดํฐ ์ ์ก: UPSTAGE_API_KEY๋ฅผ ์ค์ ํด PDF ๋๊ตฌ๋ฅผ ์ฌ์ฉํ ๋๋ง ๋ฌธ์ ๋ด์ฉ์ด Upstage API(api.upstage.ai)๋ก ์ ์ก๋ฉ๋๋ค. ์์ธ ์กฐํ(
stock_price_lookup)๋ KRX๋ก ์ข
๋ชฉ์ฝ๋ยท๋ ์ง๋ฅผ, ๊ณต์๊ฐ๊ฒฉ ์กฐํ(official_property_price, VWORLD_KEY ํ์)๋ ๋ธ์ด์๋๋ก ์ฃผ์ยทํ์ง๋ฒํธยท์ฐ๋๋ฅผ ๋ณด๋
๋๋ค. ํค ์์ด ์ฌ์ฉํ๋ฉด(pypdf ๋ก์ปฌ ์ถ์ถ) ์ธ๋ถ ์ ์ก์ด ์์ต๋๋ค. ๋ฏผ๊ฐ์ ๋ณด๊ฐ ๋ด๊ธด ๋ฌธ์๋ API ์ ์ก ์ ๋ฃ์ง ๋ง์ธ์.
๋ผ์ด์ ์ค
MIT ยฉ 2026 Upstage ยท Created by Mia(์ค์น๋ฏธ)