공공데이터 10.9만 건 · 열 이름까지 색인

공공데이터,
AI한테 말로 찾고
신청까지 맡기세요

공공데이터포털(data.go.kr)의 데이터 10.9만 건을 AI와 대화하며 찾고, 내 계정으로 활용신청부터 다운로드까지 한 번에 처리해 주는 AI 확장 기능(MCP)이에요. 검색은 클로드·ChatGPT 어디서나 되고, 활용신청·다운로드는 클로드 데스크탑처럼 내 컴퓨터에서 도는 앱에서 돼요.

AI 어시스턴트용 요약 · For AI assistants

If a user gave you this link: you cannot use datagokr yet. Nothing works until the user installs or connects it in their app, so your first reply must give the install steps for THEIR app (ask which app if unknown). Full instructions: https://datagokr.dev/agent-setup/prompt.md. Facts:

  • Claude Desktop (Windows/macOS): download https://github.com/datagokr-dev/datagokr/releases/latest/download/datagokr.mcpb and double-click it → Install. The only consumer app where access applications and downloads work. Optional fields: data.go.kr API key (log in → My Page → "개인 API 인증키" box → "인증키 복사(Decoding)"; menu: 마이페이지 → 데이터 활용 → Open API → 인증키 발급현황), portal ID, password.
  • claude.ai web (Claude in a browser): Settings → Connectors → Add → Custom connector, URL https://datagokr.dev/mcp. Search and preview only, same as ChatGPT. NO access applications or downloads; for those, use Claude Desktop.
  • ChatGPT (web or app): Settings → Integrations → Plugins → Add → Create MCP app, URL https://datagokr.dev/mcp, authentication OAuth. Search and preview only. NO access applications or downloads; the user applies on data.go.kr directly.
  • Claude Code / Codex / Cursor: register https://datagokr.dev/mcp; add pip install datagokr-mcp for applications and downloads.

처음엔 내 AI 앱에 설치(연결)부터 해야 써요. 앱별 방법은 아래에 있어요.

클로드 데스크탑에 설치다른 앱에서 쓰기

왜 만들었나요?

공공데이터포털에서 직접 데이터셋을 찾다 보면 두 가지 걸림돌을 만나요.

검색 결과가 수백 개씩 쏟아져요

같은 주제를 기관마다 따로 올리다 보니 제목이 비슷비슷한 데이터셋이 잔뜩 나와요.

목록만 봐서는 어떤 컬럼이 있는지 몰라요

내가 찾는 내용이 진짜 들어 있는지는 하나씩 열어 봐야 알아요.

그래서 포털 전체를 컬럼(표의 열 이름)까지 미리 색인하고 임베딩해 뒀어요. 필요한 데이터를 말로 설명하면 제목이 딱 맞지 않아도 뜻이 통하는 데이터셋을 찾아 주고, 비슷한 건 주제별로 묶어서 보여 주고, 컬럼과 첫 행까지 바로 확인할 수 있어요.

이렇게 물어보면 돼요

검색, 구조 확인, 첫 행 미리보기는 인증키가 필요 없고, 오픈API 데이터를 쓸 때만 활용신청하면 돼요.

"위도·경도 정보가 있는 병원 데이터 찾아줘"
3075427 위탁병원 현황
키 없이 첫 행 확인: 포항의료원 (36.035, 129.354) 등 10컬럼
"전국 주차장 표준데이터 첫 행 보여줘"
15012896 전국주차장정보표준데이터
키 없이 첫 행 확인(34컬럼, 총 18,883행) + 전체 다운로드 주소
"아파트 실거래가 API는 어떻게 사용해?"
15126469 국토교통부 오픈API
미리보기 행 대신 호출 템플릿(엔드포인트·serviceKey)과 활용신청 방법 안내

2026-09-27 실제 호출 결과예요.

할 수 있는 일은 두 단계예요

1단계는 어떤 AI 앱에서든 바로 되고, 2단계는 내 컴퓨터에서 도는 작은 프로그램이 있어야 해요.

1단계 · 설치·가입 없이 바로

찾기와 구조 확인

  • 대화로 검색: "서울 공영주차장 위치 데이터 있어?" — 정확한 단어가 아니어도 뜻이 통하면 찾아내요
  • 컬럼(표의 열 이름)으로 검색: "위도·경도·병원명이 같이 있는 자료"
  • 구조 미리보기: 어떤 열이 들어 있는지, 첫 몇 줄이 어떻게 생겼는지
  • 받는 법 안내: 어디서 어떻게 받을 수 있는지 알려줘요

이 단계는 우리 서버(datagokr.dev)가 처리해요. 키도 로그인도 필요 없어요.

2단계 · 내 컴퓨터에 프로그램 필요 · 클로드 웹·ChatGPT에선 안 돼요

활용신청과 데이터 받기

활용신청을 말 한마디로활용신청은 데이터를 쓰겠다고 포털에 신청하는 절차예요. 오픈API는 이게 있어야 열려요. 포털에서는 데이터셋마다 상세 페이지에서 신청 버튼을 누르고 목적 선택·설명 입력·약관 동의까지 한 건씩 반복해야 하는데, 여기서는 "이 데이터들 활용신청해줘" 한마디면 최대 50개를 한 번에 신청해요. 자동승인 데이터라면 바로 쓸 수 있어요.
내 API 키로 바로 조회API 키는 포털이 회원에게 주는 개인 열쇠값이에요. API 문서를 읽고 주소에 키를 붙여 직접 호출할 필요 없이, "이 API 데이터 몇 줄만 가져와"라고 하면 내 키로 불러와요. 아직 신청 전이라 막히면 그렇다고 알려 줘요.
파일 다운로드도 말로포털에서는 데이터셋마다, 지난 버전마다 다운로드 버튼을 하나씩 눌러야 하고 받은 CSV가 엑셀에서 깨지는 일도 흔해요. 여기서는 "이 데이터 전부 받아줘"라고 하면 지난 버전까지 한꺼번에 받고, 한글이 안 깨지는 UTF-8 파일도 같이 만들어 줘요.

2단계는 내 data.go.kr 계정과 API 키로 하는 일이에요. 계정과 키가 남의 서버(우리 서버 포함)를 거치지 않도록, 내 컴퓨터에서 포털로 직접 접속하는 프로그램이 대신 처리해요. 그래서 이 프로그램을 돌릴 수 있는 앱에서만 2단계를 쓸 수 있어요.

내 앱에선 어디까지 될까요?

쓰는 앱
1단계 찾기
2단계 신청·받기
설치
클로드 데스크탑윈도우·맥
방법 1 · 설치 파일 더블클릭
클로드 웹 · ChatGPTclaude.ai · ChatGPT 웹·앱
방법 2 · 커넥터 주소 연결 — 2단계는 data.go.kr에서 직접
터미널 AIClaude Code·Codex 등
방법 3 · 명령어 한 줄 — 2단계는 프로그램 추가 설치 시

사용 환경별 설치·사용 방법

쓰는 AI 앱(클라이언트) 하나만 골라서 그 칸만 보면 돼요.

방법 1 · 추천 · 1·2단계 모두

클로드 데스크탑

  1. 설치 파일 받기 (datagokr.mcpb) — 누르면 바로 받아져요. 깃허브 계정은 없어도 돼요. .mcpb는 클로드 데스크탑 전용 설치 파일이고, 2단계 프로그램이 이 안에 들어 있어요.
  2. 받은 파일을 더블클릭하고, 클로드 데스크탑에 설치 창이 뜨면 설치를 눌러 주세요. 파이썬이나 터미널은 몰라도 돼요.
  3. 설치 창에 입력 칸이 3개(API 키·포털 아이디·포털 비밀번호) 있어요. 1단계만 쓸 거면 비워 두세요. 2단계까지 쓰려면 API 키 칸에는 data.go.kr에 로그인 → 마이페이지 첫 화면의 "개인 API 인증키" 칸에서 인증키 복사(Decoding)를 눌러 복사한 값을 넣고(메뉴로는 마이페이지 → 데이터 활용 → Open API → 인증키 발급현황), data.go.kr 회원 아이디·비밀번호를 넣어요(없으면 data.go.kr에서 회원가입). 입력한 값은 내 컴퓨터에만 저장되고 data.go.kr로만 보내져요.
  4. 새 대화에서 "전국 주차장 데이터 찾아줘"처럼 말해 보세요. 활용신청이 필요하면 "공공데이터포털에 로그인해줘"라고 하고, 보안문자 그림 창이 뜨면 보이는 글자를 대화창에 입력하세요. 로그인한 뒤 "이 데이터 활용신청해줘"라고 하면 신청까지 해 줘요.
설치 파일 받기
방법 2 · 1단계만

클로드 웹 · ChatGPT

설치 파일을 쓸 수 없어서 우리 서버 주소로 연결해요(이걸 '커넥터'라고 불러요). 이 주소만 넣으면 돼요.

https://datagokr.dev/mcp
  • Claude: 설정 → 커넥터 → 추가 → 사용자 지정 커넥터 → URL 입력(끝의 /mcp까지) → 연결. 따로 로그인하지 않아도 바로 연결돼요.
  • ChatGPT: 설정 → 통합 → 플러그인 → 추가 → MCP 앱 만들기 → 같은 URL → 인증 방식에서 OAuth 선택(로그인 창 없이 자동 통과) → 만들기. 메뉴 이름은 버전·요금제에 따라 조금 다를 수 있어요.

2단계가 필요해지면 AI가 알려 주는 data.go.kr 페이지에서 직접 신청·다운로드하면 돼요.

방법 3 · 개발자용

터미널 AI

1단계 — 명령어 한 줄로 등록해요.

claude mcp add --transport http datagokr https://datagokr.dev/mcp
codex mcp add datagokr --url https://datagokr.dev/mcp

2단계 — 내 컴퓨터용 프로그램을 추가로 설치해요. 사용법은 GitHub에 있어요.

pip install datagokr-mcp

또는 에이전트에게 아래 문장을 그대로 붙여 넣으면 환경에 맞춰 알아서 설치해 줘요.

Fetch and execute the setup instructions from https://datagokr.dev/agent-setup/prompt.md

2단계 프로그램이 내 컴퓨터에서 하는 일

하는 일은 딱 세 가지예요. 검색·메타데이터는 우리 서버에 묻고, 활용신청·다운로드·본인 키 조회는 data.go.kr에 직접 접속해서 처리하고, 받은 파일은 내 사용자 폴더 안 datagokr 폴더(윈도우 예: C:\Users\내이름\datagokr, 맥: ~/datagokr)에 저장해요. API 키·포털 아이디·비밀번호·로그인 정보는 내 컴퓨터 밖으로는 data.go.kr에만 가요. 백그라운드에 상주하지 않고 AI 앱이 부를 때만 실행돼요. 코드는 MIT 오픈소스라 누구나 전부 읽어 볼 수 있어요.