# 공공데이터 렌즈 (Public Data Lens)

> 공공데이터포털(data.go.kr)의 월간 목록 메타데이터를 정본 JSON-LD로 정규화하고,
> 버전 관리되는 판정 규칙으로 무엇이 존재하고 무엇이 실제로 관측되었는지를
> 근거 수준과 함께 제시하는 탐색·판단 계층이다. 중앙대학교 HIKE 연구실이 운영하는
> AIRD(AI-Ready Data) 표준안 실증 프로젝트이며, 같은 능력을 MCP(Model Context
> Protocol)로 AI 어시스턴트 안에서 쓸 수 있다.

이 문서는 서버가 현재 배포 상태에서 생성한다 — 아래 수치는 조회 시점 값이다.

## 현재 상태

- 현재 스냅샷: 2026-07 (월간 갱신)
- 스냅샷 지연: 55일 — 이 지연 안의 변경은 아직 반영 전이다
- 목록 데이터셋: 96,110건
- 실파일 구조 관측: 파일형 83,850건 중 59,395건(70.8%) — 나머지는 미수집이며, 미수집은 품질 문제가 아니다
- 계약 버전(schemaVersion): 1.8.0

## 판단 시 주의 — 계약 의미

- 본 결과는 공공데이터포털 목록 메타데이터 기반이며 실제 데이터의 내용·품질·결합 가능성을 보증하지 않습니다.
- 원문(실데이터) 접근은 전부 공공데이터포털로 연결한다 — 이 서비스는 재배포하지 않는다.
- 근거 수준은 2종이다: CATALOG_METADATA_ONLY(목록 기재)와 FILE_OBSERVATION(실파일 관측).
  목록 기재는 관측이 아니다.
- 검색 결과 없음은 데이터 부재가 아니다. search_by_columns 무결과는 컬럼 부재가 아니다
  (구조 미수집일 수 있다 — 커버리지 분모는 /api/status 참조).
- NOT_COLLECTED / QUEUED / COLLECTING은 수집 상태다 — 품질 문제가 아니다.
- MISSING_FROM_SNAPSHOT은 관찰 사실이다 — 폐기 확정이 아니다(폐기는 OFFICIALLY_WITHDRAWN만).
- INFERRED_*(지역)는 추론 표시이지 오류가 아니며, UNKNOWN(freshness)은 판단 불가이지 나쁨이 아니다.
- 검색 점수(BM25)는 순위용 상대값이다 — 절대 크기·부호로 품질을 해석하지 않는다.

## MCP 연결

- [MCP 커넥터 URL](https://service.datahub.kr/projects/public-data-lens/mcp): 원격 MCP(streamable HTTP). 인증 없음, 읽기 전용·멱등.
- [Tool 스키마 명세(JSON)](https://service.datahub.kr/projects/public-data-lens/spec/tools/1.0): search_datasets, get_dataset,
  search_by_columns, get_dataset_structure, compare_datasets, get_catalog_changes,
  get_catalog_stats, build_data_plan, get_context

## 정본 URI (Cool URIs — 영구 불변 네임스페이스)

- [현재 카탈로그(JSON-LD)](https://service.datahub.kr/projects/public-data-lens/catalog/current)
- 데이터셋 정본: `https://service.datahub.kr/projects/public-data-lens/dataset/{목록키}` (기본 JSON-LD, 브라우저는 포털로 303)
- [JSON-LD 컨텍스트](https://service.datahub.kr/projects/public-data-lens/context/catalog/1.0)
- [판정 규칙 레지스트리](https://service.datahub.kr/projects/public-data-lens/rules/catalog/1.0)
- [SHACL 셰이프](https://service.datahub.kr/projects/public-data-lens/shapes/catalog/1.0)

## API·문서

- [카탈로그 현황(JSON)](https://service.datahub.kr/projects/public-data-lens/api/status): 스냅샷·건수·구조 커버리지 실시간 값
- [개인정보·로그 고지](https://service.datahub.kr/projects/public-data-lens/api/resources/privacy)
- [GitHub 저장소](https://github.com/hike-lab/public-data-lens): 설계서·부속명세·판정 규칙·ADR 전체 공개