공공기관을 이름·유형·주무부처로 검색합니다. org_code는 다른 도구의 진입점입니다.

기관코드(instCd)로 기본 프로필을 조회합니다.

include_detail=True면 일반현황 상세(설립목적·주요기능·경영목표·기관장 등)를 포함합니다.

공시지표 카테고리 목록을 조회합니다 (staff·salary·finance·welfare 등 11종).

get_institution_metrics / compare_institutions의 category 파라미터로 사용합니다.

ALIO 경영공시 50개 항목 카탈로그를 조회합니다 (정기/수시·공시주기·분류).

출처: alio.go.kr 경영공시 제도(공운법 제12조). "재무 공시는 언제 올라와?", "수시공시 항목만", "2분기 정기공시 목록" 같은 질문에 사용하세요.

disclosure_type: '정기' 또는 '수시'. schedule: 공시시기 부분일치 (예: '1분기', '매분기'). metric_category: 특정 지표(staff·finance 등)에 매핑된 공시항목만. only_with_metric=True면 본 MCP 지표로 조회 가능한 항목만 반환합니다.

카테고리 내 지표 항목명을 조회합니다.

예: category='staff', item_query='정원' → 정원 관련 항목명 목록. org_code를 주면 해당 기관이 보유한 항목만 반환합니다.

기관의 공시지표 시계열을 조회합니다. (설계서 §4-1 ②)

category: staff(임직원수)·salary(평균보수)·executive_pay(임원연봉)·recruitment(신규채용)· budget(수입지출)·welfare(복리후생비)·work_life(일가정양립)·welfare_etc·tax(법인세)· head_expense(기관장업무추진비)·finance(재무 — 결산은 전 기관, 반기 항목은 공기업 계열 한정). item_query로 항목을 좁힐 수 있습니다. 예: '정원', '현원', '부채', '기본급'. staff(인력) 조회 시: '임직원 총계'·'정원-계'는 정원, '현원-전일제'가 실제 재직 인원. 인력현황 요약은 get_institution_staff_summary 권장.

기관 인력현황 요약 — 정원(authorized) vs 현원(actual)을 구분해 반환합니다.

'○○기관 인력 몇 명?'·'정원 현원' 질의에 사용. 임직원 총계(A+B+C)는 정원이므로 headcount.estimated_total(정규 전일제+기간제)을 실제 재직 규모로 참고하세요.

2~5개 기관을 동일 지표로 비교합니다. (설계서 §4-1 ③)

org_codes: search_institutions로 얻은 instCd 목록 (2~5개). item_query로 비교 항목을 좁히면 응답이 가벼워집니다. 예: '부채', '정원', '기본급'.

조건 기반 기관 스크리닝 — 지표 상·하위, 증감률 상위 기관을 찾습니다. (설계서 §4-1 ④)

mode: top_n(최신값 상위)·bottom_n(하위)·growth_rate(기간 증감률 % 상위). item_query는 정렬 기준 항목 (예: category='staff', item_query='정원' 또는 '현원-전일제'). staff에서 item_query='정원'은 정원 기준, 실제 재직 인원 비교는 '현원-전일제' 사용. org_type·ministry로 대상 기관을 좁힐 수 있습니다 (예: org_type='공기업'). exclude_subsidiaries=True면 부설기관 공시 단위를 제외합니다. use_classification_org_type=True이고 org_type을 지정하면 부설기관은 모기관 유형으로 필터합니다. 결과는 단순 정렬이며 기관 평가·판단의 근거가 아닙니다.

기관코드로 지점 목록을 조회합니다 (/brnch).

공공기관의 국가사업·대민 편의사업(서비스)을 검색합니다. org_code는 instCd입니다.

공공기관이 개방·관리하는 시설을 검색합니다. org_code는 search_institutions 결과의 org_code(instCd)입니다.

query는 시설명·기관명·이용방법·주소를 통합 검색합니다 (예: '회의', '네이버 예약'). reservable_only=True면 예약 가능(rsvtPsbltyYn=Y) 시설만 반환합니다. 결과의 has_more=True면 page를 올려 다음 페이지를 조회하세요.

시설 일련번호(sn/fcltSn)로 상세정보와 첨부파일 메타를 조회합니다.

공공기관 채용공고를 검색합니다. org_code는 pblntInstCd(instCd)입니다.

query에 기관명·별칭('한전')을 넣으면 자동으로 해당 기관 공고로 해석합니다. 필터: region(근무지역명, 예 '대구'), ncs(직무분류명, 예 '정보통신'), hire_type(고용형태명, 예 '청년인턴'), recruit_type('신입'·'경력' — '신입'은 신입+경력 포함), education(학력, 예 '고졸'·'학력무관'), pref(우대조건 키워드, 예 '지역인재'). closing_within_days>0이면 마감 N일 이내 공고만(D-day 기준). sort: 'latest'(기본)·'deadline'(마감임박순)·'headcount'(모집인원 많은순). 취소 표기 공고는 기본 제외(include_cancelled=True로 포함). use_snapshot=True면 로컬 스냅샷(data/snapshots)에서 조회 — API 한도·속도 회피.

[연구·정책용] 진행중 채용공고의 분포를 집계합니다.

dimension: region(지역)·ncs(직무)·hire_type(고용형태)·recruit_type(신입/경력)· education(학력)·org(기관). 차원별 '공고 수'와 '모집인원 합계'를 반환합니다. use_snapshot=True(기본)면 로컬 스냅샷 사용 — 없으면 라이브 전수 수집(API 다수 호출). region·ncs·hire_type·pref로 모집단을 좁힌 뒤 분포를 낼 수 있습니다.

채용공시 일련번호(sn/recrutPblntSn)로 상세·전형단계·첨부파일을 조회합니다.

공공기관 관련 최근 뉴스를 네이버 뉴스 API로 검색합니다.

org_code(instCd)를 주면 공식 기관명 + 안전한 별칭(한전·KEPCO 등)으로 OR 검색합니다. org_code 없이 query만 주면 별칭을 공식명으로 치환해 검색합니다 (예: '심평원'). days>0이면 최근 N일 기사만 반환 (네이버 API는 기간 파라미터가 없어 발행일 기준 필터). sort: 'date'(최신순, 기본)·'sim'(정확도순). max_fetch: 기간 필터 전 수집할 최대 기사 수(100~1000). 보도량 많은 기관의 '한 달 전체' 커버리지를 위해 페이지네이션으로 모읍니다. 클수록 호출 수 증가.

기관 360° 원샷 브리핑 — 프로필·핵심지표 추세·최근 뉴스·진행중 채용을 한 번에 종합합니다.

org_code 또는 query(기관명·별칭, 예 '한전')로 기관을 지정합니다. 프로필(설립목적·기관장·부처) + 정원/보수/부채비율 추세 + 최근 N일 뉴스 헤드라인 + 진행중 채용 건수를 묶어 반환합니다. "○○기관 한눈에 브리핑해줘"에 사용하세요.

뉴스 주장을 공시 지표로 교차검증합니다 — '뉴스에서 빚 많다는데 실제 부채는?'.

topic을 지표 카테고리로 매핑(부채/재무→finance, 정원/인력→staff, 보수→salary, 채용→recruitment, 복지→welfare, 예산→budget 등)해 해당 시계열과, topic 키워드로 필터한 관련 뉴스를 함께 반환합니다. org_code 또는 query로 기관을 지정하세요.

기관 뉴스를 테마별로 자동 분류·집계합니다 — 보도량 많은 기관의 이슈를 구조화.

평면적인 기사 목록 대신 테마(재무·실적/채용·인사/안전·재해/감사·비위/사업·협약/ 정책·국회/사회공헌·ESG/기타)별 건수와 대표 헤드라인, 날짜별 타임라인을 반환합니다. "캠코 한 달 이슈를 정리해줘"처럼 분포 파악에 사용하세요.

법령(법률·대통령령·부령 등)을 키워드로 검색합니다 — 국가법령정보센터.

공공기관 관련 질의는 리소스 alio://related-laws의 화이트리스트(공운법 등 핵심 법령 공식 명칭)를 먼저 참조해 정확한 법령명으로 검색하세요. 복합 키워드는 0건이 나올 수 있으니 핵심 단어 하나로 검색 후 결과에서 고르세요. scope: 1=법령명 검색, 2=본문 검색. 결과의 'mst'(법령일련번호)를 get_law_text에 넘기면 조문을 조회합니다.

법령의 조문을 조회합니다 — search_laws 결과의 'mst'(법령일련번호) 필요.

article을 지정하면(예: '4', '4의2') 해당 조문 전문만 반환합니다. article 없이 호출하면 기본정보+조문 목차(번호·제목)만 반환하므로, 먼저 목차에서 필요한 조문을 찾아 article로 재조회하세요. 전 조문 전문이 꼭 필요할 때만 full_text=True를 쓰세요(대형 법령은 매우 깁니다).

행정규칙(훈령·예규·고시·지침)을 키워드로 검색합니다 — 국가법령정보센터.

「공기업·준정부기관의 경영에 관한 지침」 등 기재부 공공기관 지침류는 행정규칙으로 등재돼 있습니다(리소스 alio://related-laws의 admin_rules 참조). 여기서 0건이면 연도별 시달 지침(예산운용지침 등)일 수 있으니 search_guidelines(로컬 지침)를 확인하세요. 결과의 'id'를 get_admin_rule_text에 넘기면 본문을 조회합니다.

행정규칙(훈령·예규·고시·지침)의 본문을 조회합니다 — search_admin_rules 결과의 'id' 필요.

경영평가편람 본문을 키워드로 검색합니다.

예: '중대재해', '총인건비', '안전관리등급', '혁신가점'. part: '경영실적'·'기관장_경영계약'·'상임감사'·'기관별_별첨' 등으로 범위 축소. year: 2025·2026 등 — 미지정 시 적재된 모든 연도 검색.

편람에 정의된 기관 유형(공기업 SOC·에너지, 준정부 기금관리형 등) 목록.

유형별 평가지표·배점(계·비계량·계량) 표를 조회합니다.

org_class: '공기업'·'준정부기관' 등. org_subtype: 'SOC'·'에너지'·'기금관리형' 등. list_evaluation_org_types로 유형 목록을 먼저 확인할 수 있습니다.

평가지표명으로 세부평가내용·배점·지표정의를 조회합니다.

예: '안전 및 재난관리', '총인건비관리', '윤리경영'.

두 연도 편람(예: 2025 수정 vs 2026)에서 동일 키워드 검색 — 변경 추적 보조.

로컬에 적재된 지침(예산운용지침 등 law.go.kr 미등재 시달 지침)을 조문 단위로 검색합니다.

공백으로 구분한 여러 키워드는 AND 조건입니다 (예: '총인건비 인상률'). 연도별 지침은 year로 구분하세요. 적재 목록은 리소스 alio://guideline-index 참조. 상시 지침(경영지침·혁신지침 등)은 search_admin_rules(law.go.kr)가 우선입니다.

적재된 지침의 조문을 조회합니다 — search_guidelines 결과의 'doc_id' 필요.

article 지정 시(예: '5', '5의2') 해당 조문 전문, 미지정 시 목차(조문 번호·제목)를 반환합니다.

서버 상태 점검 — API 키·로컬 데이터 적재 현황. 데모 전 점검용.