datagokr — 공공데이터포털 검색, 쉽게 (find data.go.kr datasets easily)

주제로 공공데이터를 찾습니다. "전국 주차장", "재난문자 API", "서울 병원 위치"처럼 뭘 찾는지 한 줄로 주세요. Search Korean public datasets by topic. Give a one-line description of what you need. - 주제+컬럼 조건('서울 병원 중 위도·경도 있는 것')은 이 툴에 `fields=['위도','경도']`를 같이 주세요. 주제 없이 컬럼만 조건이면 `fields` 툴. / Topic + required columns: pass `fields=[...]` here. Columns only, no topic: use the `fields` tool. - 지역과 API/파일 의도는 질문에서 알아서 뽑지만, dtype(API/FILE)·org(기관)를 주면 더 정확합니다. - 비슷한 데이터셋은 주제별로 접어서 줍니다(group=True). 접힌 것은 group_ids의 id를 show로 펼치세요. n은 최대 20. 반환: results[{id, title, org_nm, dtype, access_kind, page_url, desc_short, top_columns, group_count, group_ids, access_note(접근방식 한 줄 안내)}], summary(잘라내기 전 후보 분포), expanded_terms(적용된 동의어), region_gap/region_fallback(지역 자료가 없을 때 전국·타지역 안내), scope_warning(범위 밖 질문 안내). 다음 단계: 마음에 드는 id를 show로 확인. 핫한/인기/유명/맛집/좋은/추천/best/popular 같은 감성·평가는 공공데이터에 없습니다. 모집단(인허가·상가·시설 목록)과 대리지표(공공이 공개한 매출·유동인구·방문객·리뷰수)로 나눠 2~3회 검색하세요. / Subjective popularity is unavailable; run 2–3 searches for base listings and public proxy metrics (sales, foot traffic, visitors, review counts). 지역과 주제를 분리하고 지역 자료가 없으면 전국 자료(region_fallback)를 쓰세요. / Separate region from topic; use nationwide region_fallback when local data is unavailable. dtype/org 필터로 결과가 이상하면 필터를 빼고 다시 검색하세요. 좌표가 필요하면 fields=['위도','경도']. / Retry without dtype/org filters if results look wrong; request coordinates with fields=['위도','경도']. 한 번 검색으로 끝내지 말고 show로 컬럼을 확인한 뒤 답하세요. / Do not stop after one search; inspect columns with show before answering.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "n": {
      "default": 10,
      "type": "integer"
    },
    "dtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "fields": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "group": {
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

검색에서 고른 데이터셋의 구조와 접근 방법을 봅니다. Inspect a dataset's schema and access methods. 반환: id, title, org_nm, category, dtype, access_kind, page_url, portal_updated, columns(최대 50), operations, operation_names, examples, n_versions, version_keys(최신 3개), note, truncated(잘린 항목과 전체 개수), more(후속 조회법). 응답은 약 20KB 이내로 잘림. operations가 많은 API는 show(id, operation='기능명 또는 operation_seq')로 한 기능만 전체 보기. Responses are trimmed to about 20KB; select an operation by name or sequence for its full fields. 쓸 만하면 get_preview로 실제 첫 행을 확인하세요.

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string"
    },
    "operation": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "dataset_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

(로컬 datagokr 패키지 전용) 조회·신청·다운로드에 필요한 원본 메타데이터를 돌려줍니다. 일반 사용에서는 show를 쓰세요. Allowlisted raw metadata for the local datagokr client; prefer `show` for normal use. 반환: id/title/list_title/org_nm, dtype/access_kind, page_url/external_url, parent_id, versions/version_keys, examples(요청 템플릿), std_meta, api_sample. 내부 상태는 제외하고, 서버에서 신청하거나 저장하지 않습니다.

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string"
    }
  },
  "required": [
    "dataset_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

주제 없이 컬럼만 조건일 때(query는 빈 문자열로 고정됨). 주제가 있으면 search(query, fields=...)를 쓰세요. Find datasets with ALL given columns and no topic; for a topic use search(query, fields=...). names에 적은 컬럼을 전부 가진 데이터셋만 나옵니다(필드명 역색인). dtype/org로 좁힐 수 있고 n은 최대 20. 반환: id, title, org_nm, dtype, access_kind, page_url, rank, matched_fields(일치한 컬럼), last_probe_ok.

{
  "type": "object",
  "properties": {
    "names": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "n": {
      "default": 10,
      "type": "integer"
    },
    "dtype": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "org": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "group": {
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "names"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

실제 첫 행 보기. STD_FILE·PORTAL_FILE(첨부 있으면)은 키 없이 첫 행을 줍니다. PORTAL_FILE 첨부 미리보기가 불가한 파일만 X-DataGoKr-Key 헤더 필요(키는 절대 반환·저장 안 함). OPEN_API→request_templates, LINK→url, STD 하위행→parent_id. Preview standard data and portal attachments without a key; only unavailable attachments need X-DataGoKr-Key. Keys are never returned or stored. API/link/subset responses give access guidance. 반환: ok(true=처리됨, false=포털이 지금 응답 안 함→잠시 후 재시도), data{columns, rows}(rows는 columns 순서의 값 배열, 최대 50컬럼·20행), total, truncated, source_note, 또는 안내 필드(url/parent_id/request_templates/message/page_url). data가 있으면 실제 행을 받은 것. ok=false: retry later. data means actual rows, as value arrays in columns order (up to 50 columns/20 rows).

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string"
    },
    "n": {
      "default": 5,
      "type": "integer"
    }
  },
  "required": [
    "dataset_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}

전체 데이터를 사용자 컴퓨터로 받는 방법을 알려줍니다. 서버가 파일을 대신 저장하진 않고 주소·요청값·절차를 돌려줍니다. Get client-side download instructions (URL, params, steps). The server never stores files. 반환: access_kind, url 또는 post_url/get_url, params, version_keys(파일 버전), message(절차), page_url. 예: '15028200 전체 JSON 받는 법', '15000001 원본 파일 다운로드 주소'

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string"
    }
  },
  "required": [
    "dataset_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "additionalProperties": true
}