Releases: hike-lab/public-data-lens
Release list
Public Data Lens v1.2.0-beta.3
월간 변화 추적 시작 — 두 회차가 쌓여 "지난달과 무엇이 달라졌는가"에 답합니다.
⚠️ 기존 이용자: 커넥터 재연결이 필요합니다
이번 릴리스는 입력 파라미터를 추가했습니다. MCP 호스트는 연결 시점의 도구 목록을 캐시하므로, 기존 연결에는 새 파라미터가 보이지 않습니다.
| 기능 | 재연결 |
|---|---|
월간 변화 추적 (get_catalog_changes) |
불필요 — 데이터만 채워졌습니다 |
기관 간 완전성 비교 (get_catalog_stats axis=org) |
불필요 — 기본 적용으로 변경(ADR-019) |
기관명 정확일치 (search_datasets orgMatch) |
필요 — 신규 입력 파라미터 |
통계 교차 집계 명시 지정 (breakdown) |
필요 — 신규 입력 파라미터 |
Claude는 설정 → 커넥터에서 비활성화 후 재활성화, ChatGPT는 삭제 후 재등록하면 됩니다. 월간 스냅샷 갱신은 재연결이 필요하지 않습니다.
새 기능
월간 변화 추적 (최초 생성)
기준 2026-06 → 현재 2026-07
ADDED 415 · MODIFIED 5,564 · MISSING_FROM_SNAPSHOT 361 · POSSIBLE_IDENTITY_CHANGE 2 (총 6,342)
OFFICIALLY_WITHDRAWN 0
스냅샷 부재를 폐기로 단정하지 않습니다 — 관측 사실과 판정을 구분합니다.
기관 간 비교 · 정확일치 (Issue #1 실사용 보고 반영)
get_catalog_stats(axis=org)— 기관별 완전성을 프로파일(FILE/API/STD)별로 분해. 전수 수집이 필요 없어졌습니다. 프로파일 간 분모가 달라 합산은 금지합니다search_datasets(orgMatch=EXACT)—서울특별시8,957건(부분일치) → 3,317건(정확일치). 자치구가 걸러집니다. 0건일 때는 데이터 부재가 아니라 기관명 표기 차이임을 응답이 알립니다
웹 기계 판독 레이어 · 관측 현황 화면
JSON-LD·정적 본문·동적 llms.txt, 검색 순위 오독 방지(items[].rank·ranking.scoreDirection), 관측 현황(/observatory), 카피 전면 개정.
판정 규칙 개정 — 발행자 표기 변화를 실질 변경으로 세지 않습니다
2026-07 회차를 2026-06과 전수 대조한 결과, 변경행 17,812건 중 약 69%가 발행 과정의 표기 요동이었습니다.
- API 유형 11,960행의 날짜가 엑셀 일련번호로 기재 (
2012-12-06→41249) 설명필드 줄바꿈 처리가 회차마다 전환 (0 → 5,961 → 0)
글자 하나 바뀌지 않은 행이 MODIFIED로 잡히고 있었습니다. 신설·개정 규칙:
| 규칙 | 내용 |
|---|---|
normalize-date-v1.0 |
엑셀 일련번호 환산. 발행자 수정본과 11,960/11,960 일치 검증 |
normalize-empty-v1.0 |
수식 오류 잔재(#NAME?·ME?)를 값 없음으로 판정 |
diff-v1.1 |
확장자는 정규 토큰, 텍스트 5필드는 공백 둔감 비교. 저장값은 원문 유지 |
issue-detect-v1.1 |
날짜·수식 오류 관찰 3종 추가 — 변환은 침묵하지 않습니다 |
catalog-completeness-*-v1.1 |
미기재 판정을 normalize-empty-v1.0에 위임 |
catalog-stats-breakdown-v1.0 |
axis=org 교차 집계 기본 적용, none 옵트아웃 |
스냅샷 수용 게이트 (scripts/verify_snapshot.py)
빌드 전 9개 항목을 검사하고 차단 시 종료코드 1로 멈춥니다 — 헤더·중복키·날짜 ISO·카운터 단조성·채움률 델타·어휘 집합 델타·값 회귀·수식 오류·원문 급감. monthly_update.sh에 편입돼 직전 회차와 자동 대조합니다.
실전 검증: 2026-07 초판 차단 2건, 수정본 수용 가능, 2026-08 API 합성본 차단 12건.
알려진 사항 (발행자 측)
- 서술형 필드 74건의 원문 소실 —
-로 시작하는 셀이 스프레드시트에서 수식으로 해석된 결과.null+EXCEL_FORMULA_ERROR_ARTIFACT관찰로 처리, 복원 요청 중 - 2026-07 말 등록분 27건 누락, 파일명 기준일과
수정일범위 불일치(2,148건) — 확인 요청 중
버전 구분
| 축 | 버전 |
|---|---|
| 서비스 | v1.2.0-beta.3 |
| MCP 계약 | v1.8.0 (SCHEMA_VERSION 불변) |
| 카탈로그 스냅샷 | 2026-07 |
| 판정 규칙 | 31종 |
검증
CI 통과(서버·웹·compose), 전체 스위트 179 passed, 계약 스펙 라이브 검증 9종 통과. 배포 후 운영 서버 실측이 빌드 기대치와 전 항목 일치.
사용
https://service.datahub.kr/projects/public-data-lens/mcp
Claude → 설정 → 커넥터 → 커스텀 커넥터 추가. 기존 이용자는 위 재연결 안내를 확인하세요.
관련 ADR: 016 수용 게이트·diff-v1.1 · 017 Issue #1 반영 · 018 수식 오류 판정 · 019 교차 집계 기본 적용과 클라이언트 캐시
Public Data Lens v1.1.0-beta.1
활용 계획 초안 — 이번 릴리스부터 목적 한 문장이면 검색을 넘어선 결과를 받습니다.
새 기능
build_data_plan Tool (MCP 계약 v1.4.0, additive)
목적 문장(예: "폐교를 지역 문화공간으로 활용하려고 한다")을 받아 데이터 활용 계획 초안을 반환합니다:
- 후보 데이터셋과 역할(PRIMARY/DEMAND/SUPPLY/SPATIAL/TEMPORAL/REFERENCE)
- 항목별 선정 근거(fitSignals — 검색 관련도·구조 관측·최신성·메타 충실도)
- 예상 결합 키 — 항상
CANDIDATE_ONLY(값 체계 일치는 검증하지 않음) - 미충족 요구(missingNeeds)와 다음 확인사항
LLM 없이 결정론적으로 조립되며(규칙 plan-assembly-v1.0) 항상 초안(DRAFT)입니다 — 품질(NOT_ASSESSED)·결합 가능성·분석 충분성을 확정하지 않습니다. 실제 품질 검증, 값 수준 결합 확인, 반복적인 분석 설계는 별도 AI 컨시어지에서 제공됩니다. 같은 이름의 Prompt는 이 Tool 결과를 대화형으로 풀어 설명합니다.
코어 웹 v2
- 검색창 중심 히어로 랜딩, 검색엔진식 결과 리스트
- 질의 의도 해석("서울 무더위 쉼터 CSV" → 지역·포맷 자동 적용)
- 소개(현황 통계)·AI에 연결(클라이언트별 안내) 페이지
버전 구분
| 축 | 버전 |
|---|---|
| 서비스 | v1.1.0-beta.1 |
| MCP 계약 | v1.0.0 동결 + v1.4.0 additive |
| 검증 카탈로그 스냅샷 | 2026-06 |
검증
CI 통과(서버 테스트 79 passed·25 skipped(카탈로그 의존분), 웹 빌드, compose fail-closed), 개발 전체 스위트 119 passed, 계약 스펙 라이브 검증 9종 통과.
사용
https://service.datahub.kr/projects/public-data-lens/mcp
Claude → 설정 → 커넥터 → 커스텀 커넥터 추가. 첨부 SHA256SUMS로 소스 아카이브를 검증하세요.
Public Data Lens v1.0.0-beta.1
공공데이터포털 월간 목록(~9.6만 건)을 정본 JSON-LD/DCAT 계층으로 정규화하고, 버전 관리되는 결정론적 판정 규칙과 함께 **MCP(Model Context Protocol)**로 제공하는 AIRD(AI-Ready Data) 표준안 실증 프로젝트의 첫 공개 릴리스입니다.
사용
Claude 웹/앱 → [설정] → [커넥터] → [커스텀 커넥터 추가]:
https://service.datahub.kr/projects/public-data-lens/mcp
인증 없이 읽기 전용·무료(베타, SLA 없음). 셀프 호스팅은 배포 설명서 참조.
버전 구분
| 축 | 버전 |
|---|---|
| 서비스 | v1.0.0-beta.1 (골든셋 인간 검수·정본 도메인 연결 완료 시 beta 해제) |
| MCP 계약 | v1.0.0 동결 + v1.3.0 additive (기존 필드·오류 불변) |
| 검증 카탈로그 스냅샷 | 2026-06 (목록 레코드 96,056건) |
범위
- 포함: 카탈로그 파이프라인(정규화·SHACL·diff·원자적 배포) · MCP 서버(Tool 8종·Prompt 2종·Resource) · 코어 웹 · 공개 명세(Tool 스키마·판정 규칙·JSON-LD Context·SHACL)
- 미포함: 생성형 AI 컨시어지 — 별도 서비스로 제공되며 이 저장소에 없음
검증
- CI 통과(이 저장소에서 실행): 서버 테스트 77 passed·20 skipped, 코어 라우트·MCP 스모크, 웹 코어 빌드, prod compose 유효성 + 필수 env fail-closed 거부
- 보안 기본값: 비루트 컨테이너·read-only FS·cap_drop ALL·루프백 바인딩·Host 헤더 검증 필수·다중 CIDR real-ip
무결성
첨부 SHA256SUMS로 소스 아카이브를 검증하세요.