Skip to main content
Glama
reallygood83

sbinfo

by reallygood83
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

sbinfo — School Budget Intelligence

대한민국 학교알리미 공시 데이터를 기반으로
학교 예산·단위사업·교육운영 특색(HWP) 을 CLI / MCP / AI 에이전트에서 조회하는 오픈소스 도구입니다.

  • OpenAPI: 학교 검색, 예·결산(정책사업 8분류), 특색 플래그, 방과후·돌봄 센서

  • Web gongsi: 단위사업 (교무업무 운영 등)

  • kordoc: 특색사업 HWP → Markdown

  • MCP tools + /sbinfo 스킬 (Grok / Claude 등)

공공 데이터 출처 표기(KOGL)를 지켜 주세요.
예산 ≠ 실시간 잔액. 학교일반운영은 시설유지 비중이 클 수 있습니다.

빠른 시작

git clone https://github.com/reallygood83/sbinfo.git
cd sbinfo
bash scripts/setup.sh
# .env 에 학교알리미 OpenAPI 키 입력
# https://www.schoolinfo.go.kr → OpenAPI → 인증키

CLI (자유 검색 — 학교 하드코딩 없음)

PYTHONPATH=src .venv/bin/python scripts/layered_search.py \
  --sido 11 --sgg 11440 --level 02 --year 2025 --limit 3

# 학교명 키워드
PYTHONPATH=src .venv/bin/python scripts/layered_search.py \
  --sido 11 --sgg 11680 --keyword 역삼 --limit 5

인자

예

설명

--sido

11

시도 (서울=11, 경기=41, 부산=26…)

--sgg

11440

시군구 5자리

--level

02

02초 03중 04고

--year

2025

공시 연도

--keyword

공덕

학교명 부분 일치

MCP

./run_mcp.sh

Tool

설명

search_schools_tool

시군구+키워드 검색

get_school_deep

L1~L3 전체 (예산+단위+특색)

get_school_special_plan

특색 HWP → kordoc MD

get_school_budget_detail

정책사업 + 단위사업

analyze_area

지역 비교 인사이트

Grok 등록 (~/.grok/config.toml)

[mcp_servers.sbinfo]
command = "/ABS/PATH/TO/sbinfo/run_mcp.sh"
args = []
enabled = true
startup_timeout_sec = 25
tool_timeout_sec = 180
description = "sbinfo — 학교알리미 예산·특색 인텔"

Grok 재시작 후 MCP 도구 사용.

/sbinfo 스킬

# 사용자 스킬 설치
mkdir -p ~/.grok/skills/sbinfo
cp -R skills/sbinfo/SKILL.md ~/.grok/skills/sbinfo/

이후 채팅에서:

/sbinfo 서울 마포 초등 예산·특색 비교 3곳
/sbinfo --sido 11 --sgg 11440 --keyword 공덕 --year 2025

Related MCP server: open-assembly-mcp

레이어

Layer

내용

L1

학교 마스터, 학생수, 특색 API 플래그(67)

L2

예·결산 정책사업 8 + 방과후·돌봄(59)

L3

웹 단위사업 + 특색 HWP (kordoc)

디렉터리

src/sbi/           # Python 코어 + MCP
scripts/           # setup, layered_search
skills/sbinfo/     # /sbinfo 스킬
docs/              # 기획·설정 문서
run_mcp.sh

요구 사항

  • Node.js 18+ (kordoc)

  • Python ≥ 3.10 (권장 3.12)

  • 학교알리미 OpenAPI 키

라이선스

MIT — 데이터 이용 시 학교알리미 / 공공데이터 출처 표기는 별도로 준수하세요.

관련

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • dartpoint-mcp by dartpointai

    dartpoint-mcpofficial

    dartpointai
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP Server for public disclosure information of Korean companies, powered by the dartpoint.ai API.
    3
    Apache 2.0

  • open-assembly-mcp

    kyusik-yang
    A
    license
    A
    quality
    B
    maintenance
    MCP server for the Korean National Assembly Open API, enabling querying of bills, members, votes, committees, and more via natural language.
    20
    54 PyPI
    Apache 2.0

  • fin-products-tools

    hyeonseo2
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that provides tools to query Korean financial products (savings, deposits, pensions, mortgages, loans) via the FSS Open API, enabling search by company or product type.
    2
    MIT

  • narajangteo-prespec

    opendata-kr
    A
    license
    A
    quality
    C
    maintenance
    MCP server that wraps the Korean government's '나라장터 사전규격정보서비스' API, enabling natural language search and retrieval of public procurement pre-specifications through simplified tools.
    5
    19 npm
    MIT