Korean Notice (공고) Checklist

Name: Korean Notice (공고) Checklist
Author: RosieOh

本地服务

github.com/RosieOh法律与政务05 周前更新

代码仓库

关于 Korean Notice (공고) Checklist

Korean Notice (공고) Checklist 是用于提取和比较韩国公共公告要求的 MCP 服务，支持 HWP 和 HWPX 文件。它标示资格、所需材料和申请期限的变化，并提供原文位置及文档哈希以供核验。

主要功能

01读取 HWP、HWPX、TXT、MD 和 CSV
02提取材料、期限和资格要求
03按重要程度比较公告变化
04返回原文位置和文档哈希
05重新核对引用的原文

适用场景

01比较今年与去年的公告
02识别必交和有条件提交的材料
03检查申请期限和资格变化
04根据原公告核验分析结果

MCP 相关

提供只读 MCP 工具，用于提取要求、比较公告、读取源文件和检索证据。它只读取配置数据文件夹中的文件，不访问外部网络。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "rosieoh-korean-notice": {
      "command": "npx",
      "args": [
        "-y",
        "korean-notice-mcp"
      ],
      "env": {
        "MCP_DATA_DIR": "<MCP_DATA_DIR>"
      }
    }
  }
}

启动命令npx -y korean-notice-mcp

需要配置的环境变量

MCP_DATA_DIRAbsolute path of the folder holding notice files. The server only reads files inside it.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmkorean-notice-mcp0.3.0stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
path	string	是	相对于 MCP_DATA_DIR 的文件路径

详细介绍

korean-notice-mcp

한국어 | English

输入去年的公告和今年的公告，即可了解申请条件和所需材料有哪些变化，并附上原文依据。这是一个 MCP 服务。

让 AI 应用（如 Claude Desktop）直接读取韩国地方自治团体和公共机构的招募公告（HWP、HWPX）。所有结果均附有原文位置和文档哈希，方便人工与原文对照。

"比较今年和去年的青年社团公告，告诉我申请条件有哪些变化、我需要准备哪些材料，并附上依据。"

去年与今年的青年社团公告对比演示

上方画面是对实际公开公告（长水郡青年社团 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 比较这两个文件即可。

工具

工具	功能
`extract_requirements`	提取提交材料（必需/有条件要求及条件说明）、申请期限和资格相关段落候选项，并附上依据位置
`compare_notices`	比较两份公告。优先展示材料新增、删除、必需/有条件要求变更和申请期限变更，其余文字与表格变更按重要性排序。仅年份变化的文字单独归入 `date_only_changes`
`read_notice`	读取正文和表格（行、列、合并信息），并附上原文位置和哈希
`get_evidence`	在哈希相同的文档中重新查看依据位置的原文

支持 HWP、HWPX、TXT、MD、CSV 格式。暂不支持 PDF 和扫描图片（OCR）。所有工具均为只读，不会连接外部网络。

准确度如何

我们使用长水郡公开的 5 个项目的 2025、2026 年公告共 10 份（9 份 HWP，1 份 HWPX）进行了评估。仅用 3 组公告调整规则，另外 2 组暂不处理，留待评估。方法和完整结果见 benchmarks/README.md。

	之前的方法	当前版本
提交材料召回率 / 精确率（整体）	66% / 7%	92% / 84%
申请期限命中数	0/10	10/10
34 项重要变化中进入结果前 15 项的数量	4	24
用户需要审核的变化项数	1,779	403

请先了解以下局限。

首次评估保留集时，材料召回率为 43%。 由于一种此前未见过的表格格式，漏掉了一份文档中的全部材料。修复原因后召回率升至 86%，但这并非盲测结果。
使用其他地方自治团体（群山、龙仁、大田）的 3 组公告重新进行盲测：材料精确率保持在 90%，但召回率仅为 47%。在群山公告中，系统无法识别标题表述（“申请材料（……）”“申请受理：”），因此完全没有找到材料和申请期限。对不熟悉的格式适应较差，是目前最大的局限。详情请参阅评估文档。
标准答案是 AI 对照原文制作的初稿，未经人工独立审核。样本也仅来自一个地方自治团体的公告。
由于基于规则运行，可能会将“证明材料的开具方法”等参考表识别为提交材料，也可能漏掉提交材料章节之外列出的材料。
不会判定变化的法律含义或申请资格。申请前请务必核对原始公告并向主管部门确认。

工作原理

读取：使用 rhwp（MIT）读取 HWP。借助 rhwp 的表格 API 还原单元格的行、列和合并结构，从而区分“提交材料 | 内容 | 开具机构”这类表格中的材料列和说明列。HWPX 则使用自有 XML 解析器读取。
提取：根据“提交材料”“（受理期限）”“□ 申请对象”等公告标题表述划分章节。在章节中从编号项目、括号列表以及“※ …… 情况下 …… 提交”这类备注中查找材料。根据“相关人员”“任选一项”“……情况下”等表述判断是否为有条件要求。
比较：逐行比较后，将仅年份变化的文字单独分列，并将同一表格中的单元格变化合并为一项。根据章节（资格、材料、期限、金额）以及数字和关键词的变化评估重要性。

依据位置分为两种。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"는 주식회사 한글과컴퓨터의 등록 상표입니다. 이 프로젝트는 한글과컴퓨터와 제휴·후원·승인 관계가 없는 독립 오픈소스 프로젝트입니다.
책임 한계: 이 도구의 결과는 검토용 후보입니다. 신청 자격이나 제출 의무를 확정하지 않으며, 결과를 근거로 한 판단의 책임은 사용자에게 있습니다.