연결 점검 — OAI(무인증) Identify + REST 인증키 보유 여부.

[REST] 논문 검색 — title 필수 + 선택 필터. 인증키 필요.

date_from/date_to: 발행연월 YYYYMM. rows: 반환 건수(최대 100). institution: 발행기관명 필터. sort_by: title|author|pubiYr, sort_dir: asc|desc. (정렬은 페이징 상한에 걸렸을 때 sort_dir 를 뒤집어 반대쪽을 추가 수집하는 데도 쓴다.) 반환값의 total 은 KCI 가 보고한 전체 건수이고, truncated=true 면 rows 상한에 잘린 것이다.

⚠️ articleSearch 응답에는 저자 키워드·ISSN·UCI 가 아예 없다(원본 XML 에 필드 부재). keyword= 로 검색은 되지만 결과에는 실리지 않는 비대칭이므로, 결과의 빈 keywords 를 '키워드 없는 논문'으로 오독하면 안 된다. 키워드·ISSN 이 필요하면 kci_detail 로 건별 보강할 것. 인증키가 없으면 kci_harvest(OAI 무인증) 사용을 안내한다.

[REST] Control Number(ART…)로 논문 상세 조회. 인증키 필요.

저자 키워드·ISSN·등재여부·FWCI·저자 소속·참고문헌의 유일한 출처다 (articleSearch 응답에는 이 필드들이 없다). 검색 결과의 키워드 결측은 이 도구로 보강한다.

[REST] 제목 검색어에 매칭된 논문들의 참고문헌 원형 수집. 인증키 필요.

반환 레코드의 article_id 는 인용하는 쪽(참고문헌을 단 논문)이다. institution: 발행기관명 필터. sort_by: title|author|pubiYr, sort_dir: asc|desc.

⚠️ referenceSearch 에는 page 파라미터가 없어 1회 100건이 API 상한이다. total>100 이면 나머지는 이어 받을 수 없으므로 truncated 를 반드시 확인할 것. 상한을 넘겼다면 sort_dir 를 뒤집어 반대쪽 100건을 추가로 받아 합집합을 취하는 것이 유일한 우회책이다.

[REST] 저널 인용지수 — year(+years 2~5)로 목록 / journal_id 로 상세(등재이력·연도별 IF). 인증키 필요.

[OAI-PMH·무인증] 세트+날짜범위 대량 수확. 인증키 불필요.

set_spec: ARTI(논문)/ARTI_CONF(학술대회)/JOUR(학술지) date_from/date_until: YYYY-MM-DD. metadata_prefix: oai_kci(상세)/oai_dc(간략). contains: 제목/초록/키워드 등에 이 문자열(들) 포함분만(키워드 검색 대용 로컬 필터).

[혼용] 요청 성격·키 유무로 REST↔OAI 자동 선택 후 수집 → 파일 저장.

• terms/title 있고 인증키 보유 → REST 변형어 합집합 검색(year_from/to·contains 적용)

retry_incomplete: 다중 페이지 질의는 호출마다 결과가 흔들려 1~2건이 빠질 수 있다. 기본 1 이면 total 에 못 미쳤을 때 검색축마다 한 번 더 훑어 합집합을 취한다(meta.sweeps_total 로 확인). ⚠️ 보정이 걸린 축은 전체를 재페이징하므로 요청 수가 그 축만큼 늘어난다. 대규모 수집에서 비용이 부담되면 0 으로 끈다 — 대신 결손이 남고 meta.total_mismatch 로만 표시된다.

• terms/title 있고 키 없음 → OAI 수확(date_from/until) + terms/contains 로컬 필터

• terms/title 없음 → OAI 세트/날짜범위 전수 수확 out_dir 미지정 시 홈의 kci-output/. OAI 날짜는 YYYY-MM-DD, REST 연도는 정수.

⚠️ REST 경로는 각 검색어를 제목축·키워드축 두 번 조회해 합집합한다 → 결과는 '제목검색 결과'가 아니라 제목∪키워드다. 반환값 meta.axes 에 축별 total 이 담긴다. ⚠️ truncated=true 면 max_records 상한에 잘린 것이다 — 그대로 분석에 쓰면 안 된다. meta.union_upper_bound 위로 max_records 를 올려 재수집할 것.