연결 점검 — OC 보유 여부 + 법제처 OPEN API 실제 왕복 1회.

다룰 수 있는 갈래와 갈래별 실측 스키마·주의사항.

갈래마다 응답 태그와 식별자 파라미터가 다르고 이름에서 유추할 수 없다 — 이 도구가 그 표다.

법령·판례 등 한 갈래를 검색한다.

Args: target: 갈래 코드. law(현행법령)·admrul(행정규칙)·ordin(자치법규)·prec(판례)· detc(헌재결정례)·expc(법령해석례)·trty(조약)·eflaw·elaw·lsStmd. law_targets 로 전체 목록을 볼 수 있다. query: 검색어. 비울 수 없다 — 비우면 전체 카탈로그가 온다. max_records: 회수 상한(예산). 이 API 는 page 상한이 없어 올리면 전량도 받는다. page_size: 한 페이지 건수(최대 500). scope: 1=제목만(기본), 2=본문 포함. allow_full_catalog: query="*" 로 갈래 전체를 받겠다고 명시할 때만 True.

식별자 1건의 본문을 받는다(조문·판시사항·질의요지 등).

Args: target: 갈래 코드. doc_id: 목록 결과의 일련번호. 갈래마다 파라미터명이 MST/ID 로 다르지만 이 도구가 알아서 맞춘다. include_articles: 조문 목록을 함께 돌려줄지(법령·자치법규에만 있다). ef_date: 시행일법령(eflaw) 전용 — 목록의 시행일자. 🔴 없이 부르면 오류가 아니라 HTML 이 온다. 같은 법령의 시행일별 판본이라 (MST, efYd) 가 신원이다. max_chars: 본문 텍스트 상한. 넘으면 잘라내고 그 사실을 알린다.

갈래 × 검색어의 합집합을 모아 파일로 저장한다.

⚠️ max_records 는 전체에 걸친 예산이다. 앞선 축이 다 쓰면 뒤 축은 조회되지 않으며, 그 사실은 meta 의 stopped_early_note 로 보고된다. ⚠️ 한 축이 실패해도 나머지는 계속 수집한다 — 실패는 failed_axes 로 보고된다.

한 건을 서지(인용) 필드로 매핑한다 — 발령주체·호·공포일·시행일·제정기관.

목록에서 1건을 다시 찾아 매핑한다. 서지관리 도구(Ibis 의 legislation 유형 등)로 바로 넘길 수 있는 모양이다.