대한민국 중앙행정기관 약 50곳의 보도자료·정책·법령·통계·정보공개·자주묻는질문·고시공고를 한 번에 검색한다(약 9만 건 색인).

부처 이름을 몰라도 자연어로 검색된다. 하이브리드(키워드+의미) 검색이 기본.

Args:

• query (string, 선택): 검색어. 비우면 필터 조건만으로 최신 문서를 훑는다. 짧고 일반적인 명사구가 잘 맞는다(예: "청년 월세", "반도체 특별법").

• doc_type (string[], 선택): press_release | policy | law | statistic | info_disclosure | faq | notice

• ministry (string[], 선택): 기관코드(예: MSS=중소벤처기업부, MOLIT=국토교통부). 코드는 onegov_list_ministries 로 확인.

• category (string[], 선택): 콘텐츠 분류. 지원사업은 "grant".

• region (string[], 선택): 지역명(예: "서울특별시", "경기도", "전국").

• law_ref (string[], 선택): 관련 법령명 정확일치(예: "중소기업창업 지원법").

• from / to (YYYY-MM-DD, 선택): 발행일 범위.

• sort ('relevance'|'date_desc'|'date_asc', 기본 relevance): 정확도순 / 최신순 / 오래된순.

• mode ('hybrid'|'fulltext'|'semantic', 기본 hybrid): 검색 방식.

• page (number, 기본 1) / size (number, 1~50, 기본 20): 페이지네이션.

• include_facets (boolean, 기본 true): 결과 분포(문서유형·기관·연도·지역·법령) 요약 포함 여부.

• response_format ('markdown'|'json', 기본 markdown)

Returns: markdown: 총 건수 + 결과별 제목/유형/기관/발행일/문서 id/원문 링크/요약, 그리고 패싯 요약. json: { query, page, size, total, results[], facets{}, meta{} } — results[i]에 id, doc_type, title, summary, ministry_code, ministry_name, published_at, source_url, kogl_type, law_ref[], region, attachments[], score 포함.

Examples:

• "작년에 나온 청년 주거 지원 정책" → query="청년 주거 지원", from="2025-01-01", to="2025-12-31"

• "중기부가 낸 창업 공고만" → query="창업", ministry=["MSS"], doc_type=["notice"]

• "개인정보보호 관련 법령 최신순" → query="개인정보", doc_type=["law"], sort="date_desc"

• 쓰지 말 것: 문서 전문이 필요할 때(→ onegov_get_document), 마감임박 지원사업 목록(→ onegov_deadline_grants)

Errors:

• 잘못된 doc_type/sort 값은 어떤 필드가 틀렸는지 알려준다.

• 429는 레이트리밋이므로 잠시 후 재시도.

문서 id로 전문(본문)과 첨부·관련법령·연관문서를 가져온다. id는 onegov_search 결과의 id 필드(UUID)다.

Args:

• id (string, 필수): 문서 UUID.

• max_body_chars (number, 기본 8000, 최대 40000): 본문 최대 길이. 길면 잘리고 안내가 붙는다.

• response_format ('markdown'|'json', 기본 markdown)

Returns: markdown: 제목 · 메타(기관/발행일/원문링크/공공누리 유형/관련법령) · 본문 · 첨부 · 연관 문서. json: { id, doc_type, title, summary, body, ministry_name, published_at, source_url, kogl_type, kogl_notice, attachments[], law_ref[], region, links{related_by_law[], same_ministry_recent[]} }

Examples:

• 검색 후 "이 공고 신청 자격 알려줘" → 해당 결과의 id로 호출

• 쓰지 말 것: 아직 문서를 특정하지 못했을 때(→ onegov_search 먼저)

입력한 앞글자로 시작하는, 실제 색인에 존재하는 검색어를 돌려준다. 검색 결과가 0건일 때 정확한 용어를 찾는 용도로 먼저 쓰면 좋다.

Args:

• prefix (string, 필수): 앞글자(예: "청년", "반도체").

• response_format ('markdown'|'json', 기본 markdown)

Returns: { suggestions: [{ text, doc_type }] }

Examples:

• "청년" → 청년도약계좌, 청년월세지원, 청년기본법 …

• 쓰지 말 것: 실제 문서를 찾을 때(→ onegov_search)

색인된 중앙행정기관 목록과 각 기관의 보유 문서 수를 돌려준다. onegov_search 의 ministry 필터에 넣을 코드를 여기서 얻는다.

Args:

• name_contains (string, 선택): 기관명에 포함된 글자로 필터(예: "고용", "국토").

• response_format ('markdown'|'json', 기본 markdown)

Returns: { ministries: [{ ministry_code, name, org_type, parent_code, doc_count }] } 참고: "_AGGREGATE"는 특정 부처가 아니라 K-Startup 등 집계 포털에서 모은 전 기관 공통 자료다(가장 문서가 많다).

Examples:

• "국토교통부 코드가 뭐야" → name_contains="국토" → MOLIT

• "어느 부처 자료가 제일 많아" → 전체 조회

공개자료 제목에서 자주 등장하는 상위 키워드와 등장 횟수를 돌려준다. "요즘 정부가 뭘 많이 하나"를 훑거나 검색어 후보를 잡을 때 쓴다.

Args:

• limit (number, 1~100, 기본 30)

• response_format ('markdown'|'json', 기본 markdown)

Returns: { keywords: [{ text, count, weight }] }

접수 마감이 임박한 정부 지원사업·공고를 마감일 순으로 돌려준다. 창업·중소기업·소상공인 지원사업 탐색의 출발점.

Args:

• max_dday (number, 0~60, 선택): D-day 상한. 예: 7 이면 일주일 안에 마감하는 것만.

• org_contains (string, 선택): 기관명 부분 문자열 필터(예: "중소벤처기업부", "조달청").

• limit (number, 1~100, 기본 30)

• response_format ('markdown'|'json', 기본 markdown)

Returns: { grants: [{ id, title, org, ministry_name, deadline_at, dday, support_field, apply_target, region, startup_years, source_url, kogl_type }] } dday=0 은 오늘 마감이라는 뜻이다.

Examples:

• "이번 주 마감인 지원사업" → max_dday=7

• "중기부 지원사업 마감 임박" → org_contains="중소벤처기업부"

• 조건에 맞는 게 없으면 onegov_find_support_programs 로 넓게 검색할 것.

지원사업(category=grant) 과 고시·공고(doc_type=notice) 로 범위를 미리 좁혀 검색하는 편의 도구. "창업 지원금", "소상공인 지원사업" 같은 요청에 바로 쓴다.

onegov_search 에 category=["grant"] 를 매번 넣는 것과 같지만, 필요한 필터만 노출해 실수를 줄인다.

Args:

• query (string, 필수): 무엇에 대한 지원사업인지(예: "청년 창업", "수출", "AI").

• region (string[], 선택): 지역명(예: ["서울특별시"]). 전국 사업은 "전국".

• ministry (string[], 선택): 기관코드.

• from / to (YYYY-MM-DD, 선택): 공고 발행일 범위.

• include_notices (boolean, 기본 true): 지원사업 분류가 안 붙은 일반 고시·공고까지 함께 볼지 여부.

• sort ('relevance'|'date_desc'|'date_asc', 기본 date_desc): 기본은 최신순.

• page / size / response_format: onegov_search 와 동일.

Returns: onegov_search 와 동일한 형식.

Examples:

• "요즘 나온 청년 창업 지원사업" → query="청년 창업"

• "경기도 소상공인 지원" → query="소상공인", region=["경기도"]

• 마감일 기준으로 급한 것부터 보려면 onegov_deadline_grants 를 먼저 쓸 것.

한 부처(또는 여러 부처)의 최신 공개자료를 발행일 역순으로 가져온다. "국토부 요즘 뭐 냈어?" 같은 질문에 쓴다.

Args:

• ministry (string[], 필수): 기관코드 배열(예: ["MOLIT"]). 코드는 onegov_list_ministries 로 확인.

• doc_type (string[], 선택): 특정 유형만(예: ["press_release"]).

• query (string, 선택): 부처 내에서 다시 좁힐 검색어.

• days (number, 1~365, 선택): 최근 N일로 제한. 지정하면 from 을 자동 계산한다.

• size (number, 1~50, 기본 20) / page (number, 기본 1)

• response_format ('markdown'|'json', 기본 markdown)

Returns: onegov_search 와 동일한 형식(항상 최신순 정렬).

Examples:

• "국토부 최근 보도자료" → ministry=["MOLIT"], doc_type=["press_release"], days=30

• "중기부가 이번 달 낸 공고" → ministry=["MSS"], doc_type=["notice"], days=30

한 주제에 대해 검색을 돌린 뒤, 상위 문서 몇 건의 본문까지 자동으로 받아와 한 번에 돌려준다. "이 주제 정부 자료 정리해줘" 같은 요청에서 검색→전문조회 왕복을 줄여 준다.

Args:

• query (string, 필수): 조사할 주제.

• depth (number, 1~5, 기본 3): 본문까지 받아올 상위 문서 수. 많을수록 느리고 응답이 길다.

• doc_type (string[], 선택) / ministry (string[], 선택) / from / to: onegov_search 와 동일한 필터.

• chars_per_doc (number, 1000~10000, 기본 3000): 문서당 본문 길이 상한.

• response_format ('markdown'|'json', 기본 markdown)

Returns: markdown: 검색 요약(총 건수·상위 목록) + 상위 depth 건의 본문 발췌(기관·발행일·원문링크 포함). json: { query, total, candidates[], documents[] }

Examples:

• "AI 기본법 관련 정부 자료 정리해줘" → query="인공지능 기본법", depth=3

• 단순히 목록만 필요하면 onegov_search 를 쓸 것(더 빠르다).

ChatGPT 커넥터/딥리서치 규격에 맞춘 검색 도구. 대한민국 정부 공개자료를 검색해 {id, title, url} 목록을 돌려준다. 일반적인 MCP 클라이언트에서는 필터가 풍부한 onegov_search 를 쓰는 편이 낫다.

Args: query (string, 필수) Returns: { results: [{ id, title, url }] } 를 JSON 문자열로.

ChatGPT 커넥터/딥리서치 규격에 맞춘 문서 조회 도구. search 가 돌려준 id로 전문을 가져온다.

Args: id (string, 필수) Returns: { id, title, text, url, metadata } 를 JSON 문자열로.