nomadamas__k-skill/docs/features/keris-academic-search.md

KERIS/RISS 학술자료 검색

keris-academic-search는 RISS 검색 Open API(https://www.riss.kr/openApi)의 XML 메타데이터를 조회하는 stdlib Python helper다. RISS 검색 API는 기관/대학 전용 인증키를 요구하므로 이 스킬은 k-skill-proxy를 사용하지 않고 사용자 본인의 RISS 키로 상류를 직접 호출한다.

npx -y @nomadamas/k-skill@0 exec keris-academic-search scripts/keris_academic.py -- search --keyword '인공지능 교육'
npx -y @nomadamas/k-skill@0 exec keris-academic-search scripts/keris_academic.py -- search --title '대학도서관' --resource-type B --json

keyword, title, author, subject, publisher 중 하나 이상과 resourceType=ALL|T|A|D|B, page, pageSize(1~100)를 받는다. ALL은 공식 T/A/O/U/F/S, A는 A/O, D는 국내 학술논문 A, B는 단행본 U로 매핑한다. 여러 type을 합치는 ALL/A는 첫 페이지 결과를 round-robin으로 합치며 upstream을 type 수만큼 호출한다. 후속 페이지는 단일 type을 선택해야 한다.

RISS API 키 발급

RISS 검색 Open API 키는 공익 목적의 비영리 기관/대학에만 무료로 발급된다(향후 민간 확대 예정). DATA_GO_KR_API_KEY와는 완전히 별개의 키다.

1. RISS(https://www.riss.kr)에 기관 소속으로 회원가입/로그인
2. RISS API 센터(https://www.riss.kr/apicenter/apiMain.do) → RISS 검색 API → 이용신청(https://riss.kr/openAPI/OpenApiRegisterFinal.do)
3. KERIS 담당자 심사·승인 후 인증키(key) 발급
4. 발급받은 키를 KSKILL_RISS_API_KEY(호환 RISS_API_KEY) 환경변수 또는 ~/.config/k-skill/secrets.env에 설정

키가 없으면 스킬은 실행을 중단하고 발급 안내를 출력한다. --dry-run은 키 없이도 호출 URL을 확인할 수 있으며 키를 REDACTED로 표시한다.

결과는 제목, 저자, 발행처/학술지, 발행연도, RISS 링크, 원문 유무와 무료/유료·기관권한 가능 표시를 요약한다. RISS 링크의 실제 원문 접근은 기관 구독과 자료별 권한에 따라 달라지며 다운로드·로그인·결제는 자동화하지 않는다.

공공데이터포털 15071949는 관련 정적 종합목록/카탈로그 데이터이며 논문 검색 fallback이 아니다. 빈 결과는 정상 빈 목록, 키 오류·쿼터·상류 장애·XML 파싱 오류는 각각 typed failure로 반환한다.