dev.datagokr/datagokr

Tools

• download_url

  [공공데이터포털 검색 (datagokr)] 전체 데이터를 사용자 컴퓨터로 받는 방법을 알려줍니다. 서버가 파일을 대신 저장하진 않고 주소·요청값·절차를 돌려줍니다. 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 원본 파일 다운로드 주소'

  shallow
• fields

  [공공데이터포털 검색 (datagokr)] 주제 없이 컬럼만 조건일 때(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.

  shallow
• get_preview

  [공공데이터포털 검색 (datagokr)] 실제 첫 행 보기. STD_FILE·PORTAL_FILE(첨부 있으면)은 키 없이 첫 행을 줍니다. PORTAL_FILE 첨부 미리보기 실패 시 API 대체 조회에 본인 X-DataGoKr-Key가 필요할 수 있음(키는 반환·저장 안 함). 서울·경기의 확인된 공개 경로는 키 없이 최대5행. 그 밖의 OPEN_API→request_templates, LINK→url, STD 하위행→parent_id. Preview standard data and portal attachments without a key. API fallback may require the caller's 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/access_guide). 지역 API가 확인되면 service_name/request_format도 반환. data가 있으면 실제 행을 받은 것. ok=false: retry later. data means actual rows, as value arrays in columns order (up to 50 columns/20 rows).

  shallow
• record

  [공공데이터포털 검색 (datagokr)] (로컬 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. 내부 상태는 제외하고, 서버에서 신청하거나 저장하지 않습니다.

  shallow
• search

  [공공데이터포털 검색 (datagokr)] 주제로 공공데이터를 찾습니다. "전국 주차장", "재난문자 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.

  shallow
• show

  [공공데이터포털 검색 (datagokr)] 검색에서 고른 데이터셋의 구조와 접근 방법을 봅니다. 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, access_guide(인증·받는 절차), 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로 실제 첫 행을 확인하세요.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/58391485-1eed-4f2e-8308-530f43176594/badge.svg)](https://vouch.tools/servers/58391485-1eed-4f2e-8308-530f43176594)