주제로 공공데이터를 원격 검색합니다. Search the remote catalog by topic. query: 자연어 / topic; n: 1~20; dtype: FILE/API/STD; org: 기관명 / provider; fields: 모두 필요한 컬럼 / required columns. 반환 / Returns: {summary, results}. summary는 n으로 자르기 전 후보의 주제·데이터셋 수와 유형·기관 분포·의도 힌트입니다. Summary counts candidate groups/datasets before n, with type/provider distributions and intent hints. results: id, title, org_nm, access_kind, page_url, matched_fields, desc_short(설명 앞 120자 / first 120 characters, no newlines), top_columns(등록순 최대 5개 / first 5 registered columns), portal_updated(ISO date or null), org_level(national/local). group_count는 대표 포함 후보 멤버 수, group_ids는 순위순 최대 60개 id입니다. Group count includes the representative; group_ids contains up to 60 ranked member ids. 펼치기는 group_ids의 id를 show로 조회 / Inspect each group_ids member with show. 지역·API/파일 의도는 서버가 추출하며 dtype/org를 주면 더 정확합니다. The server infers region and API/file intent; explicit dtype/org filters are more precise. 예시 / Example: query='전국 주차장'.

검색한 데이터셋의 구조·사용법을 확인합니다. Inspect dataset metadata before use. 반환 / Returns: title, org_nm, access_kind, columns, operations, examples, page_url. dataset_id는 검색 결과의 id입니다. Use the id from search; use get for actual rows.

지정 컬럼을 모두 가진 데이터셋을 찾습니다. Find datasets matching ALL named columns. names 예시 / Example: ['위도', '경도']; n: 1~20; dtype: FILE/API/STD; org: 기관명. 반환은 search와 같은 메타데이터입니다. Returns ranked metadata as in search.

원격 서버에서 첫 행·접근 안내를 조회합니다. Preview up to 20 rows remotely. 반환 / Returns: access_kind, data.columns/rows, total or access instructions. 키는 전송하지 않습니다. 키가 필요한 조회는 fetch/get을 사용하세요. No credentials are sent; use local fetch/get for authenticated rows. 신청·저장 없음 / No application or file saving.

본인 로컬 키로 odcloud 첫 n행을 조회합니다. Fetch rows locally with DATAGOKR_API_KEY. version 생략 시 최신 / latest version by default. 반환 / Returns: API data or request_templates; status_code=401 means access must be requested. STD_FILE은 get/download. 활용신청·파일 저장은 하지 않습니다. Does not apply for access or save files.

접근방식에 따라 첫 행·링크·API 템플릿을 돌려줍니다. Get rows, links or API templates. PORTAL_FILE 401은 기본적으로 신청 없이 원문 파일 저장으로 폴백합니다. 활용신청까지 하려면 사용자가 명시적으로 허락한 경우에만 no_apply=False 를 넘기세요 (본인 계정으로 신청이 나갑니다). By default no application is submitted on 401; pass no_apply=False only with the user's explicit consent. probe=True는 신청·파일 저장 없이 확인. probe checks access without applying or saving files. 반환 / Returns: access_kind with data, url, request_templates or files (local paths).

본인의 저장된 포털 세션으로 활용신청을 제출합니다. Submit access applications with saved login. ids: 1~50개 데이터셋 id; purpose: 활용 목적 / intended use. 로그인: login 도구 또는 datagokr login. 반환 / Returns: id, status, portal_status, page_url; manual means login is required. 쿠키는 포털에만 전송됩니다. Cookies are sent only to the portal.

원문을 이 컴퓨터에 저장합니다(같은 경로는 덮어씀). Save originals locally, overwriting the same path. version 또는 all_versions 중 하나 / choose version or all_versions; out: 이번 저장 폴더, 기본 DATAGOKR_DOWNLOAD_DIR / destination directory; utf8: CSV UTF-8 변환본 추가. probe=True는 저장 없이 확인합니다. probe checks without saving. 반환 / Returns: files with path, version, optional utf8_path, or an external url; STD_FILE is saved as a full CSV.

저장된 포털 세션의 유효성을 확인합니다. Check whether the saved portal login is valid. 반환 / Returns: authenticated, message. 세션이 없거나 만료되면 login 도구로 로그인하세요. Use login for missing or expired sessions. Keys and cookies are never returned.

대화에서 보안문자를 입력해 포털에 로그인합니다. Log in locally with a user-read CAPTCHA. 먼저 인자 없이 호출하고 이미지를 사용자에게 보여주세요. 사용자가 직접 읽은 글자만 captcha_answer에 넣고 같은 challenge_id로 다시 호출하세요. Show the image to the user; submit their answer with its challenge_id within 5 minutes. Retry/refresh without arguments. 아이디·비밀번호는 확장 설정의 로컬 환경변수에만 둡니다. Never pass credentials as arguments. 성공 시 세션 저장; 활용신청은 별도입니다. Saves a session; does not apply for access.