korail-mcp
๐ฐ๐ท ํ๊ตญ์ด ยท ๐ฌ๐ง English
KORAIL ๊ณต๊ณต๋ฐ์ดํฐ MCP
ํ๊ตญ์ฒ ๋๊ณต์ฌ(KORAIL) ๊ณต๊ณต๋ฐ์ดํฐ๋ฅผ AI์ ์ฐ๊ฒฐํ๋ MCP(Model Context Protocol) ์๋ฒ ๋ชจ์์ ๋๋ค. ์ค์น ํ Claude DesktopยทClaude CodeยทCursorยทAntigravityยทGitHub Copilot(CLI/VS Code) ๋ฑ์์ ์์ฐ์ด๋ก KORAIL ๋ฐ์ดํฐ๋ฅผ ์กฐํํ ์ ์์ต๋๋ค.
โ API ํค ์ ์ฒญ ๋ถํ์ โ ์ ์ฉ ํ๋ก์ ์๋ฒ๊ฐ ๊ณต๊ณต๋ฐ์ดํฐ API ํธ์ถ์ ๋์ ์ฒ๋ฆฌํฉ๋๋ค.
๐ป ๋ก์ปฌ ์ค์นํ (stdio) โ ๋ณ๋ ์๋ฒ ์์ด ๊ฐ์ธ PC์์ ์ง์ ์คํ๋ฉ๋๋ค. Claude DesktopยทClaude CodeยทCursorยทAntigravityยทGitHub Copilot(CLI/VS Code) ๋ฑ ๋ก์ปฌ MCP ํด๋ผ์ด์ธํธ์ ์ฐ๊ฒฐํฉ๋๋ค. ChatGPTยทGrok ๊ฐ์ ์น ์๋น์ค๋ ์๊ฒฉ ์ฐ๊ฒฐ์ด ํ์ํฉ๋๋ค(ํ๋จ "๊ทธ ๋ฐ์ ๋ฐฉ์" ์ฐธ๊ณ ).
๐ฆ ํ์ ๋์คํฌ ๊ณต๊ฐ โ ์ฝ 100MB (
uv๊ฐ ๊ด๋ฆฌํ๋ Python๊ณผ ํจํค์ง ํฌํจ)
๐ ์ฒ์์ด์ ๊ฐ์? ๋ฐ๋ก ์๋ "์ ์ผ ์ฌ์ด ๋ฐฉ๋ฒ"๋ถํฐ ์๋ํด๋ณด์ธ์. 98๊ฐ ๋๊ตฌ ์ ์ฒด ๋ชฉ๋ก์ ์ค์น๋ฅผ ๋ง์น ๋ค ํ์ํ ๋ ์ฐธ๊ณ ํ์ธ์.
๐ค ์ ์ผ ์ฌ์ด ๋ฐฉ๋ฒ โ AI์๊ฒ ๊ทธ๋๋ก ์ํค๊ธฐ
Claude CodeยทCursorยทGitHub Copilot(CLI/VS Code)ยทAntigravity์ฒ๋ผ ํฐ๋ฏธ๋ ๋ช ๋ น์ ์ง์ ์คํํ ์ ์๋ AI๋ฅผ ์ฐ๊ณ ์๋ค๋ฉด, ๊ทธ ์ฑํ ์ฐฝ์ ์๋ ๋ฌธ์ฅ์ ๊ทธ๋๋ก ๋ถ์ฌ๋ฃ์ผ์ธ์.
https://github.com/lovelyquality/korail-mcp ์ README๋ฅผ ์ฐธ๊ณ ํด์ ์ด MCP ์๋ฒ๋ฅผ ์ค์นํ๊ณ ๋ด ํด๋ผ์ด์ธํธ์ ์ฐ๊ฒฐํด์ค.AI๊ฐ README๋ฅผ ์ง์ ์ฝ๊ณ uv ์ค์น โ korail-mcp ์ค์น โ ํด๋ผ์ด์ธํธ ์ค์ ํ์ผ ๋ฑ๋ก๊น์ง ์์์ ์ฒ๋ฆฌํฉ๋๋ค. ์๋ฃ๋๋ฉด "์์ธ์ญ์ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์๋์?" ๊ฐ์ ์ง๋ฌธ์ผ๋ก ํ์ธํด๋ณด์ธ์.
โ ๏ธ ChatGPTยทGrok์ฒ๋ผ ๋ก์ปฌ ๋ช ๋ น์ ์คํํ์ง ๋ชปํ๋ AI์์๋ ์ด ๋ฐฉ๋ฒ์ด ํตํ์ง ์์ต๋๋ค(์์ธ์ง๋ ํ๋จ "๊ทธ ๋ฐ์ ๋ฐฉ์" ์ฐธ๊ณ ). ๊ทธ๋ฆฌ๊ณ AI๊ฐ ์ค๊ฐ์ ๋งํ๊ฑฐ๋, ์ ์ด์ ์ด๋ฐ ๋ฐฉ์์ AI ๋๊ตฌ๊ฐ ์๋ค๋ฉด โ ๋ฐ๋ก ์๋ "์๋ ์ค์น"๋ฅผ ๊ทธ๋๋ก ๋ฐ๋ผ ํ์๋ฉด ๋ฉ๋๋ค.
Related MCP server: Korea Stats MCP
โ๏ธ ์๋ ์ค์น (Windows ยท 2๋จ๊ณ)
Python์ ๋ฐ๋ก ์ค์นํ๊ฑฐ๋ ์ ์ฅ์๋ฅผ ๋ค์ด๋ก๋ํ ํ์๊ฐ ์์ต๋๋ค. uv๊ฐ ํ์ํ ๊ฒ์ ์์์ ์ค๋นํฉ๋๋ค.
1๋จ๊ณ โ uv ์ค์น (์ต์ด 1ํ)
PowerShell์ ์ด๊ณ ์๋๋ฅผ ๋ถ์ฌ๋ฃ์ต๋๋ค. ๊ด๋ฆฌ์ ๊ถํ์ด ํ์ ์์ต๋๋ค.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"์ค์น ํ PowerShell์ ์๋ก ์ด๊ณ uv --version์ด ์ถ๋ ฅ๋๋ฉด ์ฑ๊ณต์
๋๋ค.
2๋จ๊ณ โ KORAIL MCP ์ค์น (์ต์ด 1ํ)
uv tool install --from git+https://github.com/lovelyquality/korail-mcp.git korail-mcp๋ง์ง๋ง์ Installed 1 executable: korail-mcp ๊ฐ ๋์ค๋ฉด ์ฑ๊ณต์
๋๋ค.
โณ ์ฒซ ์ค์น๋ 1~3๋ถ ๊ฑธ๋ฆฝ๋๋ค(Python๊ณผ ํจํค์ง๋ฅผ ๋ฐ๋ ์๊ฐ). ์ค์น ํ ์คํ์ ์ฝ 5์ด์ ๋๋ค.
๐ ์ต์ ๋ฒ์ ์ผ๋ก ๊ฐฑ์ โ
uv tool upgrade korail-mcp์คํ ํ ํด๋ผ์ด์ธํธ๋ฅผ ์ฌ์์ํ์ธ์.โ ๏ธ ๊ฐฑ์ ์ ์๋ korail-mcp๋ฅผ ์ฐ๋ ํด๋ผ์ด์ธํธ(Claude DesktopยทCursorยทAntigravityยทVS Code ๋ฑ)๋ฅผ ๋จผ์ ์์ ํ ์ข ๋ฃํ์ธ์. ์คํ ์ค์ธ ์ํ๋ก ๊ฐฑ์ ํ๋ฉด ์คํํ์ผ์ด ์ ๊ฒจ ์์ด ๋ด๋ถ ํจํค์ง๋ง ์ ๋ฒ์ ์ผ๋ก ๋ฐ๋๊ณ ์คํํ์ผ์ ๊ทธ๋๋ก ๋จ์
ModuleNotFoundError: No module named 'gateway'๋ก ๊นจ์ง ์ ์์ต๋๋ค (2026-08-24 ์ค์ธก์ผ๋ก ์ฌํยทํ์ธ). ์ด๋ฏธ ์ด ์๋ฌ๊ฐ ๋๋ฉดkorail-mcp.exe๋ฅผ ์ฐ๋ ๋ชจ๋ ํ๋ก์ธ์ค๋ฅผ ์์ ๊ด๋ฆฌ์์์ ์ข ๋ฃํ ๋คuv tool install --from git+https://github.com/lovelyquality/korail-mcp.git korail-mcp --force๋ก ์ฌ์ค์นํ์ธ์. ์ฌ๋ฌ ํด๋ผ์ด์ธํธ๊ฐ ๊ฐ์ ์ค์น๋ฅผ ๋์์ ์ฐ๋ ๊ฒ ์์ฒด๋ ๋ฌธ์ ์์ต๋๋ค โ ์ถฉ๋์ ๊ฐฑ์ ํ๋ ๊ทธ ์๊ฐ์๋ง ์ผ์ด๋ฉ๋๋ค.
๐ 3๋จ๊ณ โ ํด๋ผ์ด์ธํธ ์ฐ๊ฒฐ
์๋ JSON์ ํด๋ผ์ด์ธํธ ์ค์ ํ์ผ์ mcpServers ์์ ๋ฃ๊ณ , <์ฌ์ฉ์๋ช
> ๋ถ๋ถ๋ง ๋ณธ์ธ ์๋์ฐ ๊ณ์ ๋ช
์ผ๋ก ๋ฐ๊ฟ๋๋ค.
{
"mcpServers": {
"korail-mcp": {
"command": "C:\\Users\\<์ฌ์ฉ์๋ช
>\\.local\\bin\\korail-mcp.exe"
}
}
}๐ก ๊ณ์ ๋ช ์ ๋ชจ๋ฅด๋ฉด PowerShell์
echo $env:USERNAME์ ์ ๋ ฅํ์ธ์. ๊ฒฝ๋ก์ ์ญ์ฌ๋์๋ JSON ๊ท์น์ ๋ ๊ฐ(\\) ๋ก ์๋๋ค.โ ๏ธ ์ด๋ฏธ ๋ค๋ฅธ MCP ์๋ฒ๋ฅผ ์ฐ๊ณ ์๋ค๋ฉด
korail-mcpํญ๋ชฉ๋ง ๊ธฐ์กดmcpServers์์ ์ถ๊ฐํ์ธ์(์ ์ฒด๋ฅผ ๋ฎ์ด์ฐ๋ฉด ๊ธฐ์กด ์๋ฒ๊ฐ ์ฌ๋ผ์ง๋๋ค).
์ค์ ํ์ผ ์์น
ํด๋ผ์ด์ธํธ | ์ค์ ํ์ผ |
Claude Desktop |
|
Claude Code |
|
Cursor |
|
Antigravity |
|
GitHub Copilot CLI |
|
VS Code (GitHub Copilot Chat) | ์๋ ๋ณ๋ ์๋ด ์ฐธ๊ณ (JSON ํ์์ด ๋ค๋ฆ) |
ํ์๊ธฐ ์ฃผ์์ฐฝ์
%APPDATA%์ ๋ ฅ โ EnterClaudeํด๋๊ฐ ์์ผ๋ฉด ์ง์ ๋ง๋์ธ์๊ทธ ์์
claude_desktop_config.jsonํ์ผ์ ๋ง๋ค๊ณ ์ JSON์ ๋ฃ์ผ์ธ์
AppData๊ฐ ์ ๋ณด์ด๋ฉด ํ์๊ธฐ โ ๋ณด๊ธฐ โ ์จ๊ธด ํญ๋ชฉ์ ์ฒดํฌํ์ธ์.
ํฐ๋ฏธ๋์์ ์ฐ๋ Claude Code CLI(claude, VS Code๋ Claude Desktop ์์ด๋ ๋์)๋ก ์ค์ ๊ณ์ ๋ถ์ฌ์ ๊ฒ์ฆํ์ต๋๋ค.
# 1) korail-mcp๋ฅผ MCP ์๋ฒ๋ก ๋ฑ๋ก (์ต์ด 1ํ)
claude mcp add korail-mcp -s user -- "C:\Users\<์ฌ์ฉ์๋ช
>\.local\bin\korail-mcp.exe"
# 2) ์ค์ ์ง๋ฌธ (ํด๋น ๋๊ตฌ๋ง ํ์ฉ)
claude -p "korail-mcp ๋๊ตฌ๋ฅผ ์ฌ์ฉํด์ ์์ธ์ญ์ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์๋์ง ์๋ ค์ค" --allowedTools "mcp__korail-mcp__*"โ 2026-08-24 ์ค์ธก ๊ฒฐ๊ณผ โ ์ ๋ช ๋ น์ ์ค์ ๋ก ์คํํด์ ์ค๋ฐ์ดํฐ ๋ต๋ณ๊น์ง ํ์ธํ์ต๋๋ค:
์์ธ์ญ โ ์๋ฆฌ๋ฒ ์ดํฐ ์์ (18๊ฐ) ์์ค์ปฌ๋ ์ดํฐ: 23๊ฐ ยท ์ผ๋ฐํ์ฅ์ค: ์์ ยท ์์ ์ค: ์์ ยท ์ข ํฉ์๋ด์ผํฐ: ์์ (์ถ์ฒ: ํ๊ตญ์ฒ ๋๊ณต์ฌ ๊ณต๊ณต๋ฐ์ดํฐํฌํธ ํธ์์์ค์ ๋ณด, ์ค์๊ฐ API ๊ธฐ์ค)
claude mcp list๋ก ๋ฑ๋ก ํ์ธ,claude mcp remove korail-mcp๋ก ์ ๊ฑฐํ ์ ์์ต๋๋ค. ๋ํํ์ผ๋ก ์ธ ๋๋--allowedTools์์ด ์คํํ๋ฉด ์ฒซ ๋๊ตฌ ํธ์ถ ์ ์น์ธ ์ฌ๋ถ๋ฅผ ๋ฌผ์ด๋ด ๋๋ค.
.cursor ๋๋ .gemini\antigravity ํด๋๋ ๊ทธ ์์ ์ค์ ํ์ผ์ด ์๋ค๋ฉด ์ง์ ๋ง๋ค๋ฉด ๋ฉ๋๋ค.
ํ์๊ธฐ ์ฃผ์์ฐฝ์
%USERPROFILE%์ ๋ ฅ โ Enter (๋ณธ์ธ ๊ณ์ ํด๋๋ก ์ด๋)์๋ ํด๋(
.cursor๋๋.gemini\antigravity)๋ฅผ ์๋ก ๋ง๋์ธ์๊ทธ ์์
mcp.json(Cursor) ๋๋mcp_config.json(Antigravity) ํ์ผ์ ๋ง๋ค๊ณ ์ JSON์ ๋ฃ์ผ์ธ์
Antigravity๋ ์ฑํ ์ ์ JSON์ ๋ถ์ฌ๋ฃ๊ณ "์ด MCP ์๋ฒ๋ฅผ ๋ฑ๋กํด์ค"๋ผ๊ณ ์์ฒญํ๋ ๋ฐฉ๋ฒ์ด ๋ ์ฝ์ต๋๋ค. ๋ฌด๋ฃ๋ก ์ค์น ๊ฐ๋ฅํ๋ฉฐ, KORAIL MCP ์ฐ๊ฒฐ์ ๋ณ๋ ๊ตฌ๋ ์ด ํ์ ์์ต๋๋ค.
ํฐ๋ฏธ๋์์ ์ฐ๋ ๊ณต์ GitHub Copilot CLI(@github/copilot, VS Code ์์ด๋ ๋์)๋ก ์ค์ ๊ณ์ ๋ถ์ฌ์ ๊ฒ์ฆํ์ต๋๋ค. ๋ฌด๋ฃ ํ๋์์๋ MCP ์๋ฒ ์ฐ๊ฒฐ์ด ๋ฉ๋๋ค (๋ค๋ง ์ ์ฑํ
50ํ, ๋ชจ๋ธ์ Claude Haiku 4.5 / GPT-5 mini๋ก ์ ํ).
โ ๏ธ ์ฌ์ ์ค๋น โ Node.js 22 ์ด์์ด ํ์ํฉ๋๋ค.
node --version์ผ๋ก ํ์ธํ๊ณ , ์์ผ๋ฉด nodejs.org์์ LTS ๋ฒ์ ์ ์ค์นํ์ธ์(uv์ ๋ฌ๋ฆฌ ์๋์ผ๋ก ์ค๋น๋์ง ์์ต๋๋ค).
# 1) ์ค์น (์ต์ด 1ํ)
npm install -g @github/copilot
# 2) korail-mcp๋ฅผ MCP ์๋ฒ๋ก ๋ฑ๋ก (์ต์ด 1ํ)
copilot mcp add korail-mcp -- "C:\Users\<์ฌ์ฉ์๋ช
>\.local\bin\korail-mcp.exe"
# 3) ์ค์ ์ง๋ฌธ (๋๊ตฌ ์๋ ์น์ธ)
copilot -p "์์ธ์ญ์ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์๋์ง korail-mcp ๋๊ตฌ๋ก ์กฐํํด์ค" --allow-all-toolsโ 2026-08-24 ์ค์ธก ๊ฒฐ๊ณผ โ ์ ๋ช ๋ น์ ์ค์ ๋ก ์คํํด์ GitHub Copilot์ด
get_urban_accessibility๋๊ตฌ๋ฅผ ์ค์ค๋ก ํธ์ถํ๊ณ ์ค๋ฐ์ดํฐ๋ก ๋ต๋ณํ๋ ๊ฒ๊น์ง ํ์ธํ์ต๋๋ค:โ get_urban_accessibility (MCP: korail-mcp) ยท station_name: "์์ธ์ญ", facility_type: "elevator" ๋ค, ์์ธ์ญ์๋ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์์ต๋๋ค! ์ด 17๊ฐ์ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์ค์น๋์ด ์์ต๋๋ค. - ๊ณตํญ์ฒ ๋(AR): 9๊ฐ ยท ๊ฒฝ์์ค์์ (KR): 1๊ฐ ยท 1ํธ์ (S1): 4๊ฐ ยท 4ํธ์ (S1): 3๊ฐ์ค์ ํ์ผ์
~/.copilot/mcp-config.json์mcpServers.korail-mcp๋ก ์ ์ฅ๋๋ฉฐ,copilot mcp list๋ก ๋ฑ๋ก ํ์ธ,copilot mcp remove korail-mcp๋ก ์ ๊ฑฐํ ์ ์์ต๋๋ค.
VS Code ํ์ฅ ํํ์ Copilot Chat์ ์ CLI์ ๋ณ๊ฐ ์ ํ์ด๋ผ ์ค์ ํ์ผ์ด ๋ค๋ฆ
๋๋ค. ์ต์์ ํค๊ฐ mcpServers๊ฐ ์๋๋ผ servers ๋ผ์ ์ JSON์ ๊ทธ๋๋ก ์ธ ์ ์์ต๋๋ค.
์ ์ฅ์(์์ ํด๋) ๋ฃจํธ์
.vscode\mcp.jsonํ์ผ์ ๋ง๋ค๊ณ ์๋ ๋ด์ฉ์ ๋ฃ์ต๋๋ค. (๋ชจ๋ ์์ ํด๋์์ ์ฐ๋ ค๋ฉด ๋ช ๋ น ํ๋ ํธ(Ctrl+Shift+P) โ MCP: Open User Configuration ์ผ๋ก ์ด๋ฆฌ๋%APPDATA%\Code\User\mcp.json์ ๋ฃ์ผ์ธ์.)
{
"servers": {
"korail-mcp": {
"command": "C:\\Users\\<์ฌ์ฉ์๋ช
>\\.local\\bin\\korail-mcp.exe"
}
}
}ํ์ผ์ ์ ์ฅํ๋ฉด ์๋จ์ ๋ํ๋๋ Start ๋ฒํผ์ ํด๋ฆญํฉ๋๋ค.
Copilot Chat์ ์ด๊ณ Agent ๋ชจ๋๋ฅผ ์ ํ โ ๋๊ตฌ ์์ด์ฝ์์
korail-mcp98๊ฐ ๋๊ตฌ๊ฐ ๋ณด์ด๋ฉด ์ฐ๊ฒฐ ์๋ฃ์ ๋๋ค.
โ ๏ธ ์ CLI ํ ์คํธ๋ก ์๋ฒ ์ชฝ(stdio ํ๋กํ ์ฝยท98๊ฐ ๋๊ตฌยท์ค๋ฐ์ดํฐ ์๋ต)์ ์ด๋ฏธ ๊ฒ์ฆ๋์ง๋ง, VS Code ํ๋ฉด์์ Start๋ฅผ ๋๋ฌ ์ค์ ๋ก ๋ถ๋์ง๋ GUI ์กฐ์ ๋๊ตฌ๊ฐ ์์ด ํ์ธํ์ง ๋ชปํ์ต๋๋ค. ์ ๋๋ฉด ์๋ ค์ฃผ์ธ์.
์ฐ๊ฒฐ ํ ๋ฐ๋์ โ ํด๋ผ์ด์ธํธ๋ฅผ ์์ ํ ์ข ๋ฃํ๋ค ๋ค์ ์คํ
โน๏ธ Claude CodeยทGitHub Copilot CLI๋ ์ด ๋จ๊ณ๊ฐ ํ์ ์์ต๋๋ค โ ๋ช ๋ น์ ์คํํ ๋๋ง๋ค ์ค์ ์ ์๋ก ์ฝ์ต๋๋ค. ์๋๋ Claude DesktopยทCursorยทAntigravityยทVS Code์ฒ๋ผ ์ฐฝ์ ๋์๋๋ ํด๋ผ์ด์ธํธ์๋ง ํด๋นํฉ๋๋ค.
์ฐฝ์ X๋ฅผ ๋๋ฌ ๋ซ์๋ ํธ๋ ์ด(์์
ํ์์ค ์ค๋ฅธ์ชฝ ^ ์)์ ๊ณ์ ์คํ ์ค์ด๋ผ ์ค์ ์ด ์ ์ฉ๋์ง ์์ต๋๋ค.
โ ํธ๋ ์ด ์์ด์ฝ ์ฐํด๋ฆญ โ Quit / ์ข
๋ฃ ํ ๋ค์ ์คํํ์ธ์.
์ ์ ์ฐ๊ฒฐ๋๋ฉด ์ค์ ์ MCP ์๋ฒ ๋ชฉ๋ก์ korail-mcp๊ฐ running ์ผ๋ก ํ์๋๊ณ , 98๊ฐ ๋๊ตฌ๋ฅผ ์ธ ์ ์์ต๋๋ค.
๐ฌ ์ค์น ํ์ธ โ ์ด๋ ๊ฒ ๋ฌผ์ด๋ณด์ธ์
์์ธ์ญ์ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์๋์?
2024๋
๊ฐ์ ์ฒ ๋ ์์ก์ค์ ์ ์๋ ค์ฃผ์ธ์.
KTX 101 ์ด์ฐจ์ ์ดํ ๊ณํ์ ์๋ ค์ฃผ์ธ์.์ ์ ์๋ต์ด ์ค๋ฉด ์ค์น ์๋ฃ์ ๋๋ค. ๋ ๋ง์ ์ฌ์ฉ ์์๋ ๋ฌธ์ ํ๋จ์ "์ฌ์ฉ ์์" ์น์ ์ ์ฐธ๊ณ ํ์ธ์.
๐ฆ ์ ๊ณต ์๋ฒ (์ด 11๊ฐ ยท 98๊ฐ ๋๊ตฌ)
์๋ฒ | ๋๊ตฌ ์ | ์ ๊ณต ๋ฐ์ดํฐ |
m-convenience | 6 | ์ญ์ฌ ํธ์์์คยท์ ๊ทผ์ฑยท์๋ฆฌ๋ฒ ์ดํฐยท์์น ์ ๋ณด |
m-stats | 15 | ์์ก์ค์ ยท๋ฐ๊ถ ํต๊ณยท์ด์ฉ์ ํยทKTX ์ฅ๊ธฐ ํต๊ณ |
m-train-ops | 4 | ์ด์ฐจ ์ดํ๊ณํยท์ดํ์ด๋ ฅ |
m-codebook | 4 | ์ญ์ฝ๋ยท๋ ธ์ ์ฝ๋ ์กฐํ |
m-freight | 11 | ํ๋ฌผยท์ปจํ ์ด๋ยท๋ฌผ๋ฅ์์คยทํ๋ชฉยท์ํ๋ฌผ |
m-network | 8 | ๋ ธ์ ยท์ญ๊ฐ๊ฑฐ๋ฆฌยท์ด์ยท์ญ ์ ๋ก์ ์ |
m-rolling-stock | 6 | ์ฐจ๋ ๋ณด์ ํํฉยทํ๋ณ์ ์ยท์ฐจ์ข ๋ณ ์ดํ์ค์ |
m-voc-cs | 10 | ๊ณ ๊ฐ์๋น์คยท์ ๋ณด๊ณต๊ฐ |
m-internal-svc | 14 | ์๋๋งค์ฅยท์ฌํ๊ณตํยท์ธ์ฌ ์ ๋ณด |
m-procurement | 4 | ์์ฌ๊ทธ๋ฃนยทG2B ํ๋ช ยท์์ฌ์์ฑยท๋์์ฅ๋น |
m-urban-rail | 16 | ์ ๊ตญ ๋์์ฒ ๋ ์ญ์ฌยท๋ ธ์ ยท์ฐจ๋ ์์คยท์ ๊ทผ์ฑยท์์ ยทํ๊ฒฝยท์๊ฐํ |
์๋ฒ๋ณ ๋๊ตฌ ์์ธ (ํด๋ฆญํ์ฌ ํผ์น๊ธฐ)
๋๊ตฌ | ์ค๋ช |
get_station_facilities | ์ญ ์ด๋ฆ์ผ๋ก ํธ์์์ค ์ ๋ณด ์กฐํ |
get_accessible_facilities | ์ญ ์ด๋ฆ์ผ๋ก ๊ตํต์ฝ์ ํธ์์์ค ์กฐํ |
list_stations_with_elevator | ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์ค์น๋ ์ญ ๋ชฉ๋ก ์กฐํ |
get_station_facilities_detail | ์ญ์ฌ ๋ด์ธ๋ถ ์์คํํฉ ์กฐํ |
get_station_transfer_info | ์ญ๋ณ ํ ๊ตํต์๋จ ํ์นํํฉ ์กฐํ |
get_station_location | ์ญ ์์น(์ขํ) ์ ๋ณด ์กฐํ |
๋๊ตฌ | ์ค๋ช |
get_mainline_station_per | ๊ฐ์ ์ด์ฐจ ์ญ๋ณ ์นํ์ฐจ ํต๊ณ |
get_mainline_route_per | ๊ฐ์ ์ด์ฐจ ๋ ธ์ ๋ณ ์ด์ฉ์ธ์ ํต๊ณ |
get_wide_rail_station_per | ๊ด์ญ์ฒ ๋ ์ญ๋ณ ์นํ์ฐจ ํต๊ณ |
get_wide_rail_route_per | ๊ด์ญ์ฒ ๋ ๋ ธ์ ๋ณ ์ด์ฉ์ธ์ ํต๊ณ |
get_mainline_distance_per | ๊ฐ์ ์ด์ฐจ ๊ฑฐ๋ฆฌ๋ณ ์ด์ฉ์ธ์ ํต๊ณ |
get_mainline_model_per | ๊ฐ์ ์ด์ฐจ ์ฐจ๋๋ณ ์ด์ฉ์ธ์ ํต๊ณ |
get_mainline_day_of_week_per | ๊ฐ์ ์ด์ฐจ ์์ผ๋ณ ์ด์ฉ์ธ์ ํต๊ณ |
get_mainline_grade_per | ๊ฐ์ ์ด์ฐจ ๊ฐ์ค๋ณ ์ด์ฉ์ธ์ ํต๊ณ |
get_mainline_ticketing_stat | ๊ฐ์ ์ด์ฐจ ๋ฐ๊ถ์ ํ ํต๊ณ |
get_mainline_person_distance | ๊ฐ์ ์ด์ฐจ ๋ ธ์ ๋ณ ์ธ๊ฑฐ๋ฆฌ ํต๊ณ |
get_ktx_long_term_stats | KTX ์ฅ๊ธฐ ํต๊ณ |
get_mainline_carriage | ๊ฐ์ ์ฌ๊ฐ์ด์ฐจ ์์ก์ค์ ์กฐํ |
get_wide_area_carriage | ๊ด์ญ ์ฌ๊ฐ์ด์ฐจ ์์ก์ค์ ์กฐํ |
get_freight_carriage | ํ๋ฌผ์ด์ฐจ ์์ก์ค์ ์กฐํ |
get_transport_stat_codes | ์์ก์ค์ ํต๊ณ ์ฝ๋์ ๋ณด ์กฐํ |
๋๊ตฌ | ์ค๋ช |
get_train_codes | ์ด์ฐจ์ดํ ์ฝ๋์ ๋ณด ์กฐํ |
get_train_run_plan | ์ฌ๊ฐ์ด์ฐจ ์ดํ๊ณํ ์กฐํ |
get_train_run_info | ์ฌ๊ฐ์ด์ฐจ ์ค์ ์ดํ์ ๋ณด ์กฐํ |
get_train_run_history | ์ฐจ์ธ๋์์ฝ๋ฐ๋งค ์ด์ฐจ ์ดํ๋ด์ญ ์กฐํ |
๋๊ตฌ | ์ค๋ช |
search_station | ์ญ๋ช ์ผ๋ก ์ญ์ฝ๋ยท์๋ฌธ๋ช ยท์ง์ญ๋ณธ๋ถ ํตํฉ ์กฐํ |
decode_station_code | ์ญ์ฝ๋๋ก ์ญ๋ช ์กฐํ |
search_route | ๋ ธ์ ๋ช ์ผ๋ก ๋ ธ์ ์ฝ๋ ์กฐํ |
list_stations_by_region | ์ง์ญ๋ณธ๋ถ๋ช ์ผ๋ก ๊ดํ ์ญ ๋ชฉ๋ก ์กฐํ |
๋๊ตฌ | ์ค๋ช |
search_freight_code | ๋ด์ ํ๋ฌผ์ฝ๋ ๊ฒ์ |
decode_freight_code | ๋ด์ ํ๋ฌผ๋ถ๋ฅ์ฝ๋ ๋จ๊ฑด ๋์ฝ๋ฉ |
search_container_record | ์ปจํ ์ด๋ ์ ์ฌ ์ด๋ ฅ ์กฐํ |
list_freight_work_lines | ํ๋ฌผ์ ํ์์ ์ ์ฉ ์์ ์ ์ ๋ณด |
list_standard_loading_time | ํ์ค ์ ํ์๊ฐ ๋ง์คํฐ ์กฐํ |
search_loading_time_adjustment | ์ ํ์๊ฐ ์กฐ์ ์ด๋ ฅ ์กฐํ |
search_consignment_change | ์ํ๋ณ๊ฒฝ์๊ธ ๊ฒ์ |
search_consignment_change_per_wagon | ์ํ๋ณ๊ฒฝ์๊ธ ํ์ฐจ๋ณ ์กฐํ |
get_logistics_facility | ๋ฌผ๋ฅ์์ค ์ ๋ณด ํตํฉ ์กฐํ |
get_freight_items | ํ๋ฌผ ํ๋ชฉ์ ๋ณด ์กฐํ |
get_hazardous_cargo | ์ํ๋ฌผ ์ ๋ณด ์กฐํ |
๋๊ตฌ | ์ค๋ช |
search_operation_patterns | ์ ๊ตญ ์ฒ ๋ ์ดํ๊ณํต ๊ฒ์ |
get_station_distance | ๋ ์ญ ๊ฐ ์ต๋จ ์ดํ๊ฑฐ๋ฆฌ ์กฐํ |
get_freight_minimum_fare | ํ๋ฌผ ์ด์ก ์ต์ ์ด์ ๊ธฐ์ค ์กฐํ |
get_freight_rate | ์ฒ ๋ ํ๋ฌผ ์์จ ์ ๋ณด ์กฐํ |
get_segment_info | ์ฒ ๋ ์ ๋์ฐจ ์ธ๊ทธ๋จผํธ ์ ๋ณด ์กฐํ |
get_operation_distance | ๋ ธ์ ๋ณ ์ญ๊ฐ ์ดํ๊ฑฐ๋ฆฌ ์กฐํ |
get_ktx_stations | KTX ๋ ธ์ ๋ณ ์ญ ์ ๋ณด ์กฐํ |
get_station_track_info | ์ญ๋ณ ์ ๋กยท์์ค ์์ธ ์ ๋ณด ์กฐํ |
๋๊ตฌ | ์ค๋ช |
get_train_type_specs | ๋๋ ฅ์ฐจ ํ๋ณ์ ์ ์กฐํ |
get_rolling_stock_by_year | ์ฐ๋๋ณ ์ฐจ๋๋ณด์ ํํฉ ์กฐํ |
get_wagon_by_weight_class | ํ์ฐจ ์์ค๋ณ ๋ณด์ ํํฉ ์กฐํ |
get_wagon_by_load_capacity | ํ์ฐจ ์ ์ฌํ์ค๋ณ ๋ณด์ ํํฉ ์กฐํ |
get_maintenance_equipment | ์ฒ ๋์ฐจ๋ ๊ฒ์์ฉ ๊ธฐ๊ณ ๋ณด์ ํํฉ ์กฐํ |
get_train_operation_by_type | ์ฐจ์ข ๋ณ ์ฐ๊ฐ ์ดํ์ค์ ์กฐํ |
๋๊ตฌ | ์ค๋ช |
get_customer_satisfaction_stats | ๊ณ ๊ฐ์์๋ฆฌ ๋ง์กฑ๋ ์ผ๋ณ ํต๊ณ |
get_consultation_types | ์ฒ ๋ ๊ณ ๊ฐ์ผํฐ ์๋ด์ ํ ์ฝ๋ ์กฐํ |
get_consultation_departments | ์ฒ ๋ ๊ณ ๊ฐ์ผํฐ ๋ด๋น ๋ถ์ ๋ชฉ๋ก ์กฐํ |
get_advance_disclosure | ํํ์ด์ง ์ฌ์ ์ ๋ณด๊ณตํ ๋ชฉ๋ก ์กฐํ |
get_advance_disclosure_detail | ์ฌ์ ์ ๋ณด๊ณตํ ์ธ๋ถ ๋ด์ญ ์กฐํ |
get_advance_disclosure_files | ์ฌ์ ์ ๋ณด๊ณตํ ์ฒจ๋ถํ์ผ ๋ชฉ๋ก ์กฐํ |
get_info_disclosure_dept | ์ ๋ณด๊ณต๊ฐ ๋ด๋น ๋ถ์ ๋ชฉ๋ก ์กฐํ |
get_info_disclosure_codes | ์ ๋ณด๊ณต๊ฐ ์์คํ ๊ณตํต์ฝ๋ ์กฐํ |
get_homepage_dept | KORAIL ํํ์ด์ง ๋ถ์ ์ ๋ณด ์กฐํ |
get_homepage_position | KORAIL ํํ์ด์ง ์ง์ฑ ์ฝ๋ ์กฐํ |
๋๊ตฌ | ์ค๋ช |
get_lease_stores | ์ญ์ฌ ๋ด ์๋๋งค์ฅ ์ด์์ ๋ณด ์กฐํ |
get_lease_codes | ์๋ ์์คํ ์ฝ๋ ์กฐํ |
get_leased_assets | ์๋์์ฐ ํํฉ ์กฐํ |
get_dormitory_longterm_codes | ์ง์์์ฌ ์ฅ๊ธฐ์์ฝ ์ฌ์ ์ฝ๋ ์กฐํ |
get_social_funds | ์ฌํ๊ณตํ ํ๋ ์ข ๋ฅ ์กฐํ |
get_social_volunteer_fields | ์ฌํ๊ณตํ ๋ด์ฌ ๋ถ์ผ ์ฝ๋ ์กฐํ |
get_social_donations | ์ฌ๋์ ์ฑ๊ธ ์ฌ์ฉ ๋ด์ญ ์กฐํ |
get_social_volunteer_matching | ๋ด์ฌํ๋ ๋งค์นญ ์ง์ถ ๋ด์ญ ์กฐํ |
get_social_org | ์ฌํ๊ณตํ ํฌํธ ์กฐ์ง์ ๋ณด ์กฐํ |
get_support_facilities | ์ฌ์ฅ ๋ด ๋ถ๋์์ค ๋ชฉ๋ก ์กฐํ |
get_support_departments | ์ ๋ฌด์ง์ ๋ถ์๋ณ ์ธ์ ํํฉ ์กฐํ |
get_office_meeting_rooms | ๋ณธ์ฌ ์ฌ์ฅ ํ์์ค ๋ชฉ๋ก ์กฐํ |
get_job_grades | ์ง๊ธ ์ฝ๋ ์ ๋ณด ์กฐํ |
get_cafeteria_menu_stats | ๊ตฌ๋ด์๋น ๋ฉ๋ด ๊ฑด์ ํํฉ ์กฐํ |
๋๊ตฌ | ์ค๋ช |
search_material_group | ์์ฌ๊ทธ๋ฃน์ฝ๋ ๊ฒ์ |
search_g2b_item | G2B ๋ถ๋ฅ๋ฒํธยทํ๋ช ๊ฒ์ |
search_material_attr | ์์ฌ์์ฑ์ ๋ณด ์กฐํ |
search_material_equipment | ์์ฌ๋์์ฅ๋น ์กฐํ |
์๋๊ถ 1~9ํธ์ ยท์ ๋ถ๋นยท๊ณตํญ์ฒ ๋, ๋ถ์ฐยท๋๊ตฌยท๋์ ยท๊ด์ฃผยท์ธ์ฒ, ๊ฒฝ์ ์ฒ ยทGTX ๋ฑ ์ ๊ตญ 22๊ฐ ์ด์๊ธฐ๊ด 1,108๊ฐ ์ญ. ์ด์๊ธฐ๊ดยท์ ยท์ญ์ฝ๋๊ฐ ํ์ํ๋ฏ๋ก ๋จผ์
search_urban_station์ผ๋ก ์ญ์ ํน์ ํ์ธ์. ํ์น์ญ ๋ฑ ๋์ผ ์ญ๋ช ์operator(์ด์๊ธฐ๊ด)๋ก ๊ตฌ๋ถํฉ๋๋ค.
๋๊ตฌ | ์ค๋ช |
search_urban_station | ์ญ๋ช ์ผ๋ก ์ด์๊ธฐ๊ดยท์ ยท์ญ์ฝ๋ ๊ฒ์ (๋ค๋ฅธ ์กฐํ์ ์ ํ ๋จ๊ณ) |
get_urban_station_info | ์ญ์ฌ ๊ธฐ๋ณธ์ ๋ณด ์กฐํ (์ฃผ์ยท์ขํยท๋ค๊ตญ์ด ์ญ๋ช ) |
get_urban_accessibility | ์ญ์ฌ ์ ๊ทผ์ฑ ์์ค ์กฐํ (์๋ฆฌ๋ฒ ์ดํฐยท์์ค์ปฌ๋ ์ดํฐยทํ ์ฒด์ด๋ฆฌํํธ ํํฉ/์์นยท์ด๋๋์ ยท์์ ๋ฐํยท์ด๊ฒฉ๊ฑฐ๋ฆฌยท์ ์ยท์ฅ์ ์ธํ์ฅ์คยท์ธ์ ๊ณ๋จ ์ฐจ๋๋ฒํธ ๋ฑ) |
get_urban_amenity | ์ญ์ฌ ํธ์์์ค ์กฐํ (ํ์ฅ์คยท์์ ์คยท๋ฌผํ๋ณด๊ดํจยทATMยท์ ์ค๋ฌผ์ผํฐยท๋ฌด์ ์ธํฐ๋ท) |
get_urban_safety | ์ญ์ฌ ์์ ์์ค ์กฐํ (์ ์ธ๋๊ธฐยท์ํ์ค๋นยท๋น์์ฝํฐยท๊ณต๊ธฐํธํก๊ธฐยท์คํฌ๋ฆฐ๋์ดยท์น๊ฐ์ฅ ์์ ํ์ค) |
get_urban_surroundings | ์ญ ์ฃผ๋ณ ์์ค ์กฐํ (๋์ค๊ตํตยท์ฃผ์ฐจ์ฅยท์์ ๊ฑฐ ์ฃผ์ฐจ/๋์ฌ) |
get_urban_exit_info | ์ญ์ฌ ์ถ๊ตฌ์ ๋ณด ์กฐํ (์ถ๊ตฌ๋ฒํธยท์ฃผ๋ณ์์คยท๊ฑฐ๋ฆฌ) |
get_urban_transfer_info | ์ญ์ฌ ํ์น์ ๋ณด ์กฐํ (ํ์น๋ ธ์ ยทํ์น๊ฑฐ๋ฆฌยท๋์ ) |
get_urban_movement | ๊ตํต์ฝ์ ์ถ์ ๊ตฌโ์น๊ฐ์ฅ ์ด๋๊ฒฝ๋ก(๋ฌด์ฅ์ ๋์ ) ์กฐํ |
get_urban_platform | ์ญ์ฌ ์น๊ฐ์ฅ ์ ๋ณด ์กฐํ (์น๊ฐ์ฅ ์ ํยท๋ณตํฉ์ฌ๋ถ ๋ฑ) |
get_urban_environment | ์ญ์ฌ ํ๊ฒฝ์ธก์ ์กฐํ (๊ณต๊ธฐ์งยท์จ๋ยท์ต๋ยท์์) |
get_urban_timetable | ์ญ์ฌ๋ณ ์ดํ์๊ฐํ ์กฐํ (ํ์ผ/ํด์ผยท๊ธํ ์ ํ) |
get_urban_route | ๋ ธ์ ์ ์ฒด ์ญ ๊ตฌ์ฑ(์ํ~ํํ ์์) ์กฐํ โ ์ญ ๋ฌด๊ด |
get_urban_train_composition | ์ด์๊ธฐ๊ด๋ณ ์ด์ฐจ ํธ์ฑ์ข ๋ฅ(ํธ์ฑ์ฝ๋ยทํธ์ฐจ) ์กฐํ โ ์ฐจ๋๋ณ ์กฐํ ์ ํ |
get_urban_train_facility | ์ฐจ๋(ํธ์ฐจ)๋ณ ์์ค ์กฐํ (์ํ๊ธฐยท๋น์์ฝํฐยท์ ์ธ๋๊ธฐยท์์ฐ๋ถ์ยท๋ ธ์ฝ์์ยทํ ์ฒด์ด ๋ฑ) |
get_urban_train_environment | ์ด์ฐจ๋ณ ์ฐจ๋ด ํ๊ฒฝ์ ๋ณด ์กฐํ (์จ๋ยท์ต๋ยท๋ฏธ์ธ๋จผ์ง ๋ฑ) |
๐งฉ ๊ทธ ๋ฐ์ ๋ฐฉ์
ChatGPT์ Grok์ ๋ก์ปฌ MCP ์๋ฒ๋ฅผ ์ง์ํ์ง ์์ต๋๋ค. ๊ณต๊ฐ HTTPS ์๋ํฌ์ธํธ๋ง ์ปค๋ฅํฐ๋ก ์ถ๊ฐํ ์ ์์ด, ์ ๋ฐฉ๋ฒ์ผ๋ก๋ ์ฐ๊ฒฐ๋์ง ์์ต๋๋ค.
๊ฒ์ดํธ์จ์ด์ ์๊ฒฉ(Streamable HTTP) ๋ชจ๋๊ฐ ๋ด์ฅ๋์ด ์์ด ๊ณต๊ฐ ์ฃผ์๋ก ๋ ธ์ถํ๋ฉด ์ฐ๊ฒฐ์ด ๊ฐ๋ฅํฉ๋๋ค. ๋ค๋ง ์๋ฒ ์ด์๊ณผ ๊ณต๊ฐ ๋ฒ์ ๋ฌธ์ ๊ฐ ๋ฐ๋ฅด๋ฏ๋ก ์์ธ๋ gateway/README.md๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์ค์น ๊ณผ์ ์์ด uvx ๋ก ๋ฐ๋ก ์คํํ ์๋ ์์ต๋๋ค.
{
"mcpServers": {
"korail-mcp": {
"command": "uvx",
"args": ["--from", "git+https://github.com/lovelyquality/korail-mcp.git", "korail-mcp"]
}
}
}๊ณ์ ๋ช ์ ๋ฃ์ง ์์๋ ๋๋ ์ฅ์ ์ด ์์ผ๋, ์คํํ ๋๋ง๋ค GitHub์ ์ต์ ์ปค๋ฐ์ด ์๋์ง ํ์ธํ๊ธฐ ๋๋ฌธ์ ํด๋ผ์ด์ธํธ๋ฅผ ์ผค ๋๋ง๋ค ๊ธฐ๋์ด ๋๋ฆฝ๋๋ค.
๋ฐฉ์ | ๊ธฐ๋ ์๊ฐ(์ค์ธก) |
| ์ฝ 5์ด |
| ์ฝ 40์ด |
๊ธฐ๋์ด ๋๋ฆฌ๋ฉด ํด๋ผ์ด์ธํธ๊ฐ ์๋ฒ๋ฅผ ๊ธฐ๋ค๋ฆฌ๋ค ๋์ณ ๋๊ตฌ๊ฐ ๋ํ๋์ง ์์ ์ ์์ต๋๋ค.
์๋ฒ ์ฝ๋๋ฅผ ์์ ํ๋ ค๋ฉด ์ ์ฅ์๋ฅผ clone ํด์ ์คํํฉ๋๋ค.
git clone https://github.com/lovelyquality/korail-mcp.git
cd korail-mcp
uv run gateway/server.py์์กด์ฑ์ gateway/server.py ์๋จ์ ์ ์ธ๋์ด ์์ด uv๊ฐ ์๋์ผ๋ก ์ค๋นํฉ๋๋ค. ๋ณ๊ฒฝ ํ์๋
python docker-test/smoke_test.py ๋ก 11๊ฐ ์๋ฒยท98๊ฐ ๋๊ตฌยท๋ฐํ ํ์
์ ์ธ์ ํ ๋ฒ์ ๊ฒ์ฆํ์ธ์.
์์ธ๋ gateway/README.md ์ฐธ๊ณ .
๐ฌ ์ฌ์ฉ ์์
์์ธ์ญ์ ์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์๋์? (convenience)
2026๋
4์ KTX ๋ฐ๊ถ์ ํ ๋น์จ์ ์๋ ค์ฃผ์ธ์. (stats)
KTX 101 ์ด์ฐจ์ ์ดํ ๊ณํ์ ์๋ ค์ฃผ์ธ์. (train-ops)
์์ธ์ญ ์ฝ๋๊ฐ ๋ญ๊ฐ์? (codebook)
2024๋
๊ฐ์ ์ฒ ๋ ์์ก์ค์ ์ ์๋ ค์ฃผ์ธ์. (stats)
์ปจํ
์ด๋ ํ๋ฌผ ์ด์ก ์ด๋ ฅ์ ์กฐํํด์ฃผ์ธ์. (freight)
๊ฒฝ๋ถ์ KTX ์ ์ฐจ์ญ๊ณผ ์ญ๊ฐ ๊ฑฐ๋ฆฌ๋ฅผ ์๋ ค์ฃผ์ธ์. (network)
KTX ์ฐจ๋ ํ๋ณ ์ ์์ ๋ณด์ฌ์ฃผ์ธ์. (rolling-stock)
์ฒ ๋ ๊ณ ๊ฐ์ผํฐ ์๋ด์ ํ ์ฝ๋๋ฅผ ์๋ ค์ฃผ์ธ์. (voc-cs)
์ญ์ฌ ์๋๋งค์ฅ ํํฉ์ ์๋ ค์ฃผ์ธ์. (internal-svc)
'EMU์ฉํ' ์์ฌ๊ทธ๋ฃน์ฝ๋๋ฅผ ๊ฒ์ํด์ฃผ์ธ์. (procurement)
๊ฐ๋จ์ญ(์์ธ๊ตํต๊ณต์ฌ) ์๋ฆฌ๋ฒ ์ดํฐ ์์น๋ฅผ ์๋ ค์ฃผ์ธ์. (urban-rail)
์์ธ์ญ ๋์์ฒ ๋ ์ญ์ฌ๋ค์ ์ด์๊ธฐ๊ด์ ์ฐพ์์ฃผ์ธ์. (urban-rail)๐ ๋ฐ์ดํฐ ์ถ์ฒ
ํ๊ตญ์ฒ ๋๊ณต์ฌ ๊ณต๊ณต๋ฐ์ดํฐํฌํธ (data.go.kr)
๊ตญ๊ฐ์ฒ ๋๊ณต๋จ(KRIC) ์ฒ ๋์ฐ์ ์ ๋ณด์ผํฐ ์คํAPI (openapi.kric.go.kr) โ ๋์์ฒ ๋ ์ญ์ฌ์ ๋ณด
REST API(B551457) ยท odcloud ํ์ผ๋ณํ API ยท ๋ก์ปฌ CSV
โ ๏ธ ์ฃผ์์ฌํญ
๋ฐ์ดํฐ ํธ์ถ์ ์ ์ฉ Cloudflare Workers ํ๋ก์๋ฅผ ๊ฒฝ์ ํ๋ฏ๋ก ์ง์ ๊ฐ์ธ API ํค๊ฐ ํ์ ์์ต๋๋ค.
๊ฐ ๋ฐ์ดํฐ์ ์ ๊ธฐ์ค์ผยท๊ฐฑ์ ์ฃผ๊ธฐ๋ ๋๊ตฌ ์๋ต์
_metaํญ๋ชฉ์ ํ์๋ฉ๋๋ค.
๊ฐ ์๋ฒ์ ์์ธ ๋์์ ํด๋น ํด๋์ server.py docstring์ ์ฐธ์กฐํ์ธ์.
Available Tools
98 toolsdecode_freight_codeB
๋ด์ ํ๋ฌผ๋ถ๋ฅ์ฝ๋ โ ํ๊ธ๋ช /์๋ฌธ๋ช ๋จ๊ฑด ๋์ฝ๋ฉ.
Inputs: code (required).
decode_station_codeA
์ญ์ฝ๋(์ซ์)๋ก ์ญ๋ช ์ ์กฐํ. ๋ค๋ฅธ MCP ์๋ต์์ ์ฝ๋๊ฐ ๋์์ ๋ ์ฌ์ฉ. ์ฐจ์ธ๋์์ฝ๋ฐ๋งค(75์ญ)์ ์ฒ ๋์ด์์ ๋ณด(1255์ญ) ๋ ์์คํ ๋์ ๊ฒ์. ์: code='3900023'(์์ธ), code='390'(๋ถ๋ถ๋งค์นญ ๊ฐ๋ฅ)
Inputs: code (required). Returns: result
get_accessible_facilitiesB
์ญ ์ด๋ฆ์ผ๋ก ๊ตํต์ฝ์(์ฅ์ ์ธ) ํธ์์์ค ์กฐํ (B551457 ์ค์๊ฐ API). ํ ์ฒด์ด๋ฆฌํํธยท์ฅ์ ์ธ๊ฒฝ์ฌ๋กยท์ฅ์ ์ธํ์ฅ์ค ์ ๋ฌด. station_name: ์ญ ์ด๋ฆ ๋ถ๋ถ์ผ์น (์: '์์ธ', '๋ถ์ฐ') (EN: accessible/accessibility facilities for disabled and mobility-impaired passengers - wheelchair lift, accessible ramp, accessible restroom. JA: ไบค้ๅผฑ่ ใป้ๅฎณ่ ๅใไพฟๅฎๆฝ่จญ - ่ปๆค ๅญใชใใใในใญใผใใ้ๅฎณ่ ใใคใฌ) โป ๋ฐ์ดํฐ๊ธฐ์ค์ผ: ์ค์๊ฐ API. ํ์ฅ ๋ณ๊ฒฝ์ด ์ฆ์ ๋ฐ์๋์ง ์์ ์ ์์.
Inputs: station_name (required). Returns: result
get_advance_disclosureA
ํํ์ด์ง ์ฌ์ ์ ๋ณด๊ณตํ ๋ชฉ๋ก ์กฐํ.
๊ณตํ๋์, ๊ณตํ์๊ธฐ, ๋ด๋น๋ถ์ ์ฝ๋๋ฅผ ์ ๊ณตํ๋ค. ๊ฒฝ์ ํฌ๋ช ์ฑ ํ์ธ ๋๋ ํน์ ๊ณตํ ํญ๋ชฉ ํ์์ ํ์ฉ.
keyword: ๊ณตํ๋์ ๋ถ๋ถ์ผ์น ํํฐ
Inputs: keyword. Returns: result
get_advance_disclosure_detailA
ํํ์ด์ง ์ฌ์ ์ ๋ณด๊ณตํ ์ธ๋ถ ๋ด์ญ ์กฐํ.
๊ณตํ๋์ ์ ๋ชฉ, ๋ด๋น๋ถ์์ฝ๋, ์กฐํ์๋ฅผ ์ ๊ณตํ๋ค.
keyword: ์ ๋ชฉ ๋ถ๋ถ์ผ์น ํํฐ dept_code: ๋ด๋น๋ถ์ ์ฝ๋ ์ผ์น ํํฐ
Inputs: keyword, dept_code. Returns: result
get_advance_disclosure_filesC
ํํ์ด์ง ์ฌ์ ์ ๋ณด๊ณตํ ์ฒจ๋ถํ์ผ ๋ชฉ๋ก ์กฐํ.
์ฒจ๋ถํ์ผ๋ช , ํ์ผ ํ์ฅ์, ์ฐ๊ฒฐ๋ ๊ณตํ๋์ ๋ฒํธ๋ฅผ ์ ๊ณตํ๋ค.
keyword: ํ์ผ๋ช ๋ถ๋ถ์ผ์น ํํฐ
Inputs: keyword. Returns: result
get_consultation_departmentsA
์ฒ ๋ ๊ณ ๊ฐ์ผํฐ ๋ด๋น ๋ถ์(์ญ) ๋ชฉ๋ก ์กฐํ.
๋ณธ๋ถ๋ช , ๋ด๋น์ผํฐ๋ช (์ญ๋ช ), ํ๊ธฐ๋ช ์ ์ ๊ณตํ๋ค.
headquarter: ๋ณธ๋ถ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "๊ฐ์", "๋๊ตฌ", "์์ธ")
Inputs: headquarter. Returns: result
get_consultation_typesA
์ฒ ๋ ๊ณ ๊ฐ์ผํฐ ์๋ด์ ํ ์ฝ๋ ์กฐํ.
์๋ด ๋๋ถ๋ฅ(MAJOR_COUNSEL), ์ค๋ถ๋ฅ(MINOR_COUNSEL), ๊ทธ๋ฃน๋ช , ์๋ด์ฝ๋(COUNSEL_CODE), ์ ํ๋ช ์ ์ ๊ณตํ๋ค.
keyword: ๊ทธ๋ฃน๋ช ๋๋ ์ ํ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "์ด์", "์๋งค", "๋ถ์ค")
Inputs: keyword. Returns: result
get_customer_satisfaction_statsA
๊ณ ๊ฐ์์๋ฆฌ ๋ง์กฑ๋ ์ผ๋ณ ํต๊ณ ์กฐํ.
์ฒ ๋ ๊ณ ๊ฐ์ผํฐ ๋ง์กฑ๋ ์กฐ์ฌ ๊ฒฐ๊ณผ๋ฅผ ์ผ๋ณ๋ก ์ ๊ณตํ๋ค. ์ฐธ์ฌ์์ ํ๊ท ์ ์(100์ ๋ง์ )๋ฅผ ํ์ธํ ์ ์๋ค.
date_from / date_to: ์กฐ์ฌ์ผ์ ๋ฒ์ (์: "2025-01-01", "2025-03-31") day_of_week: ์์ผ ํํฐ (์: "์์์ผ", "ํ ์์ผ")
Inputs: date_to, date_from, day_of_week. Returns: result
get_dormitory_longterm_codesA
์ง์์์ฌ ์ฅ๊ธฐ์์ฝ ์ฌ์ ์ฝ๋ ์กฐํ (15๊ฑด).
์ฅ๊ธฐ์๋ฐ ์์ฝ ์ ์ฌ์ฉ๋๋ ์ฌ์ ์ฝ๋(๊ทธ๋ฃนยท๊ฐยท๋ช ์นญ)๋ฅผ ์ ๊ณตํ๋ค. '์ฅ๊ธฐ'(๊ต์ก์ยท์ถ์ฅ์ยท๋น์ฐ๊ณ ์ง ๋ฐ๋ น ๋ฑ)์ '๊ธฐํ'(2๊ธ์ด์ยท์ผ๊ฐ๊ทผ๋ฌด ๋ฑ) ๊ตฌ๋ถ.
group: ์ฝ๋๊ทธ๋ฃน ํํฐ (์: "์ฅ๊ธฐ", "๊ธฐํ")
Inputs: group. Returns: result
get_freight_carriageA
ํ๋ฌผ์ด์ฐจ ์์ก์ค์ ์กฐํ. ๋ฐ์ก์ญ~๋์ฐฉ์ญ ๊ตฌ๊ฐ๋ณ ํ๋ฌผ ๋ฐ์กํคยท์ด์ก์ฐํคํค๋ก๋ฅผ ์ ๊ณตํฉ๋๋ค. ํ๋ฌผ๊ตฌ๋ถยทํ๋ชฉ(๋/์ค/์๋ถ๋ฅ)๋ณ ํํฐ๋ง ๊ฐ๋ฅ.
Args: crtr_ymd: ํน์ ๊ธฐ์ค์ผ์ (YYYYMMDD). ์ ๋ ฅ ์ ํด๋น ๋ ์ง๋ง ์กฐํ. crtr_ymd_gte: ๊ธฐ์ค์ผ์ ์์ (YYYYMMDD, ์ดํ) crtr_ymd_lte: ๊ธฐ์ค์ผ์ ์ข ๋ฃ (YYYYMMDD, ์ด์ ) sndng_stn_cd: ๋ฐ์ก์ญ์ฝ๋ (์: "3900090"=์ฝ๋ชฉ) sndng_stn_nm: ๋ฐ์ก์ญ๋ช (์: "์ฝ๋ชฉ") arvl_stn_cd: ๋์ฐฉ์ญ์ฝ๋ (์: "3900113"=๋ถ์ฐ์ง) arvl_stn_nm: ๋์ฐฉ์ญ๋ช (์: "๋ถ์ฐ์ง") item_lclsf_cd: ํ๋ชฉ๋๋ถ๋ฅ์ฝ๋ (์: "110") item_mclsf_cd: ํ๋ชฉ์ค๋ถ๋ฅ์ฝ๋ (์: "111") item_sclsf_cd: ํ๋ชฉ์๋ถ๋ฅ์ฝ๋ (์: "1111")
Inputs: crtr_ymd, arvl_stn_cd, arvl_stn_nm, crtr_ymd_gte, +6 more. Returns: result
get_freight_itemsA
ํ๋ฌผ ํ๋ชฉ์ ๋ณด ์กฐํ (์ด 861๊ฑด, ๋ก์ปฌ CSV).
ํ๋ชฉ์ฝ๋ยทํ๋ชฉ๋ช ยทํ๋ชฉ์ฝ์ด๋ช ยท์ต์ ํค์์จ ์ ๋ณด. ๊ณ์ธตํ ์ฝ๋ ๊ตฌ์กฐ (์์ 0000, ์ค์ 00, ํ์ 01~99). ๋น query์ ์์ ํญ๋ชฉ๋ถํฐ limit ๋ฐํ.
Inputs: limit, query.
get_freight_minimum_fareA
ํ๋ฌผ ์ด์ก ์ต์ ์ด์ ๊ธฐ์ค ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค. (์ด 7๊ฑด โ ์ญ์ฌ์ ์ด๋ ฅ ํฌํจ)
Args: fare_type: ์ด์์๊ธ์ ํ (์: "์ต์ ์ด์"). ์์ผ๋ฉด ์ ์ฒด. classification_no: ๋ถ๋ฅ๋ฒํธ (์: "10", "20", "30"). ์์ผ๋ฉด ์ ์ฒด. current_only: True๋ฉด ์ ์ฉ์ข ๋ฃ์ผ์๊ฐ 2100๋ ์ดํ์ธ ํ์ฌ ์ ํจ ์ด์๋ง ๋ฐํ.
Returns: ์ด์์๊ธ์ ํ, ๋ถ๋ฅ๋ฒํธ, ๋ถ๋ฅ๋ฒํธ๋ด์ฉ, ์ ์ฉ์ต์ ์ด์(์), ์ ์ฉ์์์ผ์, ์ ์ฉ์ข ๋ฃ์ผ์.
Inputs: fare_type, current_only, classification_no.
get_freight_rateA
์ฒ ๋ ํ๋ฌผ ์์จ(ton-km ๊ธฐ์ค ์ด์ ์์จ) ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค. (์ ์ฒด 249๊ฑด, ํ์ฌ ์ ํจ ์ฝ 123๊ฑด)
Args: category: ์ ์ฒญ๊ตฌ๋ถ (์: "์ผ๋ฐ", "์ปจํ ์ด๋"). ์์ผ๋ฉด ์ ์ฒด. classification_no: ๋ถ๋ฅ๋ฒํธ (์: "10", "1001", "1021"). ์์ผ๋ฉด ์ ์ฒด. current_only: True๋ฉด ํ์ฌ ์ ์ฉ ์ค์ธ ์์จ๋ง ๋ฐํ (์ ์ฉ์ข ๋ฃ์ผ์ 2100 ์ดํ). ๊ธฐ๋ณธ True. โป ๋ถ๋ฅ๋ฒํธ 1xxx๋ ์ปจํ ์ด๋ ์์จ. 10~80๋ฒ๋๋ ์ผ๋ฐ ํ๋ฌผ ์์จ.
Returns: ์ ์ฒญ๊ตฌ๋ถ, ๋ถ๋ฅ๋ฒํธ, ๋ถ๋ฅ๋ฒํธ๋ด์ฉ(ํ๋ฌผ ์ ํ ์ค๋ช ), ์ ์ฉ์์จ(์/ton-km), ์ปจํ ์ด๋๊ท๊ฒฉ๋ด์ฉ, ์ ์ฉ๊ธฐ๊ฐ.
Inputs: category, current_only, classification_no.
get_hazardous_cargoA
์ํ๋ฌผ ์ ๋ณด ์กฐํ (๋ก์ปฌ CSV, 2025.09.15 ๊ธฐ์ค).
์ํ๋ฌผ๋ถ๋ฅ๊ธฐ์ค(52๊ฑด) + ์ํ๋ฌผ์ฝ๋์์ธ(2301๊ฑด) ๋ ํ ์ด๋ธ์ ํตํฉ ์กฐํ.
query: ์ ์์ํ๋ฌผ ํ๊ธ๋ช ๋๋ ๋ฒํธ ๋ถ๋ถ์ผ์น ๊ฒ์ (์: '๊ฐ์ค', '์์ธํธ๋ ', '1001')
grade: ์ํ๋ฌผ๋ฑ๊ธ๋ฒํธ ์ ํ์ผ์น ํํฐ (์: '1'=ํญ๋ฐ๋ฌผ, '2'=๊ฐ์ค, '3'=์ธํ์ฑ์ก์ฒด)
limit: ์ต๋ ๋ฐํ ๊ฑด์ (๊ธฐ๋ณธ 50)
์ํ๋ฌผ ๋ฑ๊ธ ์๋ด: 1=ํญ๋ฐ๋ฌผ, 2=๊ฐ์ค(์ธํ์ฑยท๋ ์ฑ), 3=์ธํ์ฑ์ก์ฒด, 4=๊ฐ์ฐ์ฑ๊ณ ์ฒด, 5=์ฐํ์ฑ๋ฌผ์ง, 6=๋ ์ฑ๋ฌผ์ง, 7=๋ฐฉ์ฌ์ฑ๋ฌผ์ง, 8=๋ถ์์ฑ๋ฌผ์ง, 9=๊ธฐํ์ํ๋ฌผ
Inputs: grade, limit, query.
get_homepage_deptA
KORAIL ํํ์ด์ง ๋ถ์ ์ ๋ณด ์กฐํ (์ ์ฒด ์ฝ 500๊ฑด).
๋ถ์๋ช (DEPT_NM), ๋ถ์์ฝ๋(DEPT_CODE), ์์๋ถ์์ฝ๋(UPPER_DEPT_CODE)๋ฅผ ์ ๊ณตํ๋ค.
keyword: ๋ถ์๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "๋ณธ๋ถ", "์ฒ", "๋จ", "TF") โป ์ ์ฒด ๋ฐ์ดํฐ๊ฐ ํฌ๋ฏ๋ก keyword ์์ด ํธ์ถํ๋ฉด ์ฒ์ 200๊ฑด๋ง ๋ฐํ๋จ. ์ ์ฒด ์กฐํ๊ฐ ํ์ํ๋ฉด keyword๋ฅผ ์ฌ๋ฌ ๋ฒ ๋๋ ํธ์ถํ ๊ฒ.
Inputs: keyword. Returns: result
get_homepage_positionB
KORAIL ํํ์ด์ง ์ง์ฑ ์ฝ๋ ์กฐํ.
์ง์ฑ ID, ์ง์ฑ ๋ช , ์ง์ฑ ์ฝ๋๋ฅผ ์ ๊ณตํ๋ค.
keyword: ์ง์ฑ ๋ช ๋ถ๋ถ์ผ์น ํํฐ
Inputs: keyword. Returns: result
get_info_disclosure_codesA
์ ๋ณด๊ณต๊ฐ ์์คํ ๊ณตํต์ฝ๋ ์กฐํ.
๋ถ๋ฅ์ฝ๋(CODETYPE), ๋ถ๋ฅ์ฝ๋๋ช (CODENAME), ์ฌ์ฉ์ฌ๋ถ๋ฅผ ์ ๊ณตํ๋ค.
code_type: CODETYPE ์ผ์น ํํฐ (๋น๊ฐ=์ ์ฒด)
Inputs: code_type. Returns: result
get_info_disclosure_deptA
์ ๋ณด๊ณต๊ฐ ๋ด๋น ๋ถ์ ๋ชฉ๋ก ์กฐํ.
๋ถ์์ฝ๋, ๋ถ์๋ช , ์์๋ถ์๋ช (์๋ฌธ)์ ์ ๊ณตํ๋ค.
keyword: ๋ถ์๋ช ๋ถ๋ถ์ผ์น ํํฐ
Inputs: keyword. Returns: result
get_job_gradesA
์ง๊ธ ์ฝ๋ ์ ๋ณด ์กฐํ (109๊ฑด).
์ง๊ธ๋ฑ๊ธ(1~10๊ธ), ์ง๊ธ๋ช , ์ง๊ธ์ฝ๋๋ฅผ ์ ๊ณตํ๋ค. ์ฌ๋ฌดยท๊ธฐ์ ยท์ฐจ๋ยท์ด์ ยท์ ๊ธฐํต์ ยทํ ๋ชฉยท๊ฑด์ถยทํน์ยท์ด์ฐจ์น๋ฌดยท๋ฌผ๋ฅ์์ ๋ฑ ์ง์ข ๋ณ ๊ตฌ๋ถ.
grade_level: ์ง๊ธ๋ฑ๊ธ ์ ํ์ผ์น ํํฐ (์: 3 โ 3๊ธ ์ ์ฒด) keyword: ์ง๊ธ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "์ด์ ", "์ฐจ๋", "์ฌ๋ฌด์์ ")
Inputs: keyword, grade_level. Returns: result
get_ktx_long_term_statsA
KTX ์ฅ๊ธฐ ํต๊ณ ์กฐํ (2004~2023๋ , ๋ก์ปฌ XLSX).
๊ฒฝ๋ถ์ (์์ธ-๋ถ์ฐ)ยทํธ๋จ์ (์ฉ์ฐ-๋ชฉํฌ) 2๊ฐ ๋ ธ์ ์ 20๋ ์ญ์ฌ ๋ฐ์ดํฐ.
category ์ ํ: "์ดํํ์_์ฃผ์ค" โ ํ์์ผ ๊ธฐ์ค ํธ๋ ์ดํ ํ์ (๋จ์: ํ) "์ดํํ์_์ฃผ๋ง" โ ํ ์์ผ ๊ธฐ์ค ํธ๋ ์ดํ ํ์ (๋จ์: ํ) "์ด์_์" โ ํด๋น ์ฐ๋ ์ด์ (๋จ์: ์, ์์ธ-๋ถ์ฐยท์ฉ์ฐ-๋ชฉํฌ ๊ธฐ์ค) "์ด์ฉ๊ฐ_์ฒ๋ช ์" โ ์ํ๊ท ์ด์ฉ๊ฐ ์ (๋จ์: ์ฒ๋ช /์) ๋น๊ฐ โ ์ 4๊ฐ ์นดํ ๊ณ ๋ฆฌ ์ ์ฒด ๋ฐํ
route: "๊ฒฝ๋ถ์ " | "ํธ๋จ์ " ๋ถ๋ถ์ผ์น ํํฐ (๋น๊ฐ=์ ์ฒด) year_from / year_to: ์ฐ๋ ๋ฒ์ ํํฐ (์: year_from=2010, year_to=2019)
Inputs: route, year_to, category, year_from. Returns: result
get_ktx_stationsA
KTX ๋ ธ์ ๋ณ ์ญ ์ ๋ณด(์ญ๋ช , ๋๋ก๋ช ์ฃผ์, ์ ์ฐจ ์๋ฒ)๋ฅผ ์กฐํํฉ๋๋ค. (์ด 102๊ฑด)
Args: line_name: KTX ๋ ธ์ ๋ช ๋ถ๋ถ ์ผ์น (์: "๊ฒฝ๋ถ์ ", "ํธ๋จ์ ", "๊ฒฝ์ ์ "). ์์ผ๋ฉด ์ ์ฒด. station_name: ์ญ๋ช ๋ถ๋ถ ์ผ์น (์: "์์ธ", "๋ถ์ฐ", "๊ด๋ช "). ์์ผ๋ฉด ํํฐ ์์.
Returns: ๊ณ ์์ฒ ๋๋ช , ์ฒ ๋์ด์๊ธฐ๊ด, ๋ ธ์ ๋ช , ์๋ฒ, ์ญ๋ช , ์ฃผ์(๋๋ก๋ช ) ๋ชฉ๋ก.
Inputs: line_name, station_name.
get_lease_codesA
์๋ ์์คํ ์ฝ๋ ์กฐํ (์ค์๊ฐ REST API).
์๋ ๊ด๋ จ ๋ถ๋ฅ ์ฝ๋ํ๋ฅผ ์ ๊ณตํ๋ค. ์ฝ๋ํ์ (type), ์ฝ๋๊ฐ(code), ์ฝ๋์ค๋ช (value)์ผ๋ก ๊ตฌ์ฑ๋๋ค.
code_type: ์ฝ๋ํ์ ์ ํ์ผ์น ํํฐ code: ์ฝ๋ ์ ํ์ผ์น ํํฐ value: ์ฝ๋์ค๋ช ๋ถ๋ถ์ผ์น ํํฐ
Inputs: code, value, code_type. Returns: result
get_leased_assetsA
ํ๊ตญ์ฒ ๋๊ณต์ฌ ์๋์์ฐ ํํฉ ์กฐํ (1,773๊ฑด).
์ฒ ๋๊ณต์ฌ๊ฐ ๊ด๋ฆฌ ์ค์ธ ์๋ ์์ฐ์ ์์ฌ์ง, ์์ค๋ช , ๊ณ์ฝ๊ธฐ๊ฐ, ์๋๋ฉด์ (ใก), ์ฐ๊ฐ์๋๋ฃ(๋ถ๊ฐ์ธ ๋ณ๋)๋ฅผ ์ ๊ณตํ๋ค. ์ญ์ฌ ๋ด ์์ ๊ณต๊ฐยท๊ฑด๋ฌผยท์ ํด๋ถ์ง ๋ฑ ์ค์ ์๋ ์ค์ธ ๋ถ๋์ฐ ์์ฐ ์ ๋ณด. B551457 /stores(๋งค์ฅ ์ด์์ ๋ณด)์ ๋ค๋ฆ โ ์ด ๋๊ตฌ๋ ์์ฐ/์ฌ๋ฌด ๊ด์ .
location: ์์ฐ์์ฌ์ง ๋ถ๋ถ์ผ์น ํํฐ (์: "์์ธ", "๋์ ", "๊ฒฝ๊ธฐ") facility_name: ์์ค๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "์์ธ์ญ", "์ฉ์ฐ์ญ")
Inputs: location, facility_name. Returns: result
get_lease_storesA
์ญ์ฌ ๋ด ์๋๋งค์ฅ ์ด์์ ๋ณด ์กฐํ (์ค์๊ฐ REST API).
์ญ์ฌ ๋ด ์๋๋งค์ฅ์ ๋งค์ฅ๋ช , ๋งค์ฅ์์น, ์ญ๋ช , ๋ณธ๋ถ, ๊ฐ์ ์ผ์, ๊ณ์ฝ๊ธฐ๊ฐ, ์น์ธ๋ฉด์ , ํ์ผยทํด์ผ ์์ ์๊ฐ ๋ฑ์ ์ ๊ณตํ๋ค.
store_name: ๋งค์ฅ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "ํ๋ฆฌ๋ฐ๊ฒ๋จ", "GS25") station_code: ์ญ์ฝ๋ ์ ํ์ผ์น ํํฐ (์: "0001") station_name: ์ญ๋ช ์ ํ์ผ์น ํํฐ (์: "์์ธ์ญ", "๋ถ์ฐ์ญ")
Inputs: store_name, station_code, station_name. Returns: result
get_logistics_facilityA
๋ฌผ๋ฅ์์ค ์ ๋ณด ํตํฉ ์กฐํ (๊ธฐ๋ณธ 210๊ฑด + ๊ท๋ชจ 71๊ฑด + ์ฌ์ง 457๊ฑด).
์ญ๋ช ๋๋ ์ง์ญ๋ณธ๋ถ๋ช ๋ถ๋ถ์ผ์น ํํฐ. ๊ธฐ๋ณธ์ ๋ณด(์์ค ๋ฉด์ ยท์๊ธยท์์ ๋ฑ), ๊ท๋ชจ(์ธ์ด๋ก ์ฉ๋ยท์), ์ฌ์ง(์ฒจ๋ถํ์ผ๋ช ยท์ค๋ช )์ ์ญ๋ช ๊ธฐ์ค์ผ๋ก ๊ฒฐํฉ ๋ฐํ.
Inputs: limit, region, station_name.
get_mainline_carriageA
๊ฐ์ ์ฌ๊ฐ์ด์ฐจ ์์ก์ค์ ์กฐํ. ์ญ๋ณ ์นํ์ฐจ ์ธ์์๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ดํ์ผ์, ์ฃผ์ดํ์ (๊ฒฝ๋ถ์ ยทํธ๋จ์ ๋ฑ), ์ญ ๊ธฐ์ค์ผ๋ก ํํฐ๋ง ๊ฐ๋ฅ.
Args: run_ymd: ํน์ ์ดํ์ผ์ (YYYYMMDD). ์ ๋ ฅ ์ ํด๋น ๋ ์ง๋ง ์กฐํ. run_ymd_gte: ์ดํ์ผ์ ์์ (YYYYMMDD, ์ดํ) run_ymd_lte: ์ดํ์ผ์ ์ข ๋ฃ (YYYYMMDD, ์ด์ ) mrnt_cd: ์ฃผ์ดํ์ ์ฝ๋ (์: "01"=๊ฒฝ๋ถ์ ) mrnt_nm: ์ฃผ์ดํ์ ๋ช (์: "๊ฒฝ๋ถ์ ", "ํธ๋จ์ ") stn_cd: ์ญ์ฝ๋ (์: "3900023"=์์ธ) stn_nm: ์ญ๋ช (์: "์์ธ", "๋ถ์ฐ")
Inputs: stn_cd, stn_nm, mrnt_cd, mrnt_nm, +3 more. Returns: result
get_mainline_day_of_week_perA
๊ฐ์ ์ด์ฐจ ์์ผ๋ณ ์ด์ฉ์ธ์ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-2). run_ym=์ดํ์ฐ์(YYYYMM), rte_nm=๋ ธ์ ๋ช
Inputs: rte_nm, run_ym. Returns: result
get_mainline_distance_perB
๊ฐ์ ์ด์ฐจ ๊ฑฐ๋ฆฌ๋ณ ์ด์ฉ์ธ์ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-2). run_ym=์ดํ์ฐ์(YYYYMM)
Inputs: run_ym. Returns: result
get_mainline_grade_perA
๊ฐ์ ์ด์ฐจ ๊ฐ์ค๋ณ ์ด์ฉ์ธ์ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-2). run_ym=์ดํ์ฐ์(YYYYMM), carmdl=์ฐจ์ข ๋ช (์:KTX)
Inputs: carmdl, run_ym. Returns: result
get_mainline_model_perA
๊ฐ์ ์ด์ฐจ ์ฐจ๋๋ณ ์ด์ฉ์ธ์ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-2). run_ym=์ดํ์ฐ์(YYYYMM), carmdl=์ฐจ์ข ๋ช (์:KTX)
Inputs: carmdl, run_ym. Returns: result
get_mainline_person_distanceB
๊ฐ์ ์ด์ฐจ ๋ ธ์ ๋ณ ์ธ๊ฑฐ๋ฆฌ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-2). run_ym=์ดํ์ฐ์(YYYYMM), rte_nm=๋ ธ์ ๋ช
Inputs: rte_nm, run_ym. Returns: result
get_mainline_route_perA
๊ฐ์ ์ด์ฐจ ๋ ธ์ ๋ณ ์ด์ฉ์ธ์ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-2). run_ym=์ดํ์ฐ์(YYYYMM), rte_nm=๋ ธ์ ๋ช
Inputs: rte_nm, run_ym. Returns: result
get_mainline_station_perB
๊ฐ์ ์ด์ฐจ ์ญ๋ณ ์นํ์ฐจ ํต๊ณ (๊ฐฑ์ : ๋งค์ผ D-2~D-1). opr_ymd=ํน์ ์ผ์(YYYYMMDD), opr_ymd_gte/lte=๊ธฐ๊ฐ, stn_nm=์ญ๋ช
Inputs: stn_nm, opr_ymd, opr_ymd_gte, opr_ymd_lte. Returns: result
get_mainline_ticketing_statA
๊ฐ์ ์ด์ฐจ ๋ฐ๊ถ์ ํ ํต๊ณ (๊ฐฑ์ : ๋งค์ 1์ผ, M-1). ntsl_ym=ํ๋งค์ฐ์(YYYYMM), ise_type=๋ฐ๊ถ์ ํ๋ช
Inputs: ntsl_ym, ise_type. Returns: result
get_maintenance_equipmentA
์ฒ ๋์ฐจ๋ ๊ฒ์์ฉ ๊ธฐ๊ณ ๋ณด์ ํํฉ ์กฐํ (2024.12.31 ๊ธฐ์ค, 16๊ฐ ์ง์ญ). ์ง์ญ(์ ๋น๋จยท์ง์ญ๋ณธ๋ถ)๋ณ ๊ณต์๊ธฐ๊ณยท์๋๊ธฐ๊ณยท์ํ๊ธฐ๊ณยท์ ์ฒด๊ธฐ๊ณยท์๋ฌผ๊ธฐ๊ณยท ๊ณต๊ธฐ๊ธฐ๊ณยทํ ๋ชฉ๊ธฐ๊ณยท๊ณ์ค๊ธฐ๊ณยท์ฐจ๋์ด๋๊ธฐ๊ณยท์ ๊ธฐ๊ธฐ๊ณยท๋ก๊ธฐ๊ณยท์ก๊ธฐ๊ณยท๊ณ ์์ํ๊ธฐ๊ณ ์๋. region: ์ง์ญ ๋ถ๋ถ์ผ์น (์: '์๋๊ถ', '๋ถ์ฐ', '๋์ ', '๊ฐ์'). '์ ๋น๋จ' ๋๋ '์ง์ญ๋ณธ๋ถ'๋ก ๊ตฌ๋ถ ๊ฐ๋ฅ. ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด 16๊ฐ ์ง์ญ ๋ฐํ.
Inputs: region. Returns: result
get_office_meeting_roomsA
๋ณธ์ฌ ์ฌ์ฅ ํ์์ค ๋ชฉ๋ก ์กฐํ (11๊ฑด).
ํ์์ค์ฝ๋, ์์ฉ์ธ์, ํ์์ค์ฌ์(๋ช ์นญยท์ข์์)์ ์ ๊ณตํ๋ค. ๋ํ์์ค(160์)๋ถํฐ ์ํ์์ค(18์), ์์ํ์์ค, ๋์งํธํ๋ธ ๋ฉ ํฌํจ.
โป 2024๋ ์ดํ ์ต์ ํ ์ด๋ ฅ ์์. ํ์ฌ ์ด์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์.
min_capacity: ์ต์ ์์ฉ์ธ์ ํํฐ (์: 30 โ 30์ธ ์ด์ ํ์์ค๋ง)
Inputs: min_capacity. Returns: result
get_operation_distanceA
์ ๊ตญ ์ฒ ๋ ๋ ธ์ ๋ณ ์ญ๊ฐ ์ดํ๊ฑฐ๋ฆฌ๋ฅผ ์กฐํํฉ๋๋ค. (20๊ฐ ๋ ธ์ ๊ทธ๋ฃน)
์ด์ฐจ๊ฐ ์ค์ ๋ก ์ฃผํํ๋ ์ ๋ก ๊ฑฐ๋ฆฌ ๊ธฐ์ค์ ๋๋ค. ์ด์ ๊ณ์ฐ์ฉ ์ฌ๊ฐ์ต๋จ์ดํ๊ฑฐ๋ฆฌ์ ๋ค๋ฅผ ์ ์์ต๋๋ค. (์: ์์ธโ๋ถ์ฐ KTX ์ดํ๊ฑฐ๋ฆฌ 417.4 km, ์ฌ๊ฐ์ต๋จ์ดํ๊ฑฐ๋ฆฌ 441.7 km)
โ ๏ธ ์ด ๋ฐ์ดํฐ๋ ์ฒ ๋์ดํ๊ฑฐ๋ฆฌ_์ ์ฒด XLSX(๋ ธ์ ๋ณ ์ผ๊ฐํ๋ ฌ)์ ์๋ก๋ ์ญ๋ง ํฌํจํฉ๋๋ค. KTX ์ ์ฉ์ ๊ฒฝ์ ์ญ(๊ฒฝ๋ถKTX: ์์ธยท์๋ฑํฌยท๊ด๋ช ยท์ฒ์์์ฐยท์ค์กยท๋์ ยท๊น์ฒ๊ตฌ๋ฏธยท๋๋๊ตฌยท๋ถ์ฐ ๋ฑ)๋ง ์๊ณ , ๊ฐ์ KTX๊ฐ ๊ฒฝ์ ํด๋ ํ์ ยท์์์ฒ๋ผ ๋ณ๋ ์ธ์ ์ ยท์ฌ๋์ ์ญ์ ๋ฏธํฌํจ์ผ ์ ์์ต๋๋ค.
Args: line_name: ๋ ธ์ ๋ช ๋ถ๋ถ ์ผ์น (์: "๊ฒฝ๋ถ", "ํธ๋จ", "์ ๋ผ", "๊ฐ๋ฆ", "์๋", "์ค์", "ํ๋ฐฑ"). ์์ผ๋ฉด ์ ์ฒด ๋ ธ์ ๊ทธ๋ฃน ๋ชฉ๋ก ๋ฐํ. from_station: ์ถ๋ฐ์ญ๋ช (์ ํ ์ผ์น). ํด๋น ์ญ์์ ์ถ๋ฐํ๋ ๋ชจ๋ ๊ฑฐ๋ฆฌ ๋ฐํ. to_station: ๋์ฐฉ์ญ๋ช (์ ํ ์ผ์น). from_station๊ณผ ํจ๊ป ์ง์ ์ ๋ ์ญ ๊ฐ ๊ฑฐ๋ฆฌ ๋ฐํ.
Returns: line_name ์์: available_lines ๋ชฉ๋ก. line_name๋ง: ๋งค์นญ ๋ ธ์ ๊ณผ ์ญ ๋ชฉ๋ก. from_station ์ถ๊ฐ: ์ถ๋ฐ์ญ์์ ๊ฐ ์ญ๊น์ง์ ๊ฑฐ๋ฆฌ ๋ชฉ๋ก(๊ฑฐ๋ฆฌ ์ค๋ฆ์ฐจ์ ์ ๋ ฌ). from+to ๋ชจ๋: ๋ ์ญ ๊ฐ ๊ฑฐ๋ฆฌ(km). โป ์ต์ด ํธ์ถ ์ XLSX ํ์ฑ์ ์ ์ด ์์๋ฉ๋๋ค.
Inputs: line_name, to_station, from_station.
get_rolling_stock_by_yearA
์ฐ๋๋ณ ์ฐจ๋๋ณด์ ํํฉ ์กฐํ (2024.12.31 ๊ธฐ์ค, 2016~2024๋ 9๊ฐ ์ฐ๋). KTXยทSRTยทKTX-์ด์ยท๋์ ค๊ธฐ๊ด์ฐจยท์ ๊ธฐ๊ธฐ๊ด์ฐจยท๋์ ค๋์ฐจยท์ ๊ธฐ๋์ฐจยท๊ฐ์ ํ์ ๊ธฐ๋์ฐจยท ITX-์ฒญ์ถยท๊ฐ์ฐจยท๋ฐ์ ์ฐจยทํ์ฐจยท๊ธฐ์ค๊ธฐ ์ฐจ์ข ๋ณ ์ฐ๋๋ณ ๋ณด์ ๋์ ํฌํจ. year: ์กฐํ ์ฐ๋ (์: '2024', '2020'). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด 9๊ฐ ์ฐ๋ ๋ฐํ. โป SRT๋ SR(์์๊ณ ์์ฒ ๋) ์์์ผ๋ก KORAIL ๋ณด์ ์์น์ ํฌํจ๋ ๊ฒ์ผ๋ก ํ๊ธฐ๋จ.
Inputs: year. Returns: result
get_segment_infoA
์ฒ ๋ ์ ๋์ฐจ ์ธ๊ทธ๋จผํธ(๊ตฌ๊ฐ) ์ ๋ณด๋ฅผ ์กฐํํฉ๋๋ค. ์ธ๊ทธ๋จผํธ๋ ๋ ธ์ ์ ์ดํ ๋ถ์ ์ต์ ๋จ์๋ก ๋ถ๋ฆฌํ ๊ตฌ๊ฐ์ ๋๋ค.
Args: segment_code: ์ธ๊ทธ๋จผํธ์ฝ๋ (์: "100", "200", "300"). region: ์ดํ์ง์ญ๋ณธ๋ถ ๋ถ๋ถ ์ผ์น (์: "์์ธ", "๋์ ", "์๋๊ถ์๋ถ", "๋ถ์ฐ"). station: ์ธ๊ทธ๋จผํธ ์์์ญยท์ข ๋ฃ์ญยท๊ฒฝ์ ์ญ๋ช ๋ถ๋ถ ์ผ์น (์: "์์ธ", "๋์ ").
Returns: basic: ์ธ๊ทธ๋จผํธ ๊ธฐ๋ณธ ์ ๋ณด (์ฝ๋, ๊ธฐ๊ฐ, ์ง์ญ๋ณธ๋ถ, ์์์ญ, ์ข ๋ฃ์ญ, ๊ฑฐ๋ฆฌ(km)). detail: ํด๋น ์ธ๊ทธ๋จผํธ ๊ตฌ์ฑ ์ญ ์์ธ (์ญ๋ช , ์ญ์ผ๋ จ๋ฒํธ, ๋์ ๊ฑฐ๋ฆฌ). total_segments: ๋งค์นญ๋ ์ธ๊ทธ๋จผํธ ์.
Inputs: region, station, segment_code.
get_social_donationsA
์ฌํ๊ณตํ '์ฌ๋์ ์ฑ๊ธ' ์ฌ์ฉ ๋ด์ญ ์กฐํ (1,053๊ฑด).
์ฑ๊ธ ์ง์ถ ๊ด๋ฆฌ๋ฒํธ, ์๋ฒ, ์ง์ถ์ผ์, ๊ธ์ก(์), ์ฌ์ฉ๋ด์ญ์ ์ ๊ณตํ๋ค. ์จ๋๋ฆฌ์ํ๊ถ ๊ตฌ๋งค, ํดํผํธ๋ ์ธ ์ฌํ์ํ๋น, ํ์๋ฌผํ ๊ตฌ์ ๋ฑ.
date_from: ์ง์ถ์ผ์ ์์ (์: "2025-01-01") date_to: ์ง์ถ์ผ์ ์ข ๋ฃ keyword: ๋ด์ญ ๋ถ๋ถ์ผ์น ํํฐ (์: "์จ๋๋ฆฌ", "ํดํผํธ๋ ์ธ", "ํํ")
Inputs: date_to, keyword, date_from. Returns: result
get_social_fundsA
์ฌํ๊ณตํ ํ๋ ์ข ๋ฅ ์กฐํ (6๊ฑด).
์ฌํ๊ณตํ ์ฌ์ ํ๋ ์ ํ(์ข ๋ฅ๋ช , ๊ธฐ๋ณธ๊ฐ์ฌ๋ถ, ๋ถ๋ฅ์์)์ ์ ๊ณตํ๋ค. '์ฌ๋์ ์ฑ๊ธ', '๋งค์นญ๊ทธ๋ํธ', '์์ฒด์ฑ๊ธ', '๋ฌ๋ธํฌ์ธํธ' ๋ฑ ๊ตฌ๋ถ.
Inputs: no named parameters. Returns: result
get_social_orgA
์ฌํ๊ณตํ ํฌํธ ์กฐ์ง์ ๋ณด ์กฐํ (6,306๊ฑด).
ํ๊ตญ์ฒ ๋๊ณต์ฌ ์ ์ฒด ์กฐ์ง ํํฉ(๋ณธ๋ถยท์ญยท์ฌ์ ์ยทํ ๋ฑ)์ ์ ๊ณตํ๋ค. ์กฐ์ง๋ช ์ 'KORAIL/๊ฐ์๋ณธ๋ถ/๊ฐ๋ฆ์ญ' ํ์์ ๊ณ์ธต ๊ฒฝ๋ก. ๋ฉ๋ชจ1ยท๋ฉ๋ชจ2ยท๋ฉ๋ชจ3์ ๋ณธ๋ถ๋ช ยท์์ ์ ๋ณด ํฌํจ.
โป ์ ์ฒด ์กฐํ ์ ์ต๋ 200๊ฑด ๋ฐํ. org_name ๋๋ headquarter ํํฐ ๊ถ์ฅ.
org_name: ์กฐ์ง๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "๊ฐ๋ฆ์ญ", "์ฐจ๋์ฌ์ ์", "AI์ ๋ต๋ณธ๋ถ") headquarter: ๋ณธ๋ถ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "๊ฐ์๋ณธ๋ถ", "์์ธ๋ณธ๋ถ", "๋์ ")
Inputs: org_name, headquarter. Returns: result
get_social_volunteer_fieldsA
์ฌํ๊ณตํ ๋ด์ฌ ๋ถ์ผ ์ฝ๋ ์กฐํ (7๊ฑด).
๋ด์ฌ๋ถ์ผ ๊ตฌ๋ถ์ฝ๋, ๋ถ์ผ๋ช , ๋ถ์ผ์ค๋ช ์ ์ ๊ณตํ๋ค. ๋ด์ผํ์ฐ์คยทํดํผํธ๋ ์ธยท๋ณต์ง๋จ์ฒดยทํ๊ฒฝ๋ด์ฌยทํํ ๋ฑ.
keyword: ๋ถ์ผ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "ํํ", "ํ๊ฒฝ", "ํดํผ")
Inputs: keyword. Returns: result
get_social_volunteer_matchingA
์ฌํ๊ณตํ ๋ด์ฌํ๋ ๋งค์นญ ์ง์ถ ๋ด์ญ ์กฐํ (877๊ฑด).
๋ด์ฌํ๋ ๋งค์นญ ๊ด๋ จ ์ง์ถ์ ๊ด๋ฆฌ๋ฒํธ, ์๋ฒ, ์ง์ถ์ผ์, ์ฌ์ฉ๊ธ์ก(์), ์ฌ์ฉ๋ด์ญ์ ์ ๊ณตํ๋ค. ๋งค์นญ๊ทธ๋ํธยท์จ๋๋ฆฌ์ํ๊ถยท๋ด์ฌ์์ ๊ฐ์๋น ๋ฑ.
date_from: ์ง์ถ์ผ์ ์์ date_to: ์ง์ถ์ผ์ ์ข ๋ฃ keyword: ์ฌ์ฉ๋ด์ญ ๋ถ๋ถ์ผ์น ํํฐ (์: "๋งค์นญ๊ทธ๋ํธ", "๋ด์ฌ์", "์จ๋๋ฆฌ")
Inputs: date_to, keyword, date_from. Returns: result
get_station_distanceA
๋ ์ญ ๊ฐ ์ต๋จ ์ดํ๊ฑฐ๋ฆฌ(km)๋ฅผ ์กฐํํฉ๋๋ค. ์ฌ๊ฐยทํ๋ฌผ ๊ฑฐ๋ฆฌ๋ฅผ ๊ตฌ๋ถํ๋ฉฐ ๊ฒฝ์ ์ญ ์ ๋ณด ํฌํจ.
Args: from_station: ์ถ๋ฐ์ญ๋ช (์ ํํ ์ญ๋ช ๊ถ์ฅ, ๋ถ๋ถ ์ผ์น๋ ์ง์. ์: "์์ธ", "๋ถ์ฐ"). to_station: ๋์ฐฉ์ญ๋ช (๋ถ๋ถ ์ผ์น). ์์ผ๋ฉด ์ถ๋ฐ์ญ์์ ์ถ๋ฐํ๋ ๋ชจ๋ ๊ตฌ๊ฐ ๊ฑฐ๋ฆฌ ๋ฐํ. current_only: True๋ฉด ํ์ฌ ์ ํจ ๋ฐ์ดํฐ(์ ์ฉ์ข ๋ฃ์ผ์=9999-12-31)๋ง ๋ฐํ. ๊ธฐ๋ณธ True.
Returns: ์ถ๋ฐ์ญ๋ช , ๋์ฐฉ์ญ๋ช , ์ฌ๊ฐ์ต๋จ์ดํ๊ฑฐ๋ฆฌ(km), ํ๋ฌผ์ดํ๊ฑฐ๋ฆฌ(km), ๊ตฌ๊ฐ๊ฑฐ๋ฆฌ๋ด์ฉ(๊ฒฝ์ ์ญ), ์ ์ฉ๊ธฐ๊ฐ. โป ์ด 220,782๊ฑด. ์ต์ด ํธ์ถ ์ ๋ก๋ฉ์ ์ ์ด๊ฐ ์์๋ฉ๋๋ค. ์ต๋ 200๊ฑด ๋ฐํ. โป ์ถ๋ฐ์ญ๋ช ๊ธฐ์ค ์ธ๋ฑ์ค๋ง ์กด์ฌ. "ํน์ ์ญ์ ๋์ฐฉํ๋ ๋ชจ๋ ๊ฒฝ๋ก" ์ญ๋ฐฉํฅ ์กฐํ๋ ๋ฏธ์ง์. โป ์ฌ๊ฐ์ต๋จ์ดํ๊ฑฐ๋ฆฌ๋ ์ด์ ๊ณ์ฐ ๊ธฐ์ค ๊ฑฐ๋ฆฌ๋ก, ์ค์ ์ด์ฐจ ์ดํ๊ฑฐ๋ฆฌ(XLSX ๊ธฐ์ค)์ ๋ค๋ฅผ ์ ์์. ์: ์์ธโ๋ถ์ฐ ์ฌ๊ฐ์ต๋จ 441.7 km vs KTX ์ดํ๊ฑฐ๋ฆฌ 417.4 km (๊ณ ์์ vs ์ด์ ๊ธฐ์ค์ ์ฐจ์ด).
Inputs: from_station (required), to_station, current_only.
get_station_facilitiesB
์ญ ์ด๋ฆ์ผ๋ก ํธ์์์ค ์ ๋ณด ์กฐํ (B551457 ์ค์๊ฐ API). ์๋ฆฌ๋ฒ ์ดํฐยท์์ค์ปฌ๋ ์ดํฐยทํ์ฅ์คยท์์ ์คยท์ข ํฉ์๋ด์ผํฐ ์ ๋ฌด. station_name: ์ญ ์ด๋ฆ ๋ถ๋ถ์ผ์น (์: '์์ธ', '๋ถ์ฐ') (EN: station amenities/facilities - elevator, escalator, restroom, nursing room, information center. JA: ้ง ใฎไพฟๅฎๆฝ่จญใป่จญๅ - ใจใฌใใผใฟใผใใจในใซใฌใผใฟใผใใใคใฌใๆไนณๅฎคใๆกๅ ใปใณใฟใผ) โป ๋ฐ์ดํฐ๊ธฐ์ค์ผ: ์ค์๊ฐ API (๋ ์ง ๋ฏธํฌํจ). ํ์ฅ ๋ณ๊ฒฝ์ด ์ฆ์ ๋ฐ์๋์ง ์์ ์ ์์.
Inputs: station_name (required). Returns: result
get_station_facilities_detailA
์ญ์ฌ ๋ด์ธ๋ถ ์์คํํฉ ์กฐํ (odcloud, 2024.12.31 ๊ธฐ์ค, 288๊ฐ ์ญ). ์๋ฆฌ๋ฒ ์ดํฐยท์์ค์ปฌ๋ ์ดํฐยทํ ์ฒด์ด๋ฆฌํํธยท์ฅ์ ์ธ๊ฒฝ์ฌ๋กยท์ฅ์ ์ธํ์ฅ์คยท์ผ๋ฐํ์ฅ์คยท ๋ชจ์ ์์ ์คยท์ข ํฉ์๋ด์ยทํ์น์ฃผ์ฐจ์ฅ(๋ฉด์) ์๋ ํฌํจ. station_name: ์ญ๋ช ๋ถ๋ถ์ผ์น (์: '์์ธ', '๊ด๋ช '). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด ๋ฐํ. (EN: detailed interior/exterior station facilities - elevator, escalator, wheelchair lift, accessible ramp/restroom, nursing room, parking. JA: ้ง ่ๅ ๅคใฎ่ฉณ็ดฐใช่จญๅ็พๆณ) โป B551457 ํธ์์์ค API ๋๋น ์๋ ์ ๋ณด ๋ ํ๋ถํ๋ ๋ฐ์ดํฐ ๊ธฐ์ค์ผ ๊ณ ์ (2024.12.31).
Inputs: station_name. Returns: result
get_station_locationA
์ญ ์์น ์ ๋ณด ์กฐํ (odcloud, 2024.04.01 ๊ธฐ์ค, 202๊ฐ ๊ฐ์ ์ฒ ๋์ญ). ์ง์ญ๋ณธ๋ถยท์ญ๋ช ยท์๋ยท๊ฒฝ๋ยท์ถ์ ๊ตฌ ๊ฐ์ ํฌํจ. station_name: ์ญ๋ช ๋ถ๋ถ์ผ์น (์: '์์ธ', '๋ถ์ฐ'). region: ์ง์ญ๋ณธ๋ถ ๋ถ๋ถ์ผ์น (์: '์์ธ๋ณธ๋ถ', '๋์ ์ถฉ์ฒญ', '๊ฐ์๋ณธ๋ถ'). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด ๋ฐํ. (EN: station location - coordinates, regional HQ, number of exits. JA: ้ง ใฎไฝ็ฝฎๆ ๅ ฑ)
Inputs: region, station_name. Returns: result
get_station_track_infoA
์ญ๋ณ ์ ๋กยท์์ค ์์ธ ์ ๋ณด ์กฐํ (๊ณตํต๊ธฐ์ค ์ญ์์ธ, ๋ก์ปฌ CSV, 2025.06.18 ๊ธฐ์ค, 5161ํ).
๊ตฌ๋ด์ ํจ์ฅยท์ ๋ก๊ธธ์ดยท์ง์ ยท์ ์ฉ์ ๊ฑฐ๋ฆฌ, ์ด์ ์, ๋ถ๊ธฐ์ญ์ฌ๋ถ, ์ ํ์์์ฌ๋ถ ๋ฑ ํ์ฅ ์ด์์ ํ์ํ ์ญ ์ ๋ก ์ ์ ์ ๋ณด ์ ๊ณต.
station_name: ์ญ์ด๋ฆ ๋ถ๋ถ์ผ์น (์: '์์ธ', '๋ถ์ฐ', '๋์ '). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด.
current_only: True(๊ธฐ๋ณธ)์ด๋ฉด ํ์ฌ ์ ํจํ ์ด๋ ฅ๋ง ๋ฐํ (์ญ์ด๋ ฅ์ ์ฉ์ข ๋ฃ์ผ์ ๋น ๊ฐ). False์ด๋ฉด ์ด๋ ฅ ์ ์ฒด(๋์ผ ์ญ์ ์ด๋ ฅ ๋ณ๊ฒฝ ํฌํจ) ๋ฐํ.
์ฃผ์ ์ปฌ๋ผ: ๊ตฌ๋ด์ ํจ์ฅ(m), ๊ตฌ๋ด์ ๋ก๊ธธ์ด(m), ์ง์ ์ ํจ์ฅ(m), ์ง์ ์ ๋ก๊ฑฐ๋ฆฌ(m), ์ ์ฉ์ ์ ํจ์ฅ(m), ์ ์ฉ์ ์ ๋ก๊ฑฐ๋ฆฌ(m), ์ด์ ์, ๋ถ๊ธฐ์ญ์ฌ๋ถ(Y/N), ์ ํ์์์ฌ๋ถ(Y/N)
Inputs: current_only, station_name.
get_station_transfer_infoA
์ญ๋ณ ํ ๊ตํต์๋จ๊ณผ ํ์นํํฉ ์กฐํ (odcloud, 2024.12.31 ๊ธฐ์ค, 93๊ฐ ์ญ). ๋ ธ์ ๋ณยท์ญ๋ณ KTXยท๊ด์ญ์ฒ ๋ยท๋์์ฒ ๋ ์ญ์ ๋ฐ ํ์น์ฃผ์ฐจ์ฅ ๋ฉด์ ํฌํจ. station_name: ์ญ๋ช ๋ถ๋ถ์ผ์น (์: '์์ธ', '๋๋๊ตฌ'). line_name: ๋ ธ์ ๋ช ๋ถ๋ถ์ผ์น (์: '๊ฒฝ๋ถ๊ณ ์', 'ํธ๋จ์ '). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด ๋ฐํ. (EN: transfer info to other transit modes by station. JA: ้ง ๅฅใฎไปไบค้ๆๆฎตใธใฎไนๆ็พๆณ)
Inputs: line_name, station_name. Returns: result
get_support_departmentsA
์ ๋ฌด์ง์ ๋ถ์๋ณ ์ง์ยท์ง๊ธ ์ธ์ ํํฉ ์กฐํ (10,015๊ฑด).
๋ถ์๋ช , ์ง์๋ช , ์ง๊ธ๋ช , ์ธ์์๋ฅผ ์ ๊ณตํ๋ค. ์กฐ์ง ๋ด ์ธ๋ ฅ ๋ฐฐ๋ถ ๋ฐ ์ง๋ฌด ๊ตฌ์กฐ ํ์ ์ ํ์ฉ.
โป ์ ์ฒด ์กฐํ ์ ์ต๋ 200๊ฑด ๋ฐํ. ํํฐ ์ฌ์ฉ ๊ถ์ฅ.
dept_name: ๋ถ์๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "์์ธ์ญ", "AI์ ๋ต๋ณธ๋ถ", "์ฐจ๋์ฌ์ ์") position: ์ง์๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "์ญ์ฅ", "ํ์ฅ", "๊ธฐ์ ์") grade: ์ง๊ธ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: "์ฌ๋ฌด์์ 3๊ธ", "์ด์ 4๊ธ", "ํ ๋ชฉ5๊ธ")
Inputs: grade, position, dept_name. Returns: result
get_support_facilitiesA
์ฌ์ฅ ๋ด ๋ถ๋์์ค ๋ชฉ๋ก ์กฐํ (29๊ฑด).
๋ณธ์ฌ ์ฌ์ฅ ๋ด ๋ถ๋์์ค(์นดํยท์ด๋ฆฐ์ด์งยทํ์์คยท์คํฌ์ธ ์ผํฐยทํธ์์ ๋ฑ)์ ์์ค๋ช , ์์ฑ์ผ์, ์์ ์ผ์, ๋น๊ณ ๋ฅผ ์ ๊ณตํ๋ค.
โป ์ต์ ์ฑ ์ฃผ์: 2025.08.20 ๊ธฐ์ค ๋ฐ์ดํฐ๋ก ํ์ฌ์ ๋ค๋ฅผ ์ ์์.
Inputs: no named parameters. Returns: result
get_train_codesA
์ด์ฐจ์ดํ ์ฝ๋์ ๋ณด ์กฐํ. ์ต์ ํ๋ ์ด์์ ํ๋ผ๋ฏธํฐ ํ์. code_type=์ฝ๋์ ํ(์:stn_cd,mrnt_cd), code=์ฝ๋๊ฐ(์ ํ์ผ์น), value=์ฝ๋๋ช (๋ถ๋ถ์ผ์น) ์ฃผ์ code_type: stn_cd(์ญ์ฝ๋), mrnt_cd(์ฃผ์ดํ์ ์ฝ๋)
Inputs: code, value, code_type. Returns: result
get_train_operation_by_typeA
์ฐจ์ข ๋ณ ์ฐ๊ฐ ์ดํ์ค์ ์กฐํ (๋ก์ปฌ CSV, 2025.08.31 ๊ธฐ์ค, 2019~2025๋ ).
๋์ ค๊ธฐ๊ด์ฐจยท์ ๊ธฐ๊ธฐ๊ด์ฐจยท์ ๋์ฐจ(์๋๊ถ) ๋ฑ KORAIL ๋ณด์ ์ฐจ์ข ๋ณ ์ฐ๊ฐ ์ดํ ํ์. 2025๋ ์ 8์๊น์ง์ ํต๊ณ.
year: ํน์ ์ฐ๋ (์: 2024). 0์ด๋ฉด ์ ์ฒด(2019~2025).
train_type: ์ฐจ์ข ๋ช ๋ถ๋ถ์ผ์น ํํฐ (์: 'KTX', 'ITX', '๋์ ค๊ธฐ๊ด์ฐจ', '์ ๊ธฐ๊ธฐ๊ด์ฐจ'). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด ์ฐจ์ข ์ปฌ๋ผ ๋ฐํ.
์ฃผ์ ์ฐจ์ข : ๋์ ค๊ธฐ๊ด์ฐจ(4400ยท7300ยท7400ยท7500ํธ๋), ์ ๊ธฐ๊ธฐ๊ด์ฐจ(8200ยท8500ํธ๋), KTX, ITX-์๋ง์, ITX-์ฒญ์ถ, ๋๋ฆฌ๋ก, ์๋๊ถ์ ๋์ฐจ ๊ฐ ๊ณ์ด
Inputs: year, train_type. Returns: result
get_train_run_historyA
์ฐจ์ธ๋์์ฝ๋ฐ๋งค ์ด์ฐจ ์ดํ๋ด์ญ ์กฐํ (2024-01-01 ๋จ์ผ ์ผ์ 100๊ฑด ์ค๋ ์ท).
โป ๋ฐ์ดํฐ ํ๊ณ (๋ฐ๋์ ์ฐธ๊ณ ):
์ด ๋ฐ์ดํฐ๋ 2024-01-01 ํ๋ฃจ์น๋ง ์กด์ฌ. ๋ค๋ฅธ ๋ ์ง ํํฐ ์ 0๊ฑด ๋ฐํ.
์ค์ ํ๋ฃจ ์ดํ ์ด์ฐจ๋ ์๋ฐฑ ํธ์ด๋, ์ด ์ค๋ ์ท์ ์ผ๋ถ ์ด์ฐจยท์ญ ํฌํจ.
๋์ผ (์ด์ฐจ๋ฒํธ, ์ญ)์ด 2๊ฑด์ฉ ์ค๋ณต ๋ฑ์ฅํ๋ ๊ฒฝ์ฐ ์์ (๊ฒฝ์ ์ฒ๋ฆฌ ๋ฐฉ์).
์ ์ฐจ ์๋ฒ ํ๋ ์์ โ ์ ํํ ์ ์ฐจ ์์๋ get_train_run_info ๋๋ get_train_run_plan์ผ๋ก ๊ต์ฐจ ํ์ธ ํ์.
์ญ์ฝ๋ ์์ธ ์ ๋ณด(์๋ฌธ๋ช ยท์ง์ญ๋ณธ๋ถ ๋ฑ)๋ korail-codebook์ decode_station_code ๋๊ตฌ๋ก ์กฐํ ๊ฐ๋ฅ.
ํ๋ผ๋ฏธํฐ:
run_dt: ์ดํ์ผ์ (YYYY-MM-DD, ์: '2024-01-01')
trn_no: ์ด์ฐจ๋ฒํธ (์: '6' ๋๋ '00006', ์ซ์ ์๋ ๋ณํ)
stn_nm: ํ๊ธ์ญ๋ช ๋ถ๋ถ์ผ์น (์: '์์ธ', '๋ถ์ฐ')
stn_cd: ์ญ์ฝ๋ ์ ํ์ผ์น (์: '3900023')
dedupe: True ์ ๋์ผ (์ด์ฐจ๋ฒํธ+์ญ์ฝ๋) ์ค๋ณต ๋ ์ฝ๋ ์ ๊ฑฐ (๊ธฐ๋ณธ False)
๋ฐํ ํ๋: ์ดํ์ผ์(RUN_DT), ์ด์ฐจ๋ฒํธ(TRN_NO), ์ญ์ฝ๋(STN_CD), ํ๊ธ์ญ๋ช (KOR_STN_NM)
Inputs: dedupe, run_dt, stn_cd, stn_nm, +1 more. Returns: result
get_train_run_infoB
์ฌ๊ฐ์ด์ฐจ ์ค์ ์ดํ์ ๋ณด ์กฐํ (์ดํ์ผ์ยท์ญ๋ณ ์ค์ ์ถ๋ฐ/๋์ฐฉ์๊ฐยท์ ์ฐจ๊ตฌ๋ถ). run_ymd=ํน์ ์ผ์(YYYYMMDD), run_ymd_gte/lte=๊ธฐ๊ฐ ๋ฒ์, stn_nm=์ญ๋ช (์:์์ธ), mrnt_nm=์ฃผ์ดํ์ ๋ช (์:๊ฒฝ๋ถ์ )
Inputs: stn_nm, mrnt_nm, run_ymd, run_ymd_gte, +1 more. Returns: result
get_train_run_planB
์ฌ๊ฐ์ด์ฐจ ์ดํ๊ณํ ์กฐํ (์ด์ฐจ๋ฒํธยท์ถ๋ฐ/๋์ฐฉ์ญยท๊ณํ์ถ๋ฐ/๋์ฐฉ์๊ฐ). run_ymd=ํน์ ์ผ์(YYYYMMDD), run_ymd_gte/lte=๊ธฐ๊ฐ ๋ฒ์, dptre_stn_nm=์ถ๋ฐ์ญ๋ช (์:์์ธ), arvl_stn_nm=๋์ฐฉ์ญ๋ช (์:๋ถ์ฐ)
Inputs: run_ymd, arvl_stn_nm, run_ymd_gte, run_ymd_lte, +1 more. Returns: result
get_train_type_specsA
๋๋ ฅ์ฐจ ํ๋ณ์ ์ ์กฐํ (2024.12.31 ๊ธฐ์ค, 47๊ฐ ์ฐจ์ข ). KTXยทKTX-์ฐ์ฒยทKTX-์ด์ยท๋์ ค๊ธฐ๊ด์ฐจยท์ ๊ธฐ๊ธฐ๊ด์ฐจยท๋์ ค๋์ฐจยท์ ๊ธฐ๋์ฐจยทITX ๋ฑ ๊ฐ ์ฐจ์ข ์ ๋ง๋ ฅ(HP)ยท๋ณด์ ๋์ยท์์ค(ํค)ยท๋ด์ฉ์ฐ์ ํฌํจ. train_type: ํ๋ณ๋ช ๋ถ๋ถ์ผ์น (์: 'KTX', '๋์ ค๊ธฐ๊ด์ฐจ', '์ ๊ธฐ๊ธฐ๊ด์ฐจ', 'ITX'). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด 47๊ฐ ๋ฐํ.
Inputs: train_type. Returns: result
get_transport_stat_codesA
์์ก์ค์ ํต๊ณ ์ฝ๋์ ๋ณด ์กฐํ. ๊ฐ์ ยท๊ด์ญยทํ๋ฌผ ์์ก์ค์ ์์ ์ฌ์ฉ๋๋ ์ฝ๋๋ฅผ ์กฐํํฉ๋๋ค. (๊ตฌ get_carriage_codes โ carriageStatistics/codes) ์ต์ ํ๋ ์ด์์ ํ๋ผ๋ฏธํฐ๋ฅผ ์ ๋ ฅํด์ผ ๊ฒฐ๊ณผ๊ฐ ๋ฐํ๋ฉ๋๋ค.
Args: code_type: ์ฝ๋์ ํ (์: "stn_cd"=์ญ์ฝ๋, "mrnt_cd"=์ฃผ์ดํ์ ์ฝ๋, "sbwy_ln_cd"=์ ์ฒ ์ ์ฝ๋) code: ์ฝ๋๊ฐ ์ ํ์ผ์น (์: "3900023") value: ์ฝ๋๋ช ๋ถ๋ถ์ผ์น (์: "์์ธ", "๊ฒฝ๋ถ")
์ฃผ์: ํ๋ผ๋ฏธํฐ ์์ด ํธ์ถํ๋ฉด 0๊ฑด ๋ฐํ๋ ์ ์์ต๋๋ค. code_type ์ง์ ์ ๊ถ์ฅํฉ๋๋ค.
Inputs: code, value, code_type. Returns: result
get_urban_accessibilityA
๋์์ฒ ๋ ์ญ์ฌ ์ ๊ทผ์ฑ ์์ค ์กฐํ (๊ตํต์ฝ์).
facility_type: elevator ์๋ฆฌ๋ฒ ์ดํฐ ํํฉ elevator_route ์๋ฆฌ๋ฒ ์ดํฐ ์ด๋๋์ elevator_route_detail ์๋ฆฌ๋ฒ ์ดํฐ ์์ธ ์ด๋๋์ (๊ฒฝ๋ก ํ ์คํธ) escalator ์์ค์ปฌ๋ ์ดํฐ ํํฉ wheelchair_route ํ ์ฒด์ด๋ฆฌํํธ ์ด๋๋์ wheelchair_lift_loc ํ ์ฒด์ด๋ฆฌํํธ ์ค์น ์์น(์น์ยทํ๊ณ์ค๋) safety_step ์น๊ฐ์ฅ ์์ ๋ฐํ ์ค์น์ ๋ฌด platform_gap ์น๊ฐ์ฅ-์ฐจ๋ ์ด๊ฒฉ๊ฑฐ๋ฆฌ braille ์ ์ํ์ ์ ๋ฌด disabled_toilet ์ฅ์ ์ธํ์ฅ์ค ์์น adjacent_elevator ์ธ์ ์น๊ฐ๊ธฐ ์ฐจ๋๋ฒํธ stair_car ์ธ์ ๊ณ๋จ ์ฐจ๋๋ฒํธ(ํ ์ฒด์ด ํ์ฐจ์์น) all ์ ์ ์ฒด (์ญ์ด 1~3๊ฐ๋ก ํน์ ๋ ๋๋ง) station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator, facility_type. Returns: result
get_urban_amenityA
๋์์ฒ ๋ ์ญ์ฌ ํธ์์์ค ์กฐํ.
amenity_type: toilet(ํ์ฅ์ค) / nursing_room(์์ ์ค) / locker(๋ฌผํ๋ณด๊ดํจ) / atm(ATM) / lost_found(์ ์ค๋ฌผ์ผํฐ) / wifi(๋ฌด์ ์ธํฐ๋ท) / all(์ ์ฒด) station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator, amenity_type. Returns: result
get_urban_environmentA
๋์์ฒ ๋ ์ญ์ฌ ํ๊ฒฝ์ธก์ ์ ๋ณด ์กฐํ (๊ณต๊ธฐ์งยท์จ๋ยท์ต๋ยท์์).
measure: air_quality(๊ณต๊ธฐ์งยท๋ฏธ์ธ๋จผ์งยทCO2) / temperature(์จ๋) / humidity(์ต๋) / noise(์์๋) / all(์ ์ฒด) station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ). ์ฃผ์: ํ๊ฒฝ์ธก์ ๊ธฐ๋ ์ผ๋ถ ์ด์๊ธฐ๊ดยท์ญ์๋ง ์ค์น๋์ด ๋ฐ์ดํฐ๊ฐ ์์ ์ ์๋ค (ํนํ ์์๋). ์ธก์ ๊ฐ์๋ ์ธก์ ์ผ์(msmtDttm)๊ฐ ํจ๊ป ์จ๋ค.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), measure, operator. Returns: result
get_urban_exit_infoA
๋์์ฒ ๋ ์ญ์ฌ ์ถ๊ตฌ์ ๋ณด ์กฐํ (์ถ๊ตฌ๋ฒํธยท์ฃผ๋ณ์์คยท๊ฑฐ๋ฆฌ). station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator. Returns: result
get_urban_movementA
๋์์ฒ ๋ ๊ตํต์ฝ์ ์ถ์ ๊ตฌโ์น๊ฐ์ฅ ์ด๋๊ฒฝ๋ก(๋์ ) ์กฐํ.
์๋ฆฌ๋ฒ ์ดํฐ ๋ฑ ๋ฌด์ฅ์ ๊ฒฝ๋ก๋ฅผ ์ถ์ ๊ตฌ๋ถํฐ ์น๊ฐ์ฅ๊น์ง ๋จ๊ณ๋ณ ํ ์คํธ(mvContDtl)์ ์๋ด ์ด๋ฏธ์ง(imgPath)๋ก ์ ๊ณตํ๋ค. station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ). line: ๋ ธ์ (์ ํ). next_station: ์ด์ฐจ ์งํ๋ฐฉ๋ฉด์ '๋ค์ ์ญ๋ช '(์น๊ฐ์ฅ ๋ฐฉํฅ ํน์ ์ ์ฌ์ฉ). ๊ฐ์ ๋ ธ์ ์ ๋ค์ ์ญ๋ช ์ ๋ฃ๋๋ค. ๋ฏธ์ ๋ ฅ ์ ๋ฐฉ๋ฉด ๊ตฌ๋ถ ์์ด ์กฐํ. ์ฐธ๊ณ : ์ญ ๋ด ์๋ฆฌ๋ฒ ์ดํฐ ์์ธ ๋์ ์ get_urban_accessibility(elevator_route_detail)๋ ์๋ค.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), line, operator, next_station. Returns: result
get_urban_platformA
๋์์ฒ ๋ ์ญ์ฌ ์น๊ฐ์ฅ ์ ๋ณด ์กฐํ (์น๊ฐ์ฅ ์ ํยท๋ณตํฉ์ฌ๋ถยท์์ ๋ฐํ ๋ฑ). station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator. Returns: result
get_urban_routeA
๋์์ฒ ๋ ๋ ธ์ ์ ์ฒด ์ญ ๊ตฌ์ฑ(์ํ~ํํ ์์) ์กฐํ. ์ญ ๋ฌด๊ด, ๋ ธ์ ๋จ์.
line: ์ ์ฝ๋(์ '1','A1','I1') ๋๋ ๋ ธ์ ๋ช ์ผ๋ถ(์ '1ํธ์ ','๊ฒฝ์์ค์'). region: ๊ถ์ญ โ ์๋๊ถ/๋ถ์ฐ/๋๊ตฌ/๊ด์ฃผ/๋์ (๋๋ ์ฝ๋ 01~05). ์๋๊ถ ๋ ธ์ ์ region์ ํจ๊ป ์ฃผ๋ฉด ์ ํํ๋ค.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: line, region. Returns: result
get_urban_safetyA
๋์์ฒ ๋ ์ญ์ฌ ์์ ์์ค ์กฐํ.
safety_type: defibrillator(์ ์ธ๋๊ธฐ) / fire_extinguish(์ํ์ค๋น) / emergency_phone(๋น์์ฝํฐ) / air_respirator(๊ณต๊ธฐํธํก๊ธฐ) / screen_door(์คํฌ๋ฆฐ๋์ด) / safety_fence(์น๊ฐ์ฅ ์์ ํ์ค) / all(์ ์ฒด) station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator, safety_type. Returns: result
get_urban_station_infoA
๋์์ฒ ๋ ์ญ์ฌ ๊ธฐ๋ณธ์ ๋ณด ์กฐํ (์ฃผ์ยท์ขํยท๋ค๊ตญ์ด ์ญ๋ช ). station_name: ์ญ๋ช . operator: ํ์น์ญ ๊ตฌ๋ถ์ฉ ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator. Returns: result
get_urban_surroundingsA
๋์์ฒ ๋ ์ญ ์ฃผ๋ณ ์์ค ์กฐํ (๋์ค๊ตํตยท์ฃผ์ฐจ์ฅยท์์ ๊ฑฐ).
kind: public_transport(์ฃผ๋ณ ๋ฒ์ค ๋ฑ ๋์ค๊ตํต) / parking(์ฃผ๋ณ ์ฃผ์ฐจ์ฅ) / bike_parking(์์ ๊ฑฐ ์ฃผ์ฐจ์์ค) / bike_rental(์์ ๊ฑฐ ๋์ฌ) / all(์ ์ฒด) station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), kind, operator. Returns: result
get_urban_timetableA
๋์์ฒ ๋ ์ญ์ฌ๋ณ ์ดํ์๊ฐํ(์ด์ฐจ ๋์ฐฉยท์ถ๋ฐ์๊ฐ) ์กฐํ.
station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ). day: ์์ผ โ ํ์ผ/ํด์ผ/ํ /์ผ/์~๊ธ ๋๋ ์ ์์ผ. (๊ธฐ๋ณธ ํ์ผ) express: True๋ฉด ๊ธํ ์๊ฐํ(์ด์๊ธฐ๊ด์ ๋ฐ๋ผ ๋ฏธ์ ๊ณต์ผ ์ ์์).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), day, express, operator. Returns: result
get_urban_train_compositionA
๋์์ฒ ๋ ์ด์๊ธฐ๊ด๋ณ ์ด์ฐจ ํธ์ฑ์ข ๋ฅ ์กฐํ (์ญ ๋ฌด๊ด).
ํธ์ฑ์ ํ์ฝ๋(cpsTpCd)ยทํธ์ฑ๋ช ยทํธ์ฐจ๋ณ ์ข์/์ถ์ ๋ฌธ์/๊ตํต์ฝ์์ ๋ฑ์ ์ค๋ค. ์ด ๋๊ตฌ๋ก ์ป์ cpsTpCd์ ํธ์ฐจ(scarNo)๋ฅผ get_urban_train_facility์ composition_typeยทscar_seq ์ธ์๋ก ๋๊ฒจ ์ฐจ๋๋ณ ์์ค์ ์กฐํํ๋ค. operator: ์ด์๊ธฐ๊ด ์ฝ๋(์ 'BS') ๋๋ ๋ช (์ '๋ถ์ฐ๊ตํต๊ณต์ฌ'). ์ฐธ๊ณ : ์์ธ๊ตํต๊ณต์ฌ(S1)ยทํ๊ตญ์ฒ ๋๊ณต์ฌ(KR)ยท๊ณตํญ์ฒ ๋(AR)๋ ํธ์ฑ๋ฐ์ดํฐ ๋ฏธ์ ๊ณต. ๋ถ์ฐ(BS)ยท๋๊ตฌ(DG)ยท์ธ์ฒ(IC)ยท๋์ (DJ)ยท๊ด์ฃผ(GJ) ๋ฑ์ ์ ๊ณต.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: operator (required). Returns: result
get_urban_train_environmentA
๋์์ฒ ๋ ์ด์ฐจ ์ฐจ๋ด ํ๊ฒฝ์ ๋ณด ์กฐํ (CO2ยท๋ฏธ์ธ๋จผ์งยท์จ๋ยท์ต๋ยท์์ ๋ฑ, ์ญ ๋ฌด๊ด).
operator: ์ด์๊ธฐ๊ด ์ฝ๋(์ 'S1') ๋๋ ๋ช (์ '์์ธ๊ตํต๊ณต์ฌ'). train_no: ์ด์ฐจ๋ฒํธ(์ ํ). ๋ฏธ์ ๋ ฅ ์ ํด๋น ์ด์๊ธฐ๊ด ์ ์ฒด ์ธก์ ๋ฐ์ดํฐ๋ฅผ ๋ฐํํ๋ค (์ฌ์ฉ์๊ฐ ์ด์ฐจ๋ฒํธ๋ฅผ ๋ชจ๋ฅผ ๋๊ฐ ๋ง์ผ๋ฏ๋ก ๋ณดํต ์๋ต). measure: ํ๊ฒฝ์ธก์ ํญ๋ชฉ์ฝ๋(envrMsmtDvCd) โ 1 ๋ฏธ์ธ๋จผ์ง(PM10), 2 CO2, 21 ์จ๋, 22 ์ต๋, 23 ์์ ๋ฑ. ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด ํญ๋ชฉ. ์ฐธ๊ณ : ์ฐจ๋ด ํ๊ฒฝ ๋ฐ์ดํฐ๋ ์์ธ๊ตํต๊ณต์ฌ(S1)ยท๋ถ์ฐ(BS)ยท๋๊ตฌ(DG) ๋ฑ ์ผ๋ถ ๊ธฐ๊ด๋ง ์ ๊ณต. ํ๊ตญ์ฒ ๋๊ณต์ฌ(KR)ยท๊ณตํญ์ฒ ๋(AR) ๋ฑ์ ๋ฏธ์ ๊ณต.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: operator (required), measure, train_no. Returns: result
get_urban_train_facilityA
๋์์ฒ ๋ ์ฐจ๋(ํธ์ฐจ)๋ณ ์์ค ์กฐํ (์ญ ๋ฌด๊ด).
facility_type: fire_extinguisher(์ํ๊ธฐ) / emergency_phone(๋น์์ฝํฐ) / crush_hammer(๋น์ํ์ถ๋ง์น) / door_manual(์ถ์ ๋ฌธ ์๋์ค์ ) / defibrillator(์ ์ธ๋๊ธฐ) / pregnant_seat(์์ฐ๋ถ ๋ฐฐ๋ ค์) / priority_seat(๋ ธ์ฝ์์) / wheelchair_board(ํ ์ฒด์ด ์น์ฐจ๊ฐ๋ฅ) / wheelchair_belt(ํ ์ฒด์ด ์์ ๋ฒจํธ) / all(์ ์ฒด) operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช . scar_seq: ํธ์ฐจ์ผ๋ จ๋ฒํธ(scarSqno, ์ '1'). composition_type: ํธ์ฑ์ ํ์ฝ๋(cpsTpCd). get_urban_train_composition์ผ๋ก ๋จผ์ ํ์ธํ๋ค. ์ฃผ์: ์ด์๊ธฐ๊ด๋ง๋ค ๋ณด์ ํญ๋ชฉ์ด ๋ฌ๋ผ ์ผ๋ถ ์ข ๋ฅ๋ ๋น ๊ฒฐ๊ณผ์ผ ์ ์๋ค.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: operator (required), scar_seq (required), composition_type (required), facility_type. Returns: result
get_urban_transfer_infoA
๋์์ฒ ๋ ์ญ์ฌ ํ์น์ ๋ณด ์กฐํ (ํ์น๋ ธ์ ยทํ์น๊ฑฐ๋ฆฌยท๋์ ). station_name: ์ญ๋ช . operator: ์ด์๊ธฐ๊ด ์ฝ๋/๋ช (์ ํ).
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: station_name (required), operator. Returns: result
get_wagon_by_load_capacityA
ํ์ฐจ ์ ์ฌํ์ค๋ณ ๋ณด์ ํํฉ ์กฐํ (2024.12.31 ๊ธฐ์ค, 27๊ฐ ํ์ค ๋ฑ๊ธ). ์ ์ฌํ์ค(ํ๋ฌผ ์ต๋ ์ ์ฌ ์ค๋) ๋ฑ๊ธ๋ณ ์ ๊ฐ์ฐจยท๋ฌด๊ฐ์ฐจยทํํ์ฐจยท์ํ๋ฌผยท์ ์กฐ์ฐจยท์ฐจ์ฅ์ฐจยท์นจ์์ฐจ ๋ณด์ ๋์. ํ๋๋ช ์ฃผ์: '์ ๊ฐ ์ฐจ', '๋ฌด ๊ฐ ์ฐจ', 'ํ ํ ์ฐจ' ๋ฑ ๋์ด์ฐ๊ธฐ ํฌํจ. wagon_type: ์ฐจ์ข (์: '์ ๊ฐ ์ฐจ', '๋ฌด ๊ฐ ์ฐจ', 'ํ ํ ์ฐจ', '์ ์กฐ ์ฐจ'). ํด๋น ์ฐจ์ข ๋ณด์ ๋ > 0 ์ธ ํ๋ง ๋ฐํ. min_load: ์ต์ ์ ์ฌํ์ค (์: '40'). max_load: ์ต๋ ์ ์ฌํ์ค (์: '60'). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด 27๊ฐ ํ ๋ฐํ.
Inputs: max_load, min_load, wagon_type. Returns: result
get_wagon_by_weight_classA
ํ์ฐจ ์์ค๋ณ ๋ณด์ ํํฉ ์กฐํ (2024.12.31 ๊ธฐ์ค, 70๊ฐ ์์ค ๊ตฌ๊ฐ). ์์ค(ํค) ๊ตฌ๊ฐ๋ณ ์ ๊ฐ์ฐจยท์ ์กฐ์ฐจยท๋ฌด๊ฐ์ฐจยทํํ์ฐจยท์ํ๋ฌผยท์ฐจ์ฅ์ฐจยท์นจ์์ฐจ ๋ณด์ ๋์. wagon_type: ์ฐจ์ข ํํฐ (์: '์ ๊ฐ์ฐจ', '์ ์กฐ์ฐจ', '๋ฌด๊ฐ์ฐจ', 'ํํ์ฐจ'). ํด๋น ์ฐจ์ข ๋ณด์ ๋ > 0 ์ธ ํ๋ง ๋ฐํ. min_weight: ์ต์ ์์ค(ํค, ์: '20'). max_weight: ์ต๋ ์์ค(ํค, ์: '25'). ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด 70๊ฐ ํ ๋ฐํ.
Inputs: max_weight, min_weight, wagon_type. Returns: result
get_wide_area_carriageA
๊ด์ญ ์ฌ๊ฐ์ด์ฐจ ์์ก์ค์ ์กฐํ. ์ ์ฒ ์ญ๋ณ ์๊ฐ๋๋ณ ์นํ์ฐจ ์ธ์์๋ฅผ ์ ๊ณตํฉ๋๋ค. ๊ด์ญ์ฒ ๋(์๋๊ถ ์ ์ฒ ๋ฑ) ์ด์ฉ ํต๊ณ ์กฐํ์ ์ฌ์ฉ.
Args: run_ymd: ํน์ ์ดํ์ผ์ (YYYYMMDD). ์ ๋ ฅ ์ ํด๋น ๋ ์ง๋ง ์กฐํ. run_ymd_gte: ์ดํ์ผ์ ์์ (YYYYMMDD, ์ดํ) run_ymd_lte: ์ดํ์ผ์ ์ข ๋ฃ (YYYYMMDD, ์ด์ ) sbwy_ln_cd: ์ ์ฒ ์ ์ฝ๋ (์: "101") sbwy_ln_nm: ์ ์ฒ ์ ๋ช (์: "๊ฒฝ๋ถ์ ") sbwy_stn_cd: ์ ์ฒ ์ญ์ฝ๋ (์: "010000") sbwy_stn_nm: ์ ์ฒ ์ญ๋ช (์: "์์ธ") tmwd_se_cd: ์๊ฐ๋๊ตฌ๋ถ์ฝ๋ (์: "01")
Inputs: run_ymd, sbwy_ln_cd, sbwy_ln_nm, tmwd_se_cd, +4 more. Returns: result
get_wide_rail_route_perB
๊ด์ญ์ฒ ๋ ๋ ธ์ ๋ณ ์ด์ฉ์ธ์ ํต๊ณ (๊ฐฑ์ : ๋งค์ 26์ผ, M-1). run_ym=์ดํ์ฐ์(YYYYMM), sbwy_ln_nm=์ ์ฒ ์ ๋ช
Inputs: run_ym, sbwy_ln_nm. Returns: result
get_wide_rail_station_perB
๊ด์ญ์ฒ ๋ ์ญ๋ณ ์นํ์ฐจ ํต๊ณ (๊ฐฑ์ : ๋งค์ 26์ผ, M-1). run_ym=์ดํ์ฐ์(YYYYMM), stn_nm=์ญ๋ช
Inputs: run_ym, stn_nm. Returns: result
list_freight_work_linesC
ํ๋ฌผ์ ํ์์ - ์ ์ฉ ์์ ์ ์ ๋ณด (์ด 424๊ฑด, odcloud, ์ ์ฒด ์บ์).
์ญ๋ช ๋ถ๋ถ์ผ์น ํํฐ ๊ฐ๋ฅ. ์์ ์ ๊ธธ์ดยท์์ ๊ฑฐ๋ฆฌยท์ด์๊ณ์ฐ๊ฑฐ๋ฆฌยทํ ์ธํ ์ฆ ๋ฑ ํฌํจ.
Inputs: limit, station_name.
list_standard_loading_timeA
ํ์ค ์ ํ์๊ฐ ๋ง์คํฐ (์ด 11๊ฑด, odcloud, ์ ์ฒด ๋ฐํ).
โ ๏ธ ๋ช ์นญ ์ฃผ์: data.go.kr ๋ฑ๋ก๋ช ์ '์ ํ์๊ฐ'์ด์ง๋ง ์ค์ ๋ฐ์ดํฐ๋ ํ๋ฌผ ์ ํ๋ณ ํ์ค ์์ ์๊ฐ ๋ง์คํฐ(์ผ๋ฐ ๋ณดํตํยทํ์ฝ๋ฅยท์ปจํ ์ด๋ ๋ฑ 11๊ฑด). ์กฐ์ ์ด๋ ฅ์ search_loading_time_adjustment ์ฌ์ฉ.
Inputs: no named parameters.
list_stations_by_regionA
์ง์ญ๋ณธ๋ถ๋ช (๋ถ๋ถ์ผ์น)์ผ๋ก ๊ดํ ์ญ ๋ชฉ๋ก ์กฐํ. ์ฃผ์ ์ง์ญ๋ณธ๋ถ: ์์ธ๋ณธ๋ถ, ์๋๊ถ๋๋ถ๋ณธ๋ถ, ์ถฉ์ฒญ๋ณธ๋ถ, ์ ๋ผ๋ณธ๋ถ, ๋๊ตฌ๋ณธ๋ถ, ๋ถ์ฐ๊ฒฝ๋จ๋ณธ๋ถ, ๊ฐ์๋ณธ๋ถ ์: region='์์ธ', region='๋ถ์ฐ๊ฒฝ๋จ'
Inputs: region (required). Returns: result
list_stations_with_elevatorA
์๋ฆฌ๋ฒ ์ดํฐ๊ฐ ์ค์น๋ ์ญ ๋ชฉ๋ก ์ ์ฒด ์กฐํ (B551457 ์ค์๊ฐ API). (EN: list of stations with elevators. JA: ใจใฌใใผใฟใผใ่จญ็ฝฎใใใ้ง ใฎไธ่ฆง) โป ๋ฐ์ดํฐ๊ธฐ์ค์ผ: ์ค์๊ฐ API. ํ์ฅ ๋ณ๊ฒฝ์ด ์ฆ์ ๋ฐ์๋์ง ์์ ์ ์์.
Inputs: no named parameters. Returns: result
search_consignment_changeB
์ํ๋ณ๊ฒฝ์๊ธ ๊ฒ์ (์ด 4,015๊ฑด, ๋ก์ปฌ CSV).
ํ๋ฌผ ์ด์ก์ฅ ์ ์ ํ ๋ฐ์ํ ์ฐฉ์ญ ๋ณ๊ฒฝยทํ๋ฌผ ์ง์ ๋ณ๊ฒฝ ๋ฑ ์ํ ์กฐ๊ฑด ๋ณ๊ฒฝ ๊ฑด๋ณ ์๊ธ ์ด๋ ฅ. ํํฐ: ์ ์๊ธ์ ๋ ฅ์ญ๋ช (station), ์ด์ก์ฅ๋ฒํธ(waybill_no), ํ๋ฌผ์ง์์ข ๋ฅ(change_type).
Inputs: limit, station, waybill_no, change_type.
search_consignment_change_per_wagonB
์ํ๋ณ๊ฒฝ์๊ธ ํ์ฐจ๋ณ (์ด 6,681๊ฑด, ๋ก์ปฌ CSV).
๊ฐ๋ณ ํ์ฐจ ๋จ์ ์ง์๋ฒํธยท์ด์ก์ฅ๋ฒํธยทํํต๋ฒํธ ๋งคํ ๋ฐ ํ์ฐจ์๊ธ ์ฐ์ถ ๊ทผ๊ฑฐ. ํํฐ: ํ์ฐจ์ฐจ๋๋ฒํธ(wagon_number), ์ด์ก์ฅ๋ฒํธ(waybill_no).
Inputs: limit, waybill_no, wagon_number.
search_container_recordA
์ปจํ ์ด๋ ์ ์ฌ ์ด๋ ฅ ํ์ด์ง ์กฐํ (์ด 166,275๊ฑด, odcloud).
๋์ฉ๋์ด๋ผ ๋งค ํธ์ถ ์ odcloud์ ํ์ด์ง ๋จ์๋ก ์์ฒญ. ํํฐ(์ปจํ ์ด๋๋ฒํธ/ํ์ฐจ์ฐจ๋๋ฒํธ/ํ๋ฌผ์ํ์ผ์/ํ๋ชฉ๋ช )๊ฐ ์ฃผ์ด์ง๋ฉด ๋ฐ์ ํ์ด์ง ๋ด์์ ๋ถ๋ถ์ผ์น๋ก ํํํฐ๋ง. per_page ์ต๋ 1000.
Inputs: page, per_page, item_name, receipt_date, +2 more.
search_freight_codeA
๋ด์ ํ๋ฌผ์ฝ๋ ๊ฒ์ (์ด 961๊ฑด).
๋ถ๋ฅ์ฝ๋(์: 7404), ํ๊ธ๋ช , ์๋ฌธ๋ช ์ ๋ํ ๋ถ๋ถ์ผ์น ๊ฒ์. ๋น query์ limit๋งํผ ์์์๋ถํฐ ๋ฐํ.
Inputs: limit, query.
search_g2b_itemA
G2B(๋๋ผ์ฅํฐ) ๋ถ๋ฅ๋ฒํธยทํ๋ช ๊ฒ์ (์ด 13,400๊ฑด, ๋ก์ปฌ CSV).
G2B๋ถ๋ฅ๋ฒํธ(8์๋ฆฌ) ๋๋ G2Bํ๋ช (ํ๊ธยท์๋ฌธ)์ผ๋ก ๋ถ๋ถ์ผ์น ๊ฒ์. ํ๋ช ํด์ค ํฌํจ. active_only=True ์ ์ฌ์ฉ ์ฝ๋๋ง ๋ฐํ.
Inputs: limit, query, active_only.
search_loading_time_adjustmentA
์ ํ์๊ฐ ์กฐ์ ์ด๋ ฅ ํ์ด์ง ์กฐํ (์ด 35,967๊ฑด, odcloud).
โ ๏ธ ๋ช ์นญ ์ฃผ์: data.go.kr ๋ฑ๋ก๋ช ์ 'ํ์ค์ ํ์๊ฐ'์ด์ง๋ง ์ค์ ๋ฐ์ดํฐ๋ ํ์ค ๋๋น ์กฐ์ ๋ ์ด๋ ฅ. ๋ง์คํฐ๋ list_standard_loading_time ์ฌ์ฉ.
ํํฐ: ์กฐ์ ์ญ(station), ์กฐ์ ์ฌ์ (reason, ์: '์ฒ์ฌ์ง๋ณ๋ฑ ์ ์กฐ๊ฑด', '์์ ๋ฅ๋ ฅ์ด๊ณผ'), ์กฐ์ ์ง์ญ๋ณธ๋ถ(region). ๋ฐ์ ํ์ด์ง ๋ด ๋ถ๋ถ์ผ์น ํํฐ๋ง. per_page ์ต๋ 1000.
Inputs: page, reason, region, station, +1 more.
search_material_attrA
์์ฌ์์ฑ์ ๋ณด ์กฐํ (์ด 34,630๊ฑด, ๋ก์ปฌ CSV).
์์ฌ๋ฒํธยทG2B๋ถ๋ฅ๋ฒํธยท์์ฑ์ฝ๋๋ก ์กฐํ. ์์ฌ๋ณ ์์ฑ๊ฐ(๊ท๊ฒฉยท์ฌ์งยท์น์ ๋ฑ) ํ์ธ. ์ต์ 1๊ฐ ํํฐ ๊ถ์ฅ (๋ฏธ์ง์ ์ ์์์ limit๊ฑด ๋ฐํ).
Inputs: limit, g2b_code, attr_code, material_no.
search_material_equipmentA
์์ฌ๋์์ฅ๋น ์กฐํ (์ด 24,258๊ฑด, ๋ก์ปฌ CSV).
ํน์ ์์ฌ๋ฒํธ๊ฐ ์ฌ์ฉ๋๋ ์ฅ๋น ์ฝ๋ ์กฐํ, ๋๋ ์ฅ๋น์ฝ๋๋ก ํด๋น ์์ฌ ์ญ๊ฒ์.
Inputs: limit, equipment, material_no.
search_material_groupA
์์ฌ๊ทธ๋ฃน์ฝ๋ ๊ฒ์ (์ด 999๊ฑด, ๋ก์ปฌ CSV).
๊ทธ๋ฃน์ฝ๋(์: BB1300) ๋๋ ๊ทธ๋ฃน๋ช ์นญ(์: EMU์ฉํ)์ผ๋ก ๋ถ๋ถ์ผ์น ๊ฒ์. active_only=True ์ ์ฌ์ฉ ์ค(Y)์ธ ์ฝ๋๋ง ๋ฐํ.
Inputs: limit, query, active_only.
search_operation_patternsA
์ ๊ตญ ์ฒ ๋ ๋ ธ์ ์ ๋ณด๋ฅผ ๊ฒ์ํฉ๋๋ค. (์ด 2,146๊ฐ)
โ ๏ธ ์ฌ๊ธฐ์ "๋ ธ์ "์ ๋ฌผ๋ฆฌ์ ์ ๋ก(๊ฒฝ๋ถ์ ยทํธ๋จ์ ๋ฑ)๊ฐ ์๋๋ผ ์ด์ฐจ ์ดํ๊ณํต ์ฝ๋์ ๋๋ค. ๊ฒฝ๋ถ์ ์ ๋ก ํ๋์๋ ๋ค์ํ ๊ฒฝ์ ํจํด์ ์ดํ๊ณํต์ด ์๋ฐฑ ๊ฐ ์กด์ฌํฉ๋๋ค. "๋น์ ๊ธฐ ๋ ธ์ ์ด ๋ช ๊ฐ๋" ๊ฐ์ ์ธํ๋ผ ๊ธฐ์ค ์ง๋ฌธ์๋ ์์น๊ฐ ๊ณผ๋ ๊ณ์ฐ๋ฉ๋๋ค.
Args: query: ๋ ธ์ ์ฝ๋(ROUT_CD) ๋๋ ๋ ธ์ ๋ช (ROUT_NM) ๊ฒ์์ด (๋ถ๋ถ ์ผ์น). ์์ผ๋ฉด ์ ์ฒด ๋ฐํ. โป ๋ ธ์ ๋ช ์ "KTX" ๋ฌธ์์ด ์์. ๊ณ ์์ ์ "๊ณ ์", "๊ฒฝ๋ถ๊ณ ์" ๋ฑ์ผ๋ก ํ๊ธฐ๋จ. electric_only: True๋ฉด ์ ๊ธฐ๋๋ ฅ์ฐจ ์ดํ ๋ ธ์ ๋ง, False๋ฉด ๋น์ ๊ธฐ ๋ ธ์ ๋ง. None์ด๋ฉด ์ ์ฒด.
Returns: ๋ ธ์ ์ฝ๋(ROUT_CD), ๋ ธ์ ๋ช (ROUT_NM), ์ ๊ธฐ๋๋ ฅ์ฐจ์ดํ์ฌ๋ถ(ELC_LCM_RUN_FLG) ๋ชฉ๋ก.
Inputs: query, electric_only.
search_routeB
๋ ธ์ ๋ช (๋ถ๋ถ์ผ์น)์ผ๋ก ๋ ธ์ ์ฝ๋๋ฅผ ์กฐํ. name ๋ฏธ์ ๋ ฅ ์ ์ ์ฒด ๋ ธ์ ๋ชฉ๋ก ๋ฐํ. ์: name='๊ฒฝ๋ถ', name='ํธ๋จ', name='KTX'
Inputs: name. Returns: result
search_stationA
์ญ๋ช (๋ถ๋ถ์ผ์น)์ผ๋ก ์ญ์ฝ๋ยท์๋ฌธ๋ช ยท์ง์ญ๋ณธ๋ถ๋ฅผ ํตํฉ ์กฐํ. ์ฐจ์ธ๋์์ฝ๋ฐ๋งค ์ญ์ฝ๋(75์ญ, ์๋ฌธ๋ช ํฌํจ)์ ์ฒ ๋์ด์์ ๋ณด ์ญ์ฝ๋(1255์ญ) ๋ ์์คํ ์ ํจ๊ป ๊ฒ์. ์: name='์์ธ', name='์์', name='๊ด๋ช '
Inputs: name (required). Returns: result
search_urban_stationA
์ ๊ตญ ๋์์ฒ ๋ ์ญ๋ช ์ผ๋ก ์ด์๊ธฐ๊ดยท์ ยท์ญ์ฝ๋๋ฅผ ๊ฒ์ํ๋ค (๋ค๋ฅธ ์กฐํ์ ์ ํ ๋จ๊ณ).
KRIC API๋ ์ด์๊ธฐ๊ดยท์ ยท์ญ์ฝ๋๊ฐ ํ์ํ๋ฏ๋ก, ๋จผ์ ์ด ๋๊ตฌ๋ก ์ญ์ ํน์ ํ๋ฉด ํ์น์ญ ๋ฑ ๋์ผ ์ญ๋ช ์ ์ด์๊ธฐ๊ด ๊ตฌ๋ถ์ ํ์ธํ ์ ์๋ค. station_name: ์ญ๋ช ๋ถ๋ถ์ผ์น (์: '์์ธ์ญ', '๊ฐ๋จ'). ๋ฏธ์ ๋ ฅ ์ operator ๊ธฐ์ค ์ ์ฒด. operator: ์ด์๊ธฐ๊ด ์ฝ๋(์: 'S1') ๋๋ ๋ช (์: '์์ธ๊ตํต๊ณต์ฌ') ๋ถ๋ถ์ผ์น๋ก ์ขํ.
[๋ต๋ณ ์ง์นจ] _meta์ '๋ฐ์ดํฐ์์ ์ผ'(KRIC ๋ฐ์ดํฐ ์ต์ข ์์ ์์ , ์ธก์ ์ฑ ๋ฐ์ดํฐ๋ '์ธก์ ์์ ')์ ๊ทผ๊ฑฐ๋ก ๋ฐ์ดํฐ ์์ ์ ์๋ฆฌ๋, ์์ ์ผ์ ๋ฐ๋ผ ํค์ ๋ฌ๋ฆฌํ๋ผ.
์ต๊ทผ(์ฝ 2๋ ์ด๋ด, ์ 2025~2026): ๋ต๋ณ ๋์ '๋ฐ์ดํฐ๋ OOOO๋ ๊ธฐ์ค'์ ๊ฐ๊ฒฐํ ํ ์ค๋ง. ๊ฒฝ๊ณ ๋ฌธ๊ตฌ๋ ๊ณ ๊ฐ์ผํฐ ์ ํ๋ฒํธ๋ฅผ ๋ฐ๋ก ๋์ดํ์ง ๋ง๋ผ.
์ค๋๋จ(2019~2021 ๋ฑ): ํ ์ค ๊ณ ์ง์ ๋ํด '์ต์ ํํฉ๊ณผ ๋ค๋ฅผ ์ ์์ด ์ด์๊ธฐ๊ด ํ์ธ ๊ถ์ฅ'์ ๋ฑ ํ ๋ฒ๋ง ๋ง๋ถ์ฌ๋ผ. ์ ํ๋ฒํธ๋ ์ฌ์ฉ์๊ฐ ๋ฌป๊ฑฐ๋ ์๊ธยท์์ ๊ด๋ จ์ผ ๋๋ง. ์ฌ๋ฌ ๋ฐ์ดํฐ์ ์ ํจ๊ป ๋ณด์ฌ์ค ๋ ๊ฐ์ฅ ์ค๋๋ ์์ ์ผ ๊ธฐ์ค์ผ๋ก ํ ๋ฒ๋ง ๊ณ ์งํ๋ฉด ๋๋ค. ์์ ๊ณ ์งยท์ฃผ์ ๋ฌธ๊ตฌ๋ฅผ ๋ต๋ณ ์์์ ๋ฐ๋ณตํ์ง ๋ง๋ผ. ๊ฒฐ๊ณผ๊ฐ ๋น์ด ์์ผ๋ฉด ์ง์ด๋ด์ง ๋ง๊ณ 'ํด๋น ๋ฐ์ดํฐ ์์'์ ๋ถ๋ช ํ ์๋ ค๋ผ.
Inputs: operator, station_name. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 98 tools
There are several clusters of tools with unclear boundaries, such as get_station_facilities, get_accessible_facilities, get_station_facilities_detail, and the get_urban_* facility tools, which all cover similar physical station amenities from different sources. More seriously, get_mainline_carriage overlaps heavily with get_mainline_station_per, and get_wide_area_carriage overlaps with get_wide_rail_station_per, so an agent can easily select the wrong endpoint.
The set mostly uses English snake_case with get_/search_/list_/decode_ prefixes, so the broad pattern is readable. However, analogous tools are named inconsistently: get_mainline_carriage vs get_mainline_station_per, get_transport_stat_codes vs get_train_codes, and search_loading_time_adjustment vs list_standard_loading_time all use different verb/object conventions for similar lookup operations.
98 tools is an extreme size for a single MCP server and far exceeds the 50+ threshold for a coherence failure. Even if KORAIL has many datasets, the server should be split into focused sub-servers by domain such as urban rail, mainline operations, freight, station facilities, or corporate administration.
Read-only coverage is broad, but there are significant gaps for a KORAIL information server: current passenger fare lookup is missing, real-time train status/delay information is absent, and some datasets are only snapshots or single-day samples such as get_train_run_history. The many duplicated station and facilities datasets also make it unclear whether a query is fully answered without checking multiple tools.
Maintenance
Related MCP Connectors
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
All KR Data tools in one server: Korean business checks, addresses, laws, car flood records & more
Korea-native MCP gateway: Korean commerce, payments, messaging, gov & finance APIs for AI agents.
Korean statutes, precedents, local business-district stats and public procurement for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to access South Korean tourism information via the official Korea Tourism Organization API, providing comprehensive search for attractions, events, food, and accommodations with multilingual support.832 PyPI9MIT
- AlicenseAqualityCmaintenanceEnables natural language querying of Korean statistical data from KOSIS, including population, employment, GDP, housing prices, and more, with support for regional and trend analysis.810 npm18MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI to query real-time Korean public data including weather, real estate prices, air quality, economic indicators, and business registration via natural language.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Korean official statistics from KOSIS via natural language in MCP clients like Claude Desktop, wrapping the KOSIS OpenAPI for search, data retrieval, and metadata exploration.MIT