왜 이런 시안을 만들었나?

현재 대한민국 중앙부처 홈페이지는 AI 에이전트가 읽기 매우 어렵습니다.agent-ready-check 스캐너로 측정했을 때, 20개 부처 중 절반 이상이 F 등급을 받습니다.

이 시안이 한 일

• 19개 중앙부처를 하나의 Next.js 앱으로 재현
• 각 부처별 /slug/llms.txt, /slug/index.md, JSON-LD 구조화 데이터
• 사이트 레벨 에이전트 엔드포인트:
  • /.well-known/mcp.json — MCP 매니페스트
  • /.well-known/openid-configuration — OIDC 디스커버리
  • /.well-known/agent.json — 에이전트 카드
  • /openapi.json — OpenAPI 3.1
  • /llms.txt, /llms-full.txt
• 마크다운 콘텐츠 협상 (Accept: text/markdown) — curl -H "Accept: text/markdown" https://kgov-ready-demo.vercel.app/
• AI 봇별 명시적 robots 정책 (GPTBot, ClaudeBot, CCBot, PerplexityBot 등 11종)

한계와 면책

• 공식 사이트 아님. 디자인·구조는 시연을 위한 단순화. 실제 정부 정책·서비스는 각 부처의 원사이트를 참조.
• 서비스 링크(/slug/services/*)는 작동하지 않습니다 (404).
• OIDC 엔드포인트는 실제 토큰을 발급하지 않는 스텁 문서만 제공.
• MCP 서버(/mcp)는 매니페스트만 있고 실제 JSON-RPC는 구현되지 않음.

기술

Next.js 15 · React 19 · Tailwind CSS · TypeScript. 전체 소스: github.com/hosungseo/kgov-ready-demo.

라이선스

코드는 MIT, 콘텐츠(시안 텍스트)는 CC-BY-4.0. 자유롭게 가져가서 고치시면 됩니다.