GRNT
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
GRNT — 개인·창업 통합 지원금 판정기
Grants, simplified. · KOREA GRANT & SUBSIDY INTELLIGENCE
"나 지원금 받을 수 있어?"와 "우리 회사·가게가 받을 수 있어?"에 근거와 함께 답하는 서비스. 개인은 나이·지역·소득구간·상황(임신·출산·무주택·구직·장애 등)을, 창업·기업은 사업자 조건 (예비창업자/운영 중, 업력, 소상공인·중소기업, 업종)을 넣으면 정부24 보조금24의 공개 자격 코드와 K-Startup·기업마당 공고의 신청자격으로 후보를 판정하고, 사유·누락 정보·선정기준 원문·신청기한·문의처·출처를 같이 돌려줍니다. 로그인 없음, 주민등록번호 없음, 서버 저장 없음.
웹 UI:
GET /— 개인·가구 ↔ 창업·소상공인·기업 전환, 30초 조건 선택JSON API:
POST /v1/tools/{tool}— 툴 7종MCP:
POST /mcp·POST /v1/mcp(Streamable HTTP JSON-RPC 2.0) +python -m subsidy_kr.mcp_stdio정적 SEO:
GET /s/·GET /s/{slug}(개인 주제 + 창업·R&D 주제 + 지역),/robots.txt,/llms.txt,/sitemap.xmlAPI 키 없이 동작: 저장소에는 원본 동기화 산출물(25MB) 대신 압축본
data/gov24/catalog.json.gz(약 3.8MB) 만 둡니다. 로더는catalog.json이 있으면 그것을, 없으면catalog.json.gz를 읽습니다 — 그래서 클론·이미지·Render 가 동기화 없이 바로 12,429건 실데이터로 뜹니다. 내장 샘플(개인 20 + 창업·기업 12)은 둘 다 없을 때의 오프라인 대체입니다.data/gov24/catalog.json을 새로 만들면(아래 3분 실행) 그 파일이 압축본보다 우선합니다.저장소: https://github.com/CLNS-KR/GRNT · 이미지:
docker build -t grnt .실데이터 기준(2026-11-19 동기화): 제도 12,429건 — 개인·가구 10,887 · 창업·기업 1,542 (K-Startup 30,629건 중 모집·마감 30일 이내 207건, 기업마당 1,335건)
1. 3분 실행
# 파이썬 3.11+ · 외부 패키지 0개(표준 라이브러리만)
PYTHONPATH=src python -m subsidy_kr.server # http://localhost:8787
# 테스트
PYTHONPATH=src python -m unittest discover -s src/tests실데이터로 바꾸려면(선택, 세 데이터셋 모두 자동승인):
# 1) data.go.kr 활용신청 — 15113968(보조금24) · 15125364(K-Startup) · 15157820(기업마당)
# 2) 통합 동기화 (개인 + 창업·기업 + 일자별 스냅샷)
export DATA_GO_KR_SERVICE_KEY="발급받은키" # 또는 프로젝트 .env (.gitignore 포함)
PYTHONPATH=src python -m subsidy_kr.sync_gov24 --sources all
# 3) 서버 재시작 → /healthz 의 catalog_state 가 "synced" 로 바뀝니다--sources 는 gov24(기본) · startup · bizinfo · all 입니다.
동기화 옵션은 --help 참고: --ttl-days 7, --force, --from-cache, --max-services 100,
--max-programs 500(시험), --grace-days 30(마감 후 유지일), --include-expired,
--conditions-mode per-id --ids SMP-0001,..., --dry-run.
Related MCP server: startup-law-mcp
2. 두 트랙, 하나의 판정 규격
트랙 | 데이터 | 판정 근거 | 비고 |
| 정부24 보조금24( | JA 자격 코드(성별·연령·중위소득·생애·가구·직업) | 지자체 선정기준 공백은 원본 그대로 |
| 창업진흥원 K-Startup( | 공고의 구조화된 신청자격(업력·연령·지역·대상·성별·업종) | 모집 마감은 기본 숨김 |
개인 트랙 — 보조금24 JA 코드
묶음 | 코드 | 규칙 |
성별 |
| 한쪽만 켜져 있으면 그 성별만 대상 |
연령 |
| 0 이하 = 하한 없음, 100 이상(원천에 120) = 상한 없음 |
중위소득 |
| 켜진 구간 안에 사용자 구간이 있어야 함(구간끼리 OR) |
생애·직업 |
| 묶음 안은 OR |
가구 |
| 묶음 안은 OR, |
사업자 |
| 개인 사용자는 사업자 요건에서 갈림 |
묶음 사이는 AND 입니다(예: "임산부이면서 무주택"). 각 묶음의 해당사항없음 코드가 켜져 있으면 그 묶음은 누구나 통과합니다.
창업·기업 트랙 — 공고 신청자격
요소 | 읽는 방법 | 판정 |
업력 |
| 예비창업자는 업력 0년으로 통과, 운영 중이면 |
연령 |
| 만 나이 범위 |
대상 |
| 예비/운영 × 기업형태 |
지역 |
| 전국·시도·시군구 |
성별 | "여성 예비창업자"·"여성기업" | 여성/남성 제한 |
업종 | 원문에 업종 제한이 명시된 경우만 판정 조건 | 해시태그 업종은 검색·표시용 |
모집 |
| 마감 공고는 |
실호출로 확인한 함정: K-Startup 의
biz_enyy·biz_trgt_age는 단일 값이 아니라 허용하는 조건의 목록입니다(예비창업자,1년미만,…,10년미만). 그래서 여러 값이 오면 합집합(가장 넓은 쪽)으로 읽고, 단일 값일 때만 제한으로 판정합니다. 구조화 컬럼과 본문 문장이 다르면 더 좁은 쪽을 씁니다(놓치는 것보다 낫습니다).
4단계 판정
등급 | 뜻 |
| 공개된 조건을 모두 충족 |
| 조건은 맞지만 원본 선정기준 공백·자격 코드 없음·추첨·선착순·예산 소진·모집 마감 등 확인 필요 |
| 입력이 없어 가능/불가를 말하지 않음 — 무엇을 더 물어야 하는지 함께 반환 |
| 조건과 명확히 어긋남 — 어긋난 항목과 원문 기준 반환 |
일부러 이렇게 만든 것
모르면 모른다고 한다. 소득구간을 안 넣으면
insufficient_info이지, "아마 될 거예요"라고 하지 않습니다. 조건을 하나도 안 넣으면 판정하지 않습니다.지자체 공백을 메우지 않는다. 원본
선정기준이 비어 있으면check_needed+ "소관기관 확인" 문구. (실데이터에서 지자체 수천 건이 이 상태입니다.)자격 코드가 없으면 단정하지 않는다. 코드 없는 제도는
check_needed("원문 기준으로만 확인 가능")입니다.아동 제도의 연령은 아동 나이로.
age_subject: "child"이면 신청자 나이로 탈락시키지 않고children_years를 물어봅니다.지역은 소관기관명으로.
중구·서구처럼 여러 시도에 있는 이름은 찍지 않고local_unresolved/unknown으로 남깁니다(틀린 필터보다 정직한 미확인이 낫습니다).기업 트랙의 '가능성 높음'은 신청자격 충족이다. 모집형 사업이라 선정은 평가·경쟁으로 결정된다는 문구를 항상 함께 붙입니다.
기업마당 문구는 고치지 않는다. '출처표시·변경금지' 조건이라 HTML 태그만 걷어내고 원문 문구를 보존하며, 응답마다 출처를 붙입니다.
3. 툴 7종
툴 | 입력 | 출력 요점 |
|
| 후보 + 트랙·등급별 건수 + 사유 + |
|
| 단건 판정 + 어긋난 항목 + 누락 정보 |
|
| 선정기준 원문·구비서류·문의처·신청링크·출처(+판정) |
|
| 지역 제도 + 전국 제도 목록 |
|
| 마감 임박 캘린더(날짜별) + 날짜 미기재 건수 |
|
| 일자별 스냅샷 비교: 추가·삭제·기간/금액/대상/모집상태 변경 |
| — | 카탈로그·두 트랙·판정 등급·자격 코드·기업 조건·스냅샷·개인정보 설정 |
# 개인
curl -s localhost:8787/v1/tools/search_subsidies -H 'Content-Type: application/json' -d '{
"profile": {"track": "personal", "age": 34, "sex": "male",
"region": {"sido": "인천광역시", "sigungu": "서구"},
"income_band": "JA0203", "situations": ["no_home", "worker"]}
}'
# 창업·기업 (예비창업자)
curl -s localhost:8787/v1/tools/search_subsidies -H 'Content-Type: application/json' -d '{
"profile": {"track": "business", "age": 33, "sex": "male",
"region": {"sido": "인천광역시", "sigungu": "서구"},
"business": {"status": "pre", "entity": "pre_startup"}}
}'
# 마감 임박 30일 (두 트랙)
curl -s localhost:8787/v1/tools/deadline_calendar -d '{"days": 30}' -H 'Content-Type: application/json'
# 어제 → 오늘 카탈로그 변화
curl -s localhost:8787/v1/tools/compare_ledgers -d '{}' -H 'Content-Type: application/json'# MCP (JSON-RPC 2.0)
curl -s localhost:8787/mcp -H 'Content-Type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_service_meta","arguments":{}}
}'프로필 필드: track·age·birth_year·birth_date·sex·region{sido,sigungu}·household_size·
income_percent·income_band(JA0201~0205)·situations[]·children_years[]·
business{status(pre|operating), entity, years, industry}.
situations 를 빈 배열로 보내면 "해당 없음", 아예 빼면 "모름"으로 판정합니다.
business.status 만 넣어도 대부분 판정됩니다.
4. 일자별 스냅샷(변경 이력)
지원사업 공고는 기간·예산·자격이 조용히 바뀝니다. 그래서 동기화할 때마다
data/gov24/snapshots/{YYYY-MM-DD}.json 한 장과 snapshots/index.json 을 남깁니다.
스냅샷에는 비교용 필드만 저장합니다(이름·기관·분야·마감일·금액·대상·모집상태·지문).
fingerprint는 원문 전체를 정규화한 해시라 "바뀌었다/안 바뀌었다"가 한눈에 나옵니다.compare_ledgers는 두 장을 비교해 추가·삭제·변경(필드별 from→to) 을 돌려줍니다.같은 날 다시 돌리면 그날 스냅샷을 덮어쓰고, 비교 기준은 직전 날짜로 잡습니다.
K-Startup 은 2016년부터 3만 건이 오고 서버가 기간 필터를 적용하지 않습니다. 그래서 받은 뒤
programs.is_current()로 마감 30일 지난 공고를 빼고 저장합니다(--grace-days,--include-expired).
PYTHONPATH=src python -m subsidy_kr.sync_gov24 --sources all # 날마다 한 번
# → 오늘/어제 스냅샷이 쌓이면 compare_ledgers 가 변화를 알려 줍니다스냅샷은 날마다 한 장씩 쌓입니다(현재 약 9MB/일, 전량 12,429건 기준). 그래서
data/gov24/ 는 원본·캐시·스냅샷을 커밋하지 않습니다(.gitignore). 예외는 압축 카탈로그
data/gov24/catalog.json.gz 한 파일입니다 — 배포 환경이 샘플 대신 실데이터로 뜨게 하는
3.8MB 짜리 산출물입니다. data/gov24/cache/ 는 git·Docker 양쪽에서 제외됩니다
(.gitignore·.dockerignore).
동기화 뒤 압축본을 갱신하려면(원본은 그대로 두고 같은 내용을 gzip 으로):
python - <<'PY'
import gzip, pathlib
src = pathlib.Path("data/gov24/catalog.json")
dst = src.with_suffix(".json.gz")
with src.open("rb") as f, gzip.GzipFile(dst, "wb", compresslevel=9, mtime=0) as g:
g.write(f.read())
print(dst, dst.stat().st_size)
PY5. 구조
subsidy-kr/ (패키지 경로는 그대로, 서비스명은 GRNT)
├── Dockerfile · render.yaml · server.json 배포·레지스트리 정의
├── sync_gov24.py 편의 실행 파일
├── build/gen_regions.py 시군구 명부 생성(개발용)
├── data/gov24/ catalog.json.gz(배포용 커밋) · 원본 catalog.json·snapshots/(로컬 전용)
└── src/
├── subsidy_kr/
│ ├── engine.py 결정론 판정(개인 JA 코드 + 창업·기업 자격)
│ ├── catalog.py 레코드 정규화·색인·샘플/실데이터 전환
│ ├── conditions.py JA 코드 표·상황 태그
│ ├── programs.py K-Startup·기업마당 → 판정용 레코드(업력·연령·대상·업종)
│ ├── sample_data.py 내장 샘플 20건(개인)
│ ├── sample_programs.py 내장 샘플 12건(창업·소상공인·기업·기업마당 형식)
│ ├── gov24.py 15113968 클라이언트(키 마스킹·재시도)
│ ├── startup.py 15125364 K-Startup 클라이언트
│ ├── bizinfo.py 15157820 기업마당 클라이언트
│ ├── datagokr.py 공통 전송·키 마스킹·응답 봉투 해석
│ ├── sync_gov24.py 통합 동기화 CLI(+스냅샷)
│ ├── snapshots.py 일자별 스냅샷·변경 비교
│ ├── cache.py JSON 캐시(7일 TTL, 원자적 쓰기)
│ ├── store.py SQLite(스냅샷·익명 카운터)
│ ├── deadlines.py 신청기한 자유 텍스트 파서
│ ├── regions.py 시도·시군구 정규화, 소관기관명→지역
│ ├── api.py 툴 7종 정의
│ ├── mcp_http.py JSON-RPC 2.0
│ ├── mcp_stdio.py stdio 전송
│ ├── server.py HTTP 라우팅
│ ├── web_ui.py 인라인 CSS/JS 단일 페이지(두 트랙)
│ ├── pseo.py /s/ 주제·지역 페이지(thin content 규칙)
│ ├── static_files.py robots·llms·sitemap·server-card
│ └── usage.py 익명 일별 카운터
└── tests/ unittest 20개 파일 · 277건6. 데이터와 정직한 한계
데이터 | 식별자 | 이용 조건 |
행정안전부 대한민국 공공서비스(혜택) 정보 |
| 이용허락범위 제한 없음 |
창업진흥원 K-Startup 지원사업 공고 |
| 이용허락범위 제한 없음 |
중소벤처기업부 중소기업 지원사업 공고(기업마당) |
| 출처표시·변경금지 — 원문 문구 보존 + 출처 표시 |
개발계정 호출 한도는 데이터셋마다 10,000건/일입니다. K-Startup 은 전량 31페이지(1,000건/페이지)로 받습니다.
내장 샘플(
catalog_state: "sample")은 필드·코드 구조만 실제와 같고 금액·기한은 예시값입니다. 화면·API 응답이 항상data_state와 함께 이 사실을 밝힙니다.지자체 제도의
선정기준공백은 원본 그대로 둡니다. 이 서비스의 가치는 그 공백을 메우는 척하지 않는 것입니다.창업·기업 공고는 자격 요건이 서술형인 경우가 많습니다. 구조화하지 못한 요건은
check_needed로 남기고 원문을 안내합니다.신청 대행·법률 자문이 아니며, 최종 수급·선정 여부는 소관기관 심사로 결정됩니다.
신청기한은 자유 텍스트라, 확실히 읽히는 날짜만 구조화하고 나머지는
unknown으로 둡니다.
7. 개인정보
항목 | 처리 |
이름·주민등록번호·전화번호 | 받지 않음 |
나이·지역·소득구간·임신/장애 여부, 사업자 조건(업력·업종) | 요청 처리 중 메모리에서만 사용, 저장 안 함 |
쿠키·localStorage | 쓰지 않음 |
서버 로그 | 경로·상태코드만(질의문·본문 미기록) |
통계 | 날짜·경로·툴명·판정 등급·0건/오류 횟수만 |
스냅샷 | 제도 정보만(프로필·질의문 없음) |
외부 전송 | 없음(서버가 공공 API를 대신 호출하지 않음 — 동기화는 오프라인 배치) |
공고문 원문에 포함된 기관 담당자 이메일·전화는 공개된 기관 연락처로, 사용자 개인정보와 다릅니다.
src/·문서·설정에는 이메일·전화·실명을 쓰지 않으며 테스트가 이를 검사합니다.
다만 그 연락처가 담긴 동기화 산출물(data/gov24/)은 저장소·이미지에 넣지 않습니다.
8. 배포
docker build -t grnt . && docker run -p 8787:8787 grnt # 기본은 내장 샘플(32건)Render — render.yaml Blueprint 로 그대로 배포합니다(서비스명 grnt-kr → https://grnt-kr.onrender.com, Docker, free, singapore,
healthCheck /healthz). 서버는 공공 API 키가 필요 없고, .env 없이도 뜹니다.
항목 | 값 |
Runtime | Docker ( |
Health check |
|
환경변수(기본) |
|
환경변수(실데이터 동기화 시에만) |
|
배포 직후 첫 요청은 sleep 에서 깨어나 30~60초 걸릴 수 있고, /healthz 의 catalog_state 가
sample 이면 아직 실데이터가 없다는 뜻입니다. 실데이터는 Render Shell 에서
PYTHONPATH=/app/src python -m subsidy_kr.sync_gov24 --sources all 로 한 번 받습니다(무료 플랜은
영구 디스크가 없어 재배포 시 초기화됩니다 — 그때는 다시 동기화하거나 유료 디스크를 붙입니다).
server.json 의 name(io.github.CLNS-KR/grnt)·repository 는 실제 GitHub 소유자
(CLNS-KR/GRNT)에 맞춰 두었고, 공개 주소(websiteUrl·remotes)는 https://grnt-kr.onrender.com 입니다.
MCP Registry 는 그 주소의 /healthz 가 살아 있는 것을 확인한 뒤 v0.2.1 태그로 게시합니다.
9. 라이선스
MIT (아래 LICENSE). 공공데이터 자체의 이용 조건은 원 제공기관(행정안전부·창업진흥원·중소벤처기업부) 안내를 따릅니다.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Who qualifies for 10,956 Korean government benefits (보조금24). Plus public data and weather.
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.
Korean policy & finance facts with primary-source citations (laws, gov notices) for AI agents
Korean policy & finance facts with primary-source citations (laws, gov notices) for AI agents
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAnalyzes government support program announcements and business profiles to determine eligibility, identify missing information, detect risks, and generate application plans for small business owners.-
- FlicenseNot gradedqualityBmaintenanceIntegrates Korean startup laws (19 curated laws) and K-Startup support programs, enabling legal article search, citation verification, reference tracking, and program lookup with real-time status.1-
- AlicenseNot gradedqualityBmaintenanceEnables real-time verification of Korean business registration status and KYB identity checks using official Korea National Tax Service data.1MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to verify Korean ground-truth data through MCP and REST, including business registration, addresses, corporations, apartment trade prices, and statutes, metered with prepaid credits.-