Korean Notice (공고) Checklist

korean-notice-mcp

한국어 | 英語

昨年と今年の公募要項を入力すると、申請条件や準備書類の変更点を、原文の根拠とともに知らせる MCP サーバーです。

韓国の地方自治体・公共機関の募集要項（HWP、HWPX）を、Claude Desktop などの AI アプリで直接読み取れます。すべての結果に原文の位置とドキュメントハッシュが付くため、人が原文と照合できます。

「今年と昨年の青年サークルの公募要項を比較して、申請条件の変更点と準備する書類を根拠とともに教えて。」

上の画面は、実際に公開された公募要項（長水郡の青年サークル、2025 HWP → 2026 HWPX）を比較した出力をそのまま録画したものです。1位は「固有番号証または事業者登録証」が必須から条件付きに変わったこと、2位は申請期間、3位は申請年齢の下限が15歳から満18歳に引き上げられたことです。各項目の根拠位置を get_evidence に渡すと、該当する原文を再確認できます。

公式 MCP レジストリに io.github.RosieOh/korean-notice-mcp として登録されています。

すぐに使ってみる

Node.js 22 以上が必要です。

# 가진 공고 두 개를 바로 비교
npx -y korean-notice-mcp compare 2025-공고.hwp 2026-공고.hwpx

# 공고 하나의 제출서류·신청기간만 보기
npx -y korean-notice-mcp checklist 2026-공고.hwpx

# 합성 예시로 MCP 도구 응답(JSON) 확인
npx -y korean-notice-mcp --demo

Claude Desktop に接続する

claude_desktop_config.json に追加します。MCP_DATA_DIR には、公募要項ファイルを集めておくフォルダーの絶対パスを指定してください。サーバーはこのフォルダー内のファイルのみを読み取ります。

{
  "mcpServers": {
    "korean-notice": {
      "command": "npx",
      "args": ["-y", "korean-notice-mcp"],
      "env": { "MCP_DATA_DIR": "C:\\Users\\me\\Documents\\공고" }
    }
  }
}

接続後、フォルダーに 2025-공고.hwp、2026-공고.hwpx を入れ、AI に2つのファイルを比較するよう依頼します。

ツール

ツール	内容
extract_requirements	提出書類（必須／条件付きと条件の記述）、申請期間、資格に関する段落の候補を根拠位置とともに抽出
compare_notices	2つの公募要項を比較。書類の追加・削除・必須／条件付きの変更と申請期間の変更を先に示し、その他の文言・表の変更を重要度順に表示。年だけが変わった文言は date_only_changes に分離
read_notice	本文と表（行・列・結合）を原文の位置・ハッシュとともに読み取り
get_evidence	同じハッシュのドキュメントから、根拠位置の原文を再確認

対応形式は HWP、HWPX、TXT、MD、CSV です。PDF とスキャン画像（OCR）にはまだ対応していません。すべてのツールは読み取り専用で、外部ネットワークには接続しません。

精度について

長水郡が公開した5事業の2025・2026年の公募要項10件（HWP 9件、HWPX 1件）で評価しました。ルールの調整には3組のみを使い、残りの2組は保留して評価しました。方法と全結果は benchmarks/README.md にあります。

	従来方式	このバージョン
提出書類の再現率／適合率（全体）	66% / 7%	92% / 84%
申請期間の的中	0/10	10/10
重要な変更34件のうち、結果の上位15件以内に含まれた数	4	24
ユーザーが確認する変更項目数	1,779	403

まず、知っておくべき制限事項があります。

• 保留セットを初めて評価したとき、書類の再現率は43%でした。 初めて見る表の形式が1つあったため、あるドキュメントの書類を丸ごと見落としました。原因を修正した後は86%になりましたが、この数値はブラインド評価の結果ではありません。
• 別の地方自治体（群山・龍仁・大田）の3組を使って、改めてブラインド評価した結果：書類の適合率は90%を維持しましたが、再現率は47%にとどまりました。群山の公募要項では、見出しの表記（「申請書類（…）」「申請受付：」）を認識できず、書類と申請期間をまったく見つけられませんでした。初めて見る形式に弱いことが、現在の最大の制限です。詳しくは評価ドキュメントをご覧ください。
• 正解表は、AI が原文と照合して作成したドラフトであり、人が独立して確認していません。サンプルも1つの地方自治体の公募要項のみです。
• ルールベースのため、「必要書類の取得方法」のような参考表を提出書類として読み取ったり、提出書類のセクション外に記載された書類を見落としたりする場合があります。
• 変更の法的な意味や申請資格を判定するものではありません。申請前に、必ず原文の公募要項と担当部署に確認してください。

仕組み

1. 読み取り：HWP は rhwp（MIT）で読み取ります。rhwp の表 API を使って、セルの行・列・結合構造を復元し、「提出書類 | 内容 | 発行先」のような表で、書類の列と説明の列を区別します。HWPX は独自の XML パーサーで読み取ります。
2. 抽出：「提出書類」「（受付期間）」「□ 申請対象」のような公募要項の見出し表記でセクションを分けます。その中から、番号付き項目、括弧付きリスト、「※ … の場合 … 提出」のような注記から書類を見つけます。「該当者」「いずれか1つ」「～の場合」のような表現から、条件付きかどうかを判断します。
3. 比較：行単位で比較した後、年だけが変わった文言は分離し、同じ表のセルの変更は1つにまとめます。セクション（資格・書類・期間・金額）と数値・キーワードの変化に基づいて重要度を付けます。

根拠位置は2種類あります。HWP は rhwp/scanN（rhwp のスキャン順）で、同じエンジンバージョンかつ同じドキュメントハッシュの場合にのみ再現できます。HWPX は section0/paragraphN のような XML 構造上の位置です。

評価の再現

公募要項の原文はリポジトリに含めていません。以下のコマンドは公開元から原文をダウンロードし、SHA-256 を照合してから評価します。

git clone https://github.com/RosieOh/korean-notice-mcp && cd korean-notice-mcp
npm install
npm run fetch-corpus   # data/raw/에 공고 10건 저장, 해시가 다르면 중단
npm run evaluate
npm test

비슷한 프로젝트와의 차이

HWP를 AI에서 읽는 도구는 이미 좋은 것이 많습니다. 이 프로젝트는 그 위에서 공고 한 종류를 깊게 다룹니다.

프로젝트	잘하는 것	이 프로젝트와의 관계
kordoc	HWP·HWPX·PDF·DOCX 파싱, 서식 채우기, 문서 비교(신구대조표) MCP	범용 문서 파서·비교. 공고의 필수/조건부 서류, 신청기간, 변경 중요도 같은 의미 단위는 다루지 않음. PDF 공고는 kordoc 쪽이 적합
rhwp	HWP/HWPX 뷰어·편집기(Rust+WASM), 내장 MCP 서버	이 프로젝트의 HWP 파싱 엔진(@rhwp/core)
treesoop/hwp-mcp	rhwp 기반 HWP 읽기·쓰기·변환 MCP	범용 HWP 도구. 공고 해석 기능은 없음
나라장터·공공데이터포털 MCP 서버들	공고·입찰 검색(API)	첨부 HWP는 읽지 않음. "검색 → 첨부 내려받기 → 이 서버로 분석"으로 함께 쓰기 좋음

이 프로젝트만의 부분은 세 가지입니다.

• 공고 전용 추출: 제출서류(필수/조건부와 조건 문구)와 신청기간을 뽑습니다.
• 전년 대비 변경: 연도만 바뀐 문구는 따로 분리하고, 나머지 변경을 중요도 순으로 정렬합니다.
• 공개 평가: 실제 공고와 정답표로 만든 평가 세트를 함께 공개합니다.

기여

다른 지자체 공고 쌍과 정답표, 특히 사람이 검수한 정답표를 가장 환영합니다. 개인정보가 들어간 실제 신청 서류는 이슈에 첨부하지 마세요. SECURITY.md를 참고하세요.

라이선스와 고지

• 코드: MIT 라이선스입니다. HWP 파싱에는 @rhwp/core(MIT, Edward Kim)를 사용합니다.
• 공고 인용 부분은 MIT 대상이 아닙니다. benchmarks/의 정답표·평가 결과와 데모 이미지에는 장수군청 공개 공고의 일부 문구가 연구·평가 목적으로 인용되어 있습니다. 이 인용 부분의 권리는 원 저작자에게 있습니다. 원 게시물에는 공공누리 제4유형(출처표시, 상업적 이용금지, 변경금지)이 표시되어 있습니다. 출처는 benchmarks/sources.json에 있습니다. 공고 원문 파일은 이 저장소와 npm 패키지에 포함하지 않습니다.
• 상표: "한글", "한컴", "HWP", "HWPX"는 주식회사 한글과컴퓨터의 등록 상표입니다. 이 프로젝트는 한글과컴퓨터와 제휴·후원·승인 관계가 없는 독립 오픈소스 프로젝트입니다.
• 책임 한계: 이 도구의 결과는 검토용 후보입니다. 신청 자격이나 제출 의무를 확정하지 않으며, 결과를 근거로 한 판단의 책임은 사용자에게 있습니다.