Æfact — Korean fact desk for AI agents

언제부터 무엇이 바뀌나. 기간(from~to)·분야·검색어로 시행되는(또는 막 시행된) 한국 법령 변경을 찾습니다. 결과마다 시행일, 법령명, 바뀌는 문구, 개정이유 첫 문장(법제처 원문 그대로)이 있습니다. 자세한 원문은 get_change. EN: What Korean laws/regulations change between dates (effective dates from the Ministry of Government Legislation), with verbatim reasons and changed wording.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "시작일 YYYY-MM-DD (기본: 오늘)"
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "끝일 YYYY-MM-DD (기본: 30일 뒤)"
    },
    "topic": {
      "type": "string",
      "enum": [
        "work",
        "welfare",
        "money",
        "housing",
        "family",
        "safety",
        "env",
        "farm",
        "culture",
        "digital",
        "defense",
        "etc"
      ],
      "description": "분야(일·노동, 복지·건강, 세금·금융·경제, 주거·교통, 교육·가족, 안전·행정·사법, 환경·에너지, 농어업, 문화·관광, 과학·디지털, 국방·외교·보훈)"
    },
    "query": {
      "type": "string",
      "maxLength": 60,
      "description": "예: 전세, 근로자, 건강보험, 육아휴직"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15
    }
  },
  "additionalProperties": false
}

지금 나온 한국 정부·공공 소식을 한 목록으로: 정책브리핑 보도자료·정책뉴스, 국민참여입법센터 입법예고(조회수·의견수), 법제처 시행 법령, Æfact 검산. 같은 소식은 묶어 출처 수를 세고, 주목도(출처 안 상대 순위·여러 출처·AI 독자 수·시간 감쇠, 규칙 계산)·최신·AI가 많이 읽은 순·의견순으로 늘어놓습니다. 제목·원문 링크만 있고 본문은 없습니다. 판정이 아니며, 판정은 check_url 에 있습니다. EN: Trending Korean government/public announcements (press releases, policy news, legislative notices with views/opinions, laws taking effect), deduplicated across sources and ranked by a transparent rule-based score.

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "24h",
        "3d",
        "7d"
      ],
      "default": "3d",
      "description": "기간"
    },
    "sort": {
      "type": "string",
      "enum": [
        "hot",
        "new",
        "ai",
        "talk"
      ],
      "default": "hot",
      "description": "hot 주목도순 · new 최신순 · ai AI가 많이 읽은 순 · talk 입법예고 의견·조회순"
    },
    "source": {
      "type": "string",
      "enum": [
        "press",
        "policy_news",
        "lawmaking",
        "law",
        "aefact_check"
      ],
      "description": "출처 하나만(보도자료·정책뉴스·입법예고·시행 법령·Æfact 검산)"
    },
    "query": {
      "type": "string",
      "maxLength": 40,
      "description": "제목·기관에 들어간 낱말(예: 전세, 반도체)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15
    }
  },
  "additionalProperties": false
}

what_changes 결과의 id(chg-…)로 변경 카드 하나를 받습니다: 개정이유 전문, 바뀌는 문구 전체, 시행일 조항, 이날 시행되는 조문, 인용 한 줄(cite). EN: Full verbatim change card by id.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^chg-\\d{6}-\\d{8}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

한국에 관한 사실 문장 하나의 확인을 Æfact에 요청합니다. 법령 시행일·한국은행 기준금리·월별 소비자물가 상승률·문장 안 증감률·비율·합계는 바로 원자료로 판정해 공개 결과 주소(url)와 인용 한 줄(cite)을 돌려줍니다. 그 밖의 문장은 접수(status=queued)되어 수요로 집계됩니다. 결과는 공개됩니다(개인정보·정치·수사·재판·의료·연예 사생활 문장은 받지 않음). 같은 문장은 같은 결과를 돌려줍니다. EN: Submit a Korean factual claim for verification. Decidable claims (law effective dates, BOK base rate, monthly CPI, in-sentence arithmetic) are judged immediately against primary data and published at a public URL.

{
  "type": "object",
  "properties": {
    "claim": {
      "type": "string",
      "minLength": 8,
      "maxLength": 300,
      "description": "확인할 문장 하나(원문 그대로). 예: 근로기준법 개정안은 12월 8일부터 시행된다 / 9월 소비자물가 상승률은 2.9%다"
    },
    "source_url": {
      "type": "string",
      "maxLength": 300,
      "description": "선택: 문장이 나온 주소"
    },
    "context": {
      "type": "string",
      "maxLength": 300,
      "description": "선택: 맥락(누가·언제 한 말인지 등)"
    }
  },
  "required": [
    "claim"
  ],
  "additionalProperties": false
}

request_check 가 돌려준 id(rq_…)로 요청 상태와 결과를 다시 봅니다. EN: Get a verification request's status/result by id.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^rq_[A-Za-z0-9_-]{8}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

질문에 나온 대상(법령·기관)과 지금 참인 사실을 한 번에 찾습니다. 처음엔 이 도구를 쓰세요. 띄어쓰기·가운뎃점은 무시합니다. 사실마다 freshness(낡음 여부)와 cite(답변에 붙일 인용 한 줄)가 있습니다. EN: One-call lookup of Korean entities (laws, agencies) and current verified facts (economic indicators, law effective dates). Each fact has freshness and a ready-to-paste citation.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "예: 기준금리, 원달러 환율, 개인정보보호법, 국토교통부"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 8
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

법령·기관 같은 대상을 이름으로 찾습니다. 현행 법령 전체와 소관부처, 한국은행이 있습니다. 결과의 id로 get_entity를 부르면 그 대상의 현재 사실과 연결(상위법·하위법·소관부처)을 받습니다.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "대상 이름이나 약칭. 공백으로 나눈 낱말이 모두 들어간 것만 돌려줍니다."
    },
    "type": {
      "type": "string",
      "enum": [
        "law",
        "org"
      ],
      "description": "law(법령) 또는 org(기관)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false
}

대상 하나의 속성(근거 출처 포함), 현재 사실, 연결된 대상을 줍니다. 법령이면 상위법·하위법(시행령·시행규칙)·소관부처, 기관이면 소관 법령 목록입니다. 연결은 원자료(법제처 법령 체계도·법령 목록)에서 확인된 것만 있습니다.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "description": "대상 id. 예: law-011357, org-1790365, org-bok"
    },
    "relation_limit": {
      "type": "integer",
      "minimum": 0,
      "maximum": 500,
      "default": 50,
      "description": "돌려줄 연결 수 상한"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

지금 참인 사실(상태)을 찾습니다. 기준금리·환율·소비자물가지수 같은 경제지표, 시행 예정 법령, 현행 법령 버전(법령마다 1건)이 있습니다. 결과마다 현재 값, 언제부터 참인지(valid_from), 문장, id가 있습니다. 자세한 이력은 get_fact로 보세요.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "찾을 말. 공백으로 나눈 낱말이 모두 들어간 사실만 돌려줍니다. 비우면 전체."
    },
    "category": {
      "type": "string",
      "enum": [
        "economy",
        "law",
        "companies"
      ],
      "description": "economy(경제지표), law(제도·법령), companies(기업·공시)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    }
  },
  "additionalProperties": false
}

사실 하나의 현재 버전과 이력을 줍니다. as_of(YYYY-MM-DD)를 주면 그날 참이던 버전을 줍니다. 버전마다 valid_from, valid_until, superseded_by, 근거(원자료 값)가 있습니다.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "description": "사실 id. 예: kr-bok-base-rate. search_facts 결과의 id"
    },
    "as_of": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "이 날짜에 참이던 버전을 원할 때(YYYY-MM-DD)"
    },
    "history_limit": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "default": 20,
      "description": "함께 돌려줄 과거 버전 수"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

기사를 찾습니다. 기사는 사실의 값이 바뀐 시점의 기록입니다. 지금 값이 필요하면 search_facts를 쓰세요.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "찾을 말. 비우면 최신순 전체."
    },
    "category": {
      "type": "string",
      "enum": [
        "economy",
        "law",
        "companies"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false
}

기사 전문과 문장별 판정을 줍니다. 각 판정의 fact_status.is_current가 false면 그 문장은 이후 바뀐 사실이므로 현재 사실로 인용하지 마세요.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 120,
      "description": "기사 slug. search_articles 결과의 slug"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

다루는 분야, 분야별 건수, 다루지 않는 분야, 판정 어휘의 뜻을 줍니다.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}